Skip to content

959295 - Review changes the first six Xamarin Tools Controls by AI #1109

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: development
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 13 additions & 5 deletions Xamarin/AutoComplete/Accessibility.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,12 +11,20 @@ documentation: ug

## AutomationId

The [`SfAutoComplete`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html) control has built-in `AutomationId` for inner elements. The `AutomationId` API allows the automation framework to find and interact with the inner elements of the SfAutoComplete control. To keep unique AutomationId, these inner elements' AutomationIds are updated based on the control's `AutomationId`.
The [`SfAutoComplete`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html) control provides built-in `AutomationId` support for its inner elements. This feature allows automation frameworks to find and interact with specific components within the control. To maintain uniqueness, the AutomationIds of inner elements are dynamically updated based on the control's own `AutomationId`.

For example, If you set SfAutoComplete's `AutomationId` as "Employee Autocomplete", then the Automation framework will interact with the Token Close Button as "Employee Autocomplete Frank Token Close Button".

The following screenshot illustrates the AutomationIds of inner elements. The Automation framework will interact with the dropdown for scrolling the items as "Employee Autocomplete Dropdown". You can also interact with the elements inside the HeaderView and FooterView with the element's AutomationId. The Automation framework will not interact with the Input Clear Button when the [`MultiSelectMode`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html#Syncfusion_SfAutoComplete_XForms_SfAutoComplete_MultiSelectMode) is [`None`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.MultiSelectMode.html#Syncfusion_SfAutoComplete_XForms_MultiSelectMode_None) and [`Delimiter`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.MultiSelectMode.html#Syncfusion_SfAutoComplete_XForms_MultiSelectMode_Delimiter) mode.
For example, if you set the SfAutoComplete's `AutomationId` as "Employee Autocomplete", the automation framework will interact with a token close button as "Employee Autocomplete Frank Token Close Button".

The following screenshot illustrates the AutomationIds of inner elements:
![AutomationId Image](images/AutomationId/AutomationId.png)

N> You can refer to our [Xamarin AutoComplete](https://www.syncfusion.com/xamarin-ui-controls/xamarin-autocomplete) feature tour page for its groundbreaking feature representations. You can also explore our [Xamarin.Forms AutoComplete example](https://github.com/syncfusion/xamarin-demos/tree/master/Forms/AutoComplete) to knows the functionalities of each feature.
The automation framework will interact with:
- The dropdown for scrolling items as "Employee Autocomplete Dropdown"
- Elements inside HeaderView and FooterView using their respective AutomationIds

**Note:** The automation framework will not interact with the Input Clear Button when the [`MultiSelectMode`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html#Syncfusion_SfAutoComplete_XForms_SfAutoComplete_MultiSelectMode) is set to either [`None`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.MultiSelectMode.html#Syncfusion_SfAutoComplete_XForms_MultiSelectMode_None) or [`Delimiter`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.MultiSelectMode.html#Syncfusion_SfAutoComplete_XForms_MultiSelectMode_Delimiter) mode.

## See Also

* [Xamarin AutoComplete Features Overview](https://www.syncfusion.com/xamarin-ui-controls/xamarin-autocomplete)
* [Xamarin.Forms AutoComplete Examples](https://github.com/syncfusion/xamarin-demos/tree/master/Forms/AutoComplete)
19 changes: 10 additions & 9 deletions Xamarin/AutoComplete/AutoComplete-Filtering-Options.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,12 +7,13 @@ control: AutoComplete
documentation: ug
---

# AutoComplete Filtering Options - Xamarin AutoComplete (SfAutoComplete)
# AutoComplete Filtering Options in Xamarin (SfAutoComplete)

## AutoComplete filtering options in Xamarin SfAutoComplete
## Overview

The phenomenon of string comparison for filtering suggestions can be changed using the [`SuggestionMode`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html#Syncfusion_SfAutoComplete_XForms_SfAutoComplete_SuggestionMode) property. The default filtering strategy is [`StartsWith`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SuggestionMode.html#Syncfusion_SfAutoComplete_XForms_SuggestionMode_StartsWith) and it is case insensitive. The available filtering modes are
The [`SfAutoComplete`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html) control provides various filtering options through the [`SuggestionMode`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html#Syncfusion_SfAutoComplete_XForms_SfAutoComplete_SuggestionMode) property. This property determines how strings are compared when filtering suggestions. The default filtering strategy is [`StartsWith`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SuggestionMode.html#Syncfusion_SfAutoComplete_XForms_SuggestionMode_StartsWith), which is case-insensitive.

The available filtering modes are:
* [`StartsWith`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SuggestionMode.html#Syncfusion_SfAutoComplete_XForms_SuggestionMode_StartsWith)

* [`StartsWithCaseSensitive`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SuggestionMode.html#Syncfusion_SfAutoComplete_XForms_SuggestionMode_StartsWithCaseSensitive)
Expand All @@ -31,7 +32,7 @@ The phenomenon of string comparison for filtering suggestions can be changed usi

* [`Custom`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SuggestionMode.html#Syncfusion_SfAutoComplete_XForms_SuggestionMode_Custom)

## Filtering Words that Starts with Input Text
## Filtering Words that Start with Input Text

Displays all the matches that starts with the typed characters in control. This strategy is case in-sensitive.

Expand Down Expand Up @@ -124,7 +125,7 @@ namespace AutocompleteSample

![Filtering options starts with](images/AutoComplete-Filtering-Options/starts-with.png)

### Filtering Words that Starts with Input Text - CaseSensitive
## Filtering Words that Start with Input Text - Case Sensitive

Displays all the matches that starts with the typed characters in control. This strategy is case sensitive.

Expand Down Expand Up @@ -217,7 +218,7 @@ namespace AutocompleteSample

![starts with case sensitive](images/AutoComplete-Filtering-Options/starts-with-case-sensitive.png)

## Filtering Words that Contains the Input Text
## Filtering Words that Contain the Input Text

Displays all the matches that contains the typed characters in control. This strategy is case in-sensitive.

Expand Down Expand Up @@ -310,7 +311,7 @@ namespace AutocompleteSample

![Filtering options contains](images/AutoComplete-Filtering-Options/contains.png)

### Filtering Words that Contains the Input Text - CaseSensitive
## Filtering Words that Contain the Input Text - Case Sensitive

Displays all the matches that contains the typed characters in control. This strategy is case sensitive.

Expand Down Expand Up @@ -403,7 +404,7 @@ namespace AutocompleteSample

![contains casesensitive](images/AutoComplete-Filtering-Options/contains-casesensitive.png)

## Filtering Words that Equals the Input Text
## Filtering Words that Equal the Input Text

Displays all the words that completely matches with the typed characters in control. This strategy is case in-sensitive.

Expand Down Expand Up @@ -494,7 +495,7 @@ namespace AutocompleteSample

{% endtabs %}

### Filtering Words that Equals the Input Text - CaseSensitive
## Filtering Words that Equal the Input Text - Case Sensitive

Displays all the words that completely matches with the typed characters in control. This strategy is case sensitive.

Expand Down
39 changes: 20 additions & 19 deletions Xamarin/AutoComplete/AutoComplete-Modes.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,22 +9,18 @@ documentation: ug

# AutoComplete Modes in Xamarin AutoComplete (SfAutoComplete)

## AutoComplete Modes in Xamarin SfAutoComplete
## Overview

AutoComplete provides three different ways to display the filtered suggestions. They are
The [`SfAutoComplete`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html) control provides three different ways to display filtered suggestions through the [`AutoCompleteMode`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html#Syncfusion_SfAutoComplete_XForms_SfAutoComplete_AutoCompleteMode) property:
* [`Suggest`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.AutoCompleteMode.html#Syncfusion_SfAutoComplete_XForms_AutoCompleteMode_Suggest) - Displays suggestions in a dropdown list
* [`Append`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.AutoCompleteMode.html#Syncfusion_SfAutoComplete_XForms_AutoCompleteMode_Append) - Appends the first suggestion to the text
* [`SuggestAppend`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.AutoCompleteMode.html#Syncfusion_SfAutoComplete_XForms_AutoCompleteMode_SuggestAppend) - Combines both Suggest and Append modes

* [`Suggest`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.AutoCompleteMode.html#Syncfusion_SfAutoComplete_XForms_AutoCompleteMode_Suggest) - displaying suggestion in drop down list
The default value is [`Suggest`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.AutoCompleteMode.html#Syncfusion_SfAutoComplete_XForms_AutoCompleteMode_Suggest).

* [`Append`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.AutoCompleteMode.html#Syncfusion_SfAutoComplete_XForms_AutoCompleteMode_Append) - appending the first suggestion to text

* [`SuggestAppend`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.AutoCompleteMode.html#Syncfusion_SfAutoComplete_XForms_AutoCompleteMode_SuggestAppend) - Both of these

[`AutoCompleteMode`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html#Syncfusion_SfAutoComplete_XForms_SfAutoComplete_AutoCompleteMode) property is used to choose the suggestion display mode in SfAutoComplete control. The default value is [`Suggest`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.AutoCompleteMode.html#Syncfusion_SfAutoComplete_XForms_AutoCompleteMode_Suggest).

## Suggesting Choices in List

The filtered suggestions are displayed in a drop down list. User can pick an item from the list.
## Suggest Mode

In Suggest mode, filtered suggestions are displayed in a dropdown list, allowing users to select an item from the list.
{% tabs %}

{% highlight xaml %}
Expand Down Expand Up @@ -118,9 +114,8 @@ namespace AutocompleteSample

![suggest](images/AutoComplete-Suggesting-Modes/suggest.png)

## Appending Suggestion to Text

The first item in filtered suggestions is appended to [`SfAutoComplete`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html) text. In this mode, drop down remains closed.
## Append Mode
In Append mode, the first item from the filtered suggestions is automatically appended to the text in the [`SfAutoComplete`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html) control. The dropdown list remains closed in this mode.

{% tabs %}

Expand Down Expand Up @@ -213,10 +208,13 @@ namespace AutocompleteSample

![Append](images/AutoComplete-Suggesting-Modes/append.png)

## Suggesting Choices and Appending Suggestions to Text
## SuggestAppend Mode

The text is appended to the first matched item in the suggestions collection and filtered suggestions are displayed in a drop down list. The user can pick from a list directly or use up and down keys for browsing the list.

In SuggestAppend mode, the control combines both Suggest and Append behaviors:
- The first matched item is appended to the text
- Filtered suggestions are displayed in a dropdown list

Users can either select an item directly from the list or use the up and down arrow keys to navigate through the suggestions.
{% tabs %}

{% highlight xaml %}
Expand Down Expand Up @@ -309,4 +307,7 @@ namespace AutocompleteSample

![suggest append](images/AutoComplete-Suggesting-Modes/suggest-append.png)

N> You can refer to our [Xamarin AutoComplete](https://www.syncfusion.com/xamarin-ui-controls/xamarin-autocomplete) feature tour page for its groundbreaking feature representations. You can also explore our [Xamarin.Forms AutoComplete example](https://github.com/syncfusion/xamarin-demos/tree/master/Forms/AutoComplete) to knows the functionalities of each feature.
## See Also

* [Xamarin AutoComplete Features Overview](https://www.syncfusion.com/xamarin-ui-controls/xamarin-autocomplete)
* [Xamarin.Forms AutoComplete Examples](https://github.com/syncfusion/xamarin-demos/tree/master/Forms/AutoComplete)
33 changes: 26 additions & 7 deletions Xamarin/AutoComplete/AutoSizing.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,33 @@
---
layout: post
title: AutoSizing in Syncfusion SfAutoComplete control in Xamarin.Forms
description: Learn how to enable the AutoSizing feature in SfAutoComplete control to extend the layout based on the input token size available.
platform: Xamarin
title: AutoSizing in Xamarin AutoComplete Control | Syncfusion
description: Learn how to enable the AutoSizing feature in Syncfusion Xamarin AutoComplete (SfAutoComplete) control to dynamically resize based on token content.
platform: xamarin
control: SfAutoComplete
documentation: ug
---

# Enabling the AutoSizing API
# AutoSizing in Xamarin AutoComplete (SfAutoComplete)

AutoSizing can be enabled in [`SfAutoComplete`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html) control so that the control will extend its layout based on the token size.
## Overview

[`EnableAutoSize`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html#Syncfusion_SfAutoComplete_XForms_SfAutoComplete_EnableAutoSize) property is used to enable the AutoSizing in [`SfAutoComplete`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html) control. To enable the API, you need to set the [`MultiSelectMode`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html#Syncfusion_SfAutoComplete_XForms_SfAutoComplete_MultiSelectMode) as [`Token`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.MultiSelectMode.html#Syncfusion_SfAutoComplete_XForms_MultiSelectMode_Token) and [`TokensWrapMode`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html#Syncfusion_SfAutoComplete_XForms_SfAutoComplete_TokensWrapMode) as [`Wrap`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.TokensWrapMode.html#Syncfusion_SfAutoComplete_XForms_TokensWrapMode_Wrap). The default value of [`EnableAutoSize`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html#Syncfusion_SfAutoComplete_XForms_SfAutoComplete_EnableAutoSize) is false.
The [`SfAutoComplete`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html) control provides an AutoSizing feature that allows the control to dynamically resize its layout based on the size of the selected tokens. This feature is particularly useful when working with multiple selections in token mode.
## Enabling AutoSizing

To enable AutoSizing in the [`SfAutoComplete`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html) control, set the [`EnableAutoSize`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html#Syncfusion_SfAutoComplete_XForms_SfAutoComplete_EnableAutoSize) property to `true`.

### Prerequisites

For AutoSizing to work properly, you must also configure the following properties:

1. Set [`MultiSelectMode`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html#Syncfusion_SfAutoComplete_XForms_SfAutoComplete_MultiSelectMode) to [`Token`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.MultiSelectMode.html#Syncfusion_SfAutoComplete_XForms_MultiSelectMode_Token)
2. Set [`TokensWrapMode`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html#Syncfusion_SfAutoComplete_XForms_SfAutoComplete_TokensWrapMode) to [`Wrap`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.TokensWrapMode.html#Syncfusion_SfAutoComplete_XForms_TokensWrapMode_Wrap)

The default value of [`EnableAutoSize`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html#Syncfusion_SfAutoComplete_XForms_SfAutoComplete_EnableAutoSize) is `false`.

## Example

The following example demonstrates how to enable AutoSizing in the [`SfAutoComplete`](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfAutoComplete.XForms.SfAutoComplete.html) control:
{% tabs %}
{% highlight xaml %}

Expand Down Expand Up @@ -91,4 +106,8 @@ namespace LayoutsExample

![EnableAutoSize image](images/AutoSizing/AutoSizing.png)

N> You can refer to our [Xamarin AutoComplete](https://www.syncfusion.com/xamarin-ui-controls/xamarin-autocomplete) feature tour page for its groundbreaking feature representations. You can also explore our [Xamarin.Forms AutoComplete example](https://github.com/syncfusion/xamarin-demos/tree/master/Forms/AutoComplete) to knows the functionalities of each feature.
## See Also

* [Xamarin AutoComplete Features Overview](https://www.syncfusion.com/xamarin-ui-controls/xamarin-autocomplete)
* [Xamarin.Forms AutoComplete Examples](https://github.com/syncfusion/xamarin-demos/tree/master/Forms/AutoComplete)
* [Working with Tokens in AutoComplete](https://help.syncfusion.com/xamarin/autocomplete/working-with-token)
Loading