$npx -y skills add syncfusion/maui-ui-components-skills --skill syncfusion-maui-autocompleteImplements and configure Syncfusion .NET MAUI Autocomplete (SfAutocomplete) control for intelligent text input with suggestions. Use when implementing autocomplete, autosuggest, type-ahead search, smart search, or filtered dropdowns in .NET MAUI applications. Covers data binding,
| 1 | # Implementing .NET MAUI Autocomplete |
| 2 | |
| 3 | The Syncfusion .NET MAUI Autocomplete (SfAutocomplete) is a powerful text input control that provides intelligent suggestions as users type, enabling fast data entry and enhanced search experiences with filtering, multi-selection, and customizable UI. |
| 4 | |
| 5 | ## When to Use This Skill |
| 6 | |
| 7 | Use this skill when the user needs to: |
| 8 | - **Search-as-you-type interfaces** - Filter and display suggestions while users type |
| 9 | - **Smart data entry forms** - Autocomplete user input from predefined lists |
| 10 | - **Multi-selection input** - Select multiple items with token/chip display |
| 11 | - **Filtered dropdowns** - Search and filter large datasets efficiently |
| 12 | - **AI-powered search** - Implement intelligent search with Azure OpenAI integration |
| 13 | - **Type-ahead functionality** - Provide predictive text suggestions |
| 14 | - **Searchable combobox alternatives** - Enhanced dropdown with search capabilities |
| 15 | - **Tag input controls** - Multi-selection with visual tokens |
| 16 | |
| 17 | ## Component Overview |
| 18 | |
| 19 | The SfAutocomplete control offers: |
| 20 | |
| 21 | - **Intelligent Filtering** - StartsWith and Contains search modes with custom filters |
| 22 | - **Flexible Selection** - Single or multiple selection with token/delimiter display |
| 23 | - **Data Binding** - Bind to any data source with DisplayMemberPath and TextMemberPath |
| 24 | - **Custom Search Logic** - Implement IAutocompleteFilterBehavior for advanced filtering |
| 25 | - **AI Integration** - Azure OpenAI support for smart, context-aware searching |
| 26 | - **Rich Customization** - Templates, styling, headers, footers, and highlighting |
| 27 | - **Performance** - Async loading, pagination with LoadMore, and efficient rendering |
| 28 | - **Accessibility** - AutomationId support, keyboard navigation, screen reader friendly |
| 29 | |
| 30 | ## Documentation and Navigation Guide |
| 31 | |
| 32 | ### Getting Started |
| 33 | 📄 **Read:** [references/getting-started.md](references/getting-started.md) |
| 34 | |
| 35 | When implementing basic autocomplete functionality: |
| 36 | - Installation and NuGet package setup (Syncfusion.Maui.Inputs) |
| 37 | - Handler registration with ConfigureSyncfusionCore |
| 38 | - Basic control implementation in XAML and C# |
| 39 | - Data binding with ItemsSource, DisplayMemberPath, TextMemberPath |
| 40 | - Placeholder configuration and basic properties |
| 41 | - AutomationId for UI testing |
| 42 | |
| 43 | ### Searching and Filtering |
| 44 | 📄 **Read:** [references/searching-filtering.md](references/searching-filtering.md) |
| 45 | |
| 46 | When implementing search and filter logic: |
| 47 | - Search based on DisplayMemberPath and TextMemberPath |
| 48 | - TextSearchMode (StartsWith, Contains) configuration |
| 49 | - MinimumPrefixCharacters for search delay |
| 50 | - Custom filtering with IAutocompleteFilterBehavior |
| 51 | - Custom search highlighting with IAutocompleteSearchBehavior |
| 52 | - Async item loading with cancellation support |
| 53 | - ShowSuggestionsOnFocus behavior |
| 54 | |
| 55 | ### Selection |
| 56 | 📄 **Read:** [references/selection.md](references/selection.md) |
| 57 | |
| 58 | When handling item selection: |
| 59 | - Single vs Multiple selection modes |
| 60 | - SelectedItem, SelectedItems properties |
| 61 | - SelectedValue and SelectedValuePath |
| 62 | - MultiSelectionDisplayMode (Token, Delimiter) |
| 63 | - TokensWrapMode (Wrap, None) for token layout |
| 64 | - SelectionChanging and SelectionChanged events |
| 65 | - Clear button configuration |
| 66 | - Clear() method for programmatic clearing |
| 67 | |
| 68 | ### UI Customization |
| 69 | 📄 **Read:** [references/ui-customization.md](references/ui-customization.md) |
| 70 | |
| 71 | When customizing appearance and behavior: |
| 72 | - Placeholder styling (text, color) |
| 73 | - Clear button customization (icon, color, path) |
| 74 | - Dropdown styling (height, width, placement, background) |
| 75 | - Item templates and text styling |
| 76 | - Token styling for multi-selection |
| 77 | - Border and stroke customization |
| 78 | - Text alignment and cursor position |
| 79 | - ReturnType and keyboard behavior |
| 80 | - Events (Completed, DropDownOpening, ValueChanged, etc.) |
| 81 | |
| 82 | ### Advanced Features |
| 83 | 📄 **Read:** [references/advanced-features.md](references/advanced-features.md) |
| 84 | |
| 85 | When implementing advanced functionality: |
| 86 | - Header and footer views in dropdown |
| 87 | - Text highlighting (FirstOccurrence, MultipleOccurrence) |
| 88 | - No results found customization |
| 89 | - AutoSizing for dynamic control height |
| 90 | - Liquid Glass Effect for modern UI (.NET 10+) |
| 91 | |
| 92 | ### AI-Powered Features & LoadMore |
| 93 | 📄 **Read:** [references/ai-powered-loadmore.md](references/ai-powered-loadmore.md) |
| 94 | |
| 95 | When implementing intelligent search or pagination: |
| 96 | - Azure OpenAI integration for smart search |
| 97 | - Custom filtering with AI service |
| 98 | - Prompt engineering for accurate results |
| 99 | - Offline fallback with Soundex/Levenshtein |
| 100 | - LoadMore feature with MaximumSuggestion |
| 101 | - LoadMore customization (text, template, events) |
| 102 | |
| 103 | ### Troubleshooting |
| 104 | 📄 **Read:* |