Implementing .NET MAUI ComboBox
The Syncfusion .NET MAUI ComboBox (SfComboBox) is a powerful selection control that allows users to type a value or choose an option from a list of predefined options. It combines the functionality of a dropdown list with an editable text box, supporting data binding, filtering, searching, single/multiple selection, and extensive customization options.
When to Use This Skill
Use this skill when the user needs to:
- Implement dropdown selection controls with editable or non-editable text input
- Enable searchable dropdowns with filtering and auto-complete functionality
- Support multiple selection modes with token or delimiter display
- Bind data from collections to dropdown lists with custom display formatting
- Apply custom filtering logic including AI-powered smart search
- Customize dropdown UI with headers, footers, item templates, and styling
- Highlight matched text during search operations
- Implement load-more functionality for large datasets
- Create accessible selection controls with proper automation support
Component Overview
Key Capabilities:
- Editable & Non-Editable Modes: Toggle between allowing free text input or dropdown-only selection
- Single & Multiple Selection: Support for single item or multi-item selection with token/delimiter display
- Filtering & Searching: Built-in text filtering with StartsWith/Contains modes and custom filter logic
- Data Binding: Bind to any IEnumerable source with DisplayMemberPath and TextMemberPath
- UI Customization: Extensive styling options for dropdown, items, tokens, headers, footers
- Smart Features: AI-powered search, text highlighting, load-more, auto-sizing
- Events & Methods: Rich event model for selection changes, dropdown state, and user interactions
Documentation and Navigation Guide
Getting Started
📄 Read: references/getting-started.md
- Installation and NuGet package setup (Syncfusion.Maui.Inputs)
- Registering Syncfusion Core handler (ConfigureSyncfusionCore)
- Basic ComboBox implementation in XAML and C#
- Data binding with ItemsSource, DisplayMemberPath, TextMemberPath
- Minimal working example
Editing Modes
📄 Read: references/editing-modes.md
- IsEditable property for editable/non-editable modes
- IsClearButtonVisible for clear button control
- Text property for getting/setting input text
- CursorPosition management
Selection
📄 Read: references/selection.md
- Single selection (SelectedItem, SelectedIndex)
- Multiple selection (SelectionMode, SelectedItems)
- Multi-selection display modes (Token, Delimiter)
- TokensWrapMode (Wrap, None)
- SelectedValue and SelectedValuePath
- SelectionChanging and SelectionChanged events
- Programmatic selection and Clear method
Filtering
📄 Read: references/filtering.md
- Enable filtering with IsFilteringEnabled
- Filter modes (StartsWith, Contains)
- Custom filtering with IComboBoxFilterBehavior
- Implementing GetMatchingIndexes for custom filter logic
- MinimumPrefixCharacters constraint
Searching
📄 Read: references/searching.md
- TextSearchMode configuration (StartsWith, Contains)
- Search based on DisplayMemberPath and TextMemberPath
- Edit mode searching behavior
- Prefix characters constraint (MinimumPrefixCharacters)
UI Customization
📄 Read: references/ui-customization.md
- Placeholder and colors
- Clear button and dropdown icon customization
- Border styling (Stroke, ShowBorder)
- MaxDropDownHeight configuration
- ItemTemplate and DataTemplateSelector for custom item rendering
- Dropdown styling (Background, Stroke, StrokeThickness, CornerRadius, Shadow)
- Dropdown item styling (Font, Color, Height, Padding)
- DropDownPlacement (Top, Bottom, Auto, None)
- DropDownButtonSettings customization
- Token item styling
- Text alignment and cursor position
- ReturnType for keyboard behavior
- ShowSuggestionsOnFocus
- AutomationId support for UI testing
Header and Footer
📄 Read: references/header-footer.md
- Adding header view with ShowDropDownHeaderView
- Adding footer view with ShowDropDownFooterView
- Custom templates for headers and footers
- Height configuration
Text Highlighting
📄 Read: references/highlighting-text.md
- TextHighlightMode (FirstOccurrence, MultipleOccurrence)
- Customizing highlight color and font attributes
- Highlighting in StartsWith and Contains modes
Advanced Features
📄 Read: references/advanced-features.md
- AutoSizing with EnableAutoSize
- NoResultsFoundText and NoResultsFoundTemplate
- Load-more functionality (MaximumSuggestion, LoadMoreText, LoadMoreTemplate)
- IsDropDownOpen for programmatic control
- ReturnCommand and ReturnCommandParameter
- Liquid Glass Effect (EnableLiquidGlassEffect)
Events and Methods
📄 Read: references/events-and-methods.md
- SelectionChanging event (with Cancel option)
- SelectionChanged event (AddedItems, RemovedItems)
- ValueChanged event (OldValue, NewValue)
- Completed event
- DropDownOpening, DropDownOpened, DropDownClosed events
- ClearButtonClicked event
- LoadMoreButtonTapped event
- Clear() method
AI-Powered Smart Searching
📄 Read: references/ai-smart-searching.md
- Integrating Azure OpenAI for intelligent search
- Implementing IComboBoxFilterBehavior for AI filtering
- Prompt engineering for accurate results
- Async filtering with CancellationToken
- Fallback mechanisms (Soundex, Levenshtein algorithms)
1---
2name: syncfusion-maui-combobox
3description: Implements Syncfusion .NET MAUI ComboBox (SfComboBox) control. Use when working with ComboBox, dropdown selection, editable dropdown, searchable dropdown, or filterable dropdown in .NET MAUI. Covers basic ComboBox setup, editable/non-editable modes, single/multiple selection, filtering and searching, custom UI styling, and AI-powered smart search.
4metadata:
5 author: "Syncfusion Inc"
6 version: "34.1.29"
7---
8
9# Implementing .NET MAUI ComboBox
10
11The Syncfusion .NET MAUI ComboBox (SfComboBox) is a powerful selection control that allows users to type a value or choose an option from a list of predefined options. It combines the functionality of a dropdown list with an editable text box, supporting data binding, filtering, searching, single/multiple selection, and extensive customization options.
12
13## When to Use This Skill
14
15Use this skill when the user needs to:
16
17- **Implement dropdown selection controls** with editable or non-editable text input
18- **Enable searchable dropdowns** with filtering and auto-complete functionality
19- **Support multiple selection modes** with token or delimiter display
20- **Bind data from collections** to dropdown lists with custom display formatting
21- **Apply custom filtering logic** including AI-powered smart search
22- **Customize dropdown UI** with headers, footers, item templates, and styling
23- **Highlight matched text** during search operations
24- **Implement load-more functionality** for large datasets
25- **Create accessible selection controls** with proper automation support
26
27## Component Overview
28
29**Key Capabilities:**
30- **Editable & Non-Editable Modes:** Toggle between allowing free text input or dropdown-only selection
31- **Single & Multiple Selection:** Support for single item or multi-item selection with token/delimiter display
32- **Filtering & Searching:** Built-in text filtering with StartsWith/Contains modes and custom filter logic
33- **Data Binding:** Bind to any IEnumerable source with DisplayMemberPath and TextMemberPath
34- **UI Customization:** Extensive styling options for dropdown, items, tokens, headers, footers
35- **Smart Features:** AI-powered search, text highlighting, load-more, auto-sizing
36- **Events & Methods:** Rich event model for selection changes, dropdown state, and user interactions
37
38## Documentation and Navigation Guide
39
40### Getting Started
41📄 **Read:** [references/getting-started.md](references/getting-started.md)
42- Installation and NuGet package setup (Syncfusion.Maui.Inputs)
43- Registering Syncfusion Core handler (ConfigureSyncfusionCore)
44- Basic ComboBox implementation in XAML and C#
45- Data binding with ItemsSource, DisplayMemberPath, TextMemberPath
46- Minimal working example
47
48### Editing Modes
49📄 **Read:** [references/editing-modes.md](references/editing-modes.md)
50- IsEditable property for editable/non-editable modes
51- IsClearButtonVisible for clear button control
52- Text property for getting/setting input text
53- CursorPosition management
54
55### Selection
56📄 **Read:** [references/selection.md](references/selection.md)
57- Single selection (SelectedItem, SelectedIndex)
58- Multiple selection (SelectionMode, SelectedItems)
59- Multi-selection display modes (Token, Delimiter)
60- TokensWrapMode (Wrap, None)
61- SelectedValue and SelectedValuePath
62- SelectionChanging and SelectionChanged events
63- Programmatic selection and Clear method
64
65### Filtering
66📄 **Read:** [references/filtering.md](references/filtering.md)
67- Enable filtering with IsFilteringEnabled
68- Filter modes (StartsWith, Contains)
69- Custom filtering with IComboBoxFilterBehavior
70- Implementing GetMatchingIndexes for custom filter logic
71- MinimumPrefixCharacters constraint
72
73### Searching
74📄 **Read:** [references/searching.md](references/searching.md)
75- TextSearchMode configuration (StartsWith, Contains)
76- Search based on DisplayMemberPath and TextMemberPath
77- Edit mode searching behavior
78- Prefix characters constraint (MinimumPrefixCharacters)
79
80### UI Customization
81📄 **Read:** [references/ui-customization.md](references/ui-customization.md)
82- Placeholder and colors
83- Clear button and dropdown icon customization
84- Border styling (Stroke, ShowBorder)
85- MaxDropDownHeight configuration
86- ItemTemplate and DataTemplateSelector for custom item rendering
87- Dropdown styling (Background, Stroke, StrokeThickness, CornerRadius, Shadow)
88- Dropdown item styling (Font, Color, Height, Padding)
89- DropDownPlacement (Top, Bottom, Auto, None)
90- DropDownButtonSettings customization
91- Token item styling
92- Text alignment and cursor position
93- ReturnType for keyboard behavior
94- ShowSuggestionsOnFocus
95- AutomationId support for UI testing
96
97### Header and Footer
98📄 **Read:** [references/header-footer.md](references/header-footer.md)
99- Adding header view with ShowDropDownHeaderView
100- Adding footer view with ShowDropDownFooterView
101- Custom templates for headers and footers
102- Height configuration
103
104### Text Highlighting
105📄 **Read:** [references/highlighting-text.md](references/highlighting-text.md)
106- TextHighlightMode (FirstOccurrence, MultipleOccurrence)
107- Customizing highlight color and font attributes
108- Highlighting in StartsWith and Contains modes
109
110### Advanced Features
111📄 **Read:** [references/advanced-features.md](references/advanced-features.md)
112- AutoSizing with EnableAutoSize
113- NoResultsFoundText and NoResultsFoundTemplate
114- Load-more functionality (MaximumSuggestion, LoadMoreText, LoadMoreTemplate)
115- IsDropDownOpen for programmatic control
116- ReturnCommand and ReturnCommandParameter
117- Liquid Glass Effect (EnableLiquidGlassEffect)
118
119### Events and Methods
120📄 **Read:** [references/events-and-methods.md](references/events-and-methods.md)
121- SelectionChanging event (with Cancel option)
122- SelectionChanged event (AddedItems, RemovedItems)
123- ValueChanged event (OldValue, NewValue)
124- Completed event
125- DropDownOpening, DropDownOpened, DropDownClosed events
126- ClearButtonClicked event
127- LoadMoreButtonTapped event
128- Clear() method
129
130### AI-Powered Smart Searching
131📄 **Read:** [references/ai-smart-searching.md](references/ai-smart-searching.md)
132- Integrating Azure OpenAI for intelligent search
133- Implementing IComboBoxFilterBehavior for AI filtering
134- Prompt engineering for accurate results
135- Async filtering with CancellationToken
136- Fallback mechanisms (Soundex, Levenshtein algorithms)
137
gabrielmoreira