Skip to content

Commit 5481957

Browse files
authored
Merge pull request #3858 from syncfusion-content/Tools_AutomationID
UG preparation for Automation ID support for drawing elements
2 parents 787e1f6 + 1ee848d commit 5481957

File tree

8 files changed

+46
-2
lines changed

8 files changed

+46
-2
lines changed

MAUI/Autocomplete/Basic-Features.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,3 +41,13 @@ The following image illustrates the output:
4141
## Text
4242

4343
The [Text](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Inputs.DropDownControls.DropDownListBase.html#Syncfusion_Maui_Inputs_DropDownControls_DropDownListBase_Text) property is used to get the user-submitted text in the [SfAutocomplete](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Inputs.SfAutocomplete.html). The default value of the `Text` property is `string.Empty`.
44+
45+
## Automation ID
46+
47+
The [SfAutocomplete](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Inputs.SfAutocomplete.html) control provides `AutomationId` support specifically for the `editable entry` and the `clear button`, enabling UI automation frameworks to reliably target these two elements. Each element’s AutomationId is derived from the control’s `AutomationId` to ensure uniqueness.
48+
49+
For example, if the SfAutocomplete’s `AutomationId` is set to “Employee Autocomplete,” the editable entry can be targeted as “Employee Autocomplete Entry” and the clear button as “Employee Autocomplete Clear Button.” This focused support improves accessibility and automated UI testing by providing stable, predictable identifiers for the primary interactive elements
50+
51+
The following screenshot illustrates the AutomationIds of inner elements.
52+
53+
![.NET MAUI Autocomplete AutomationId Image demonstration](Images/GettingStarted/AutoComplete_AutomationID.png)
21.7 KB
Loading
41.2 KB
Loading

MAUI/ComboBox/UI-Customization.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1749,3 +1749,13 @@ public SocialMediaViewModel
17491749

17501750
{% endhighlight %}
17511751
{% endtabs %}
1752+
1753+
## Automation ID
1754+
1755+
Support for `AutomationId` has been added to the [SfComboBox](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Inputs.SfComboBox.html) control, allowing UI automation frameworks to reliably target the `editable entry`, `the clear button`, and `the dropdown button`. Each element’s AutomationId is derived from the control’s AutomationId to ensure uniqueness across your application.
1756+
1757+
For example, if the SfComboBox’s `AutomationId` is set to “Employee ComboBox,” the editable entry can be targeted as “Employee ComboBox Entry,” the clear button as “Employee ComboBox Clear Button,” and the dropdown button as “Employee ComboBox Dropdown Button.” This focused support provides stable, predictable identifiers for the primary interactive elements, improving accessibility and automated UI testing
1758+
1759+
The following screenshot illustrates the AutomationIds of inner elements.
1760+
1761+
![.NET MAUI ComboBox AutomationId Image demonstration](Images/UICustomization/ComboBox_AutomationID.png)

MAUI/Masked-Entry/Basic-Features.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -485,4 +485,16 @@ public class CommandDemoViewModel
485485
}
486486

487487
{% endhighlight %}
488-
{% endtabs %}
488+
{% endtabs %}
489+
490+
## Automation ID
491+
492+
Support for `AutomationId` has been added to the [SfMaskedEntry](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Inputs.SfMaskedEntry.html) control, enabling UI automation frameworks to reliably target the `editable entry` and the `clear button`.
493+
494+
Each element’s `AutomationId` is derived from the control’s AutomationId to ensure uniqueness. For example, if the SfMaskedEntry’s AutomationId is set to “Employee Masked Entry,” the editable entry can be targeted as “Employee Masked Entry Entry” and the clear button as “Employee Masked Entry Clear Button.”
495+
496+
This focused support provides stable, predictable identifiers for the primary interactive elements, improving accessibility and automated UI testing.
497+
498+
The following screenshot illustrates the AutomationIds of inner elements.
499+
500+
![.NET MAUI MaskedEntry AutomationId Image demonstration](MaskedEntry_Images/MakedEntry_AutomationID.png)
21.7 KB
Loading

MAUI/NumericEntry/Basic-Features.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -419,4 +419,16 @@ public class CommandDemoViewModel
419419
}
420420

421421
{% endhighlight %}
422-
{% endtabs %}
422+
{% endtabs %}
423+
424+
## Automation ID
425+
426+
Support for `AutomationId` has been added to the [SfNumericEntry](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Inputs.SfNumericEntry.html) control, enabling UI automation frameworks to reliably target the `editable entry` and the `clear button`. Each element’s AutomationId is derived from the control’s AutomationId to ensure uniqueness.
427+
428+
For example, if the SfNumericEntry’s `AutomationId` is set to “Employee Numeric Entry,” the editable entry can be targeted as “Employee Numeric Entry Entry” and the clear button as “Employee Numeric Entry Clear Button.”
429+
430+
This focused support provides stable, predictable identifiers for the primary interactive elements, improving accessibility and automated UI testing.
431+
432+
The following screenshot illustrates the AutomationIds of inner elements.
433+
434+
![.NET MAUI NumeriEntry AutomationId Image demonstration](GettingStarted_images/NumericEntry_AutomationID.png)
19 KB
Loading

0 commit comments

Comments
 (0)