Add the accessible-placeholder-text property

api/cpp/include/slint-testing.h

@@ -51,8 +51,8 @@ class ElementHandle
              typename R = std::invoke_result_t<Visitor, ElementHandle>>
         requires((std::is_constructible_v<bool, R> && std::is_default_constructible_v<R>)
                  || std::is_void_v<R>)
-    static auto visit_elements(const ComponentHandle<T> &component,
-                               Visitor visitor) -> std::invoke_result_t<Visitor, ElementHandle>
+    static auto visit_elements(const ComponentHandle<T> &component, Visitor visitor)
+            -> std::invoke_result_t<Visitor, ElementHandle>
     {
         // using R = std::invoke_result_t<Visitor, ElementHandle>;
         auto vrc = component.into_dyn();
@@ -232,6 +232,13 @@ class ElementHandle
         return get_accessible_string_property(cbindgen_private::AccessibleStringProperty::Value);
     }
 
+    /// Returns the accessible-placeholder-text of that element, if any.
+    std::optional<SharedString> accessible_placeholder_text() const
+    {
+        return get_accessible_string_property(
+                cbindgen_private::AccessibleStringProperty::PlaceholderText);
+    }
+
     /// Returns the accessible-description of that element, if any.
     std::optional<SharedString> accessible_description() const
     {

docs/reference/src/language/builtins/elements.md

@@ -73,6 +73,7 @@ Use the following `accessible-` properties to make your items interact well with
 -   **`accessible-value-minimum`** (_in_ _float_): The minimum value of the item.
 -   **`accessible-value-step`** (_in_ _float_) The smallest increment or decrement by which the current value can change. This corresponds to the step by which a handle on a slider can be dragged.
 -   **`accessible-value`** (_in_ _string_): The current value of the item.
+-   **`accessible-placeholder-text`** (_in_ _string_): A placeholder text to use when the item's value is empty. Applies to text elements.
 
 You can also use the following callbacks that are going to be called by the accessibility framework:
 

examples/todo-mvc/ui/views/create_task_view.slint

@@ -58,7 +58,7 @@ export component CreateTaskView {
         VerticalLayout {
             spacing: SpaceSettings.default-spacing;
 
-            Text {
+            title-label := Text {
                 text: @tr("Task name");
                 color: TodoPalette.foreground;
                 font-size: FontSettings.body-strong.font-size;
@@ -69,6 +69,7 @@ export component CreateTaskView {
 
             title-input := LineEdit {
                 placeholder-text: @tr("Describe your task");
+                accessible-label: title-label.text;
             }
         }
 

internal/backends/testing/search_api.rs

@@ -352,6 +352,16 @@ impl ElementHandle {
             .and_then(|item| item.accessible_string_property(AccessibleStringProperty::Value))
     }
 
+    /// Returns the value of the element's `accessible-placeholder-text` property, if present.
+    pub fn accessible_placeholder_text(&self) -> Option<SharedString> {
+        if self.element_index != 0 {
+            return None;
+        }
+        self.item.upgrade().and_then(|item| {
+            item.accessible_string_property(AccessibleStringProperty::PlaceholderText)
+        })
+    }
+
     /// Sets the value of the element's `accessible-value` property. Note that you can only set this
     /// property if it is declared in your Slint code.
     pub fn set_accessible_value(&self, value: impl Into<SharedString>) {

internal/backends/winit/accesskit.rs

@@ -437,7 +437,16 @@ impl NodeCollection {
             builder.set_numeric_value_step(step);
         }
 
-        if let Some(value) = item.accessible_string_property(AccessibleStringProperty::Value) {
+        let value = item.accessible_string_property(AccessibleStringProperty::Value);
+        if value.is_none() || value.as_ref().is_some_and(|x| x.is_empty()) {
+            if let Some(placeholder) = item
+                .accessible_string_property(AccessibleStringProperty::PlaceholderText)
+                .filter(|x| !x.is_empty())
+            {
+                builder.set_placeholder(placeholder.to_string());
+            }
+        }
+        if let Some(value) = value {
             if let Ok(value) = value.parse() {
                 builder.set_numeric_value(value);
             } else {

internal/compiler/typeregister.rs

@@ -111,6 +111,7 @@ pub fn reserved_accessibility_properties() -> impl Iterator<Item = (&'static str
         ("accessible-value-maximum", Type::Float32),
         ("accessible-value-minimum", Type::Float32),
         ("accessible-value-step", Type::Float32),
+        ("accessible-placeholder-text", Type::String),
         ("accessible-action-default", Type::Callback { return_type: None, args: vec![] }),
         ("accessible-action-increment", Type::Callback { return_type: None, args: vec![] }),
         ("accessible-action-decrement", Type::Callback { return_type: None, args: vec![] }),

internal/compiler/widgets/cosmic-base/lineedit.slint

@@ -18,7 +18,7 @@ export component LineEdit {
     callback edited <=> base.edited;
     accessible-role: text-input;
     accessible-value <=> text;
-    accessible-label: placeholder-text;
+    accessible-placeholder-text: placeholder-text;
     accessible-action-set-value(v) => { text = v; edited(v); }
 
     public function set-selection-offsets(start: int, end: int) {

internal/compiler/widgets/cupertino-base/lineedit.slint

@@ -19,7 +19,7 @@ export component LineEdit {
     callback edited <=> i-base.edited;
     accessible-role: text-input;
     accessible-value <=> text;
-    accessible-label: placeholder-text;
+    accessible-placeholder-text: placeholder-text;
     accessible-action-set-value(v) => { text = v; edited(v); }
 
     public function set-selection-offsets(start: int, end: int) {

internal/compiler/widgets/fluent-base/lineedit.slint

@@ -18,7 +18,7 @@ export component LineEdit {
     callback edited <=> i-base.edited;
     accessible-role: text-input;
     accessible-value <=> text;
-    accessible-label: placeholder-text;
+    accessible-placeholder-text: placeholder-text;
     accessible-action-set-value(v) => { text = v; edited(v); }
 
     public function set-selection-offsets(start: int, end: int) {

internal/compiler/widgets/material-base/lineedit.slint

@@ -19,7 +19,7 @@ export component LineEdit {
     callback edited <=> i-base.edited;
     accessible-role: text-input;
     accessible-value <=> text;
-    accessible-label: placeholder-text;
+    accessible-placeholder-text: placeholder-text;
     accessible-action-set-value(v) => { text = v; edited(v); }
 
     public function set-selection-offsets(start: int, end: int) {

internal/core/accessibility.rs

@@ -20,6 +20,7 @@ pub enum AccessibleStringProperty {
     DelegateFocus,
     Description,
     Label,
+    PlaceholderText,
     Value,
     ValueMaximum,
     ValueMinimum,