Migrating from Xamarin SfAutoComplete to .NET MAUI SfAutocomplete

8 Jan 20241 minute to read

To migrate easier from Xamarin SfAutoComplete to .NET MAUI SfAutocomplete, we kept most of the APIs from Xamarin SfAutoComplete in MAUI SfAutocomplete. However, to maintain the consistency of API naming in MAUI SfAutocomplete, we renamed some of the APIs. The APIs changed in MAUI SfAutocomplete from Xamarin SfAutoComplete are detailed as follows:

Namespaces

Xamarin SfAutoComplete .NET MAUI SfAutocomplete
Syncfusion.SfAutoComplete.XForms Syncfusion.Maui.Inputs

Properties

Xamarin SfAutoComplete .NET MAUI SfAutocomplete Description

Watermark

Placeholder

 Gets or sets the place holder text.

WatermarkColor

PlaceholderColor

 Gets or sets the color of the place holder text.

ClearButtonColor

ClearButtonIconColor

 Gets or sets the color of the clear button.

ShowClearButton

IsClearButtonVisible

 Gets or sets whether to show the clear button.

MaximumDropDownHeight

MaxDropDownHeight

 Gets or sets the maximum dropdown height.

SuggestionMode


AutoCompleteMode

TextSearchMode

 Gets or sets the search mode of the control. The enum values are "StartsWith" and "Contains".
When using StartsWith, the AutoCompleteMode will be set to Append.
When using Contains, the AutoCompleteMode will be set to Suggest.

ItemsSource

,

DataSource

,

AutoCompleteSource

ItemsSource

 Gets or sets the data to be populated in the control.

Enums

Enum Xamarin SfAutoComplete .NET MAUI SfAutocomplete Description
Xamarin -

SuggestionMode


.NET MAUI -

TextSearchMode

StartsWith

,

StartsWithCaseSensitive

,

Contains

,

ContainsWithCaseSensitive

,

Equals

,

EqualsWithCaseSensitive

,

EndsWith

,

EndsWithCaseSensitive

,

Custom

StartsWith

,

Contains

.		 Gets or sets the search mode of the control.

Events

Event Name Xamarin SfAutoComplete .NET MAUI SfAutocomplete Description

SelectedChanged

SelectionChangedEventArgs

SelectionChangedEventArgs


 Raises when an item is selected in the dropdown or the SelectedItem is set programatically.Returns the previous selected item and the currently selected item

Upcoming features

  • Multiple Selection with Delimiter
  • Diacritic Sensitivity
  • Header and Footer
  • Highlighting Text
  • Load More Feature
  • Minimum Prefix Character
  • Customizations in Drop-Down