StefK.MauiControlsExtras 1.0.0

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package StefK.MauiControlsExtras --version 1.0.0
                    


                    

                
NuGet\Install-Package StefK.MauiControlsExtras -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="StefK.MauiControlsExtras" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="StefK.MauiControlsExtras" Version="1.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="StefK.MauiControlsExtras" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add StefK.MauiControlsExtras --version 1.0.0
                    


                    

                
#r "nuget: StefK.MauiControlsExtras, 1.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package StefK.MauiControlsExtras@1.0.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=StefK.MauiControlsExtras&version=1.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=StefK.MauiControlsExtras&version=1.0.0
                    


                            Install as a Cake Tool

MAUI Controls Extras

A collection of enhanced UI controls for .NET MAUI applications that fill gaps in the standard control library.

NuGet License: MIT

Features

ComboBox Control

A feature-rich dropdown control similar to WinForms ComboBox, with modern mobile-friendly features:

  • Searchable/Filterable - Built-in search with debounced input
  • Complex Object Support - Use DisplayMemberPath and ValueMemberPath for data binding
  • Image/Icon Support - Display images alongside text via IconMemberPath
  • Two-Way Binding - Full support for SelectedItem and SelectedValue binding
  • Theme-Aware - Automatic light/dark mode styling
  • Customizable - Placeholder text, accent colors, visible item count
  • Clear Selection - Built-in clear button

Installation

NuGet Package Manager

Install-Package StefK.MauiControlsExtras

.NET CLI

dotnet add package StefK.MauiControlsExtras

Quick Start

1. Add the namespace

xmlns:extras="clr-namespace:MauiControlsExtras.Controls;assembly=MauiControlsExtras"

2. Basic Usage

<extras:ComboBox ItemsSource="{Binding Countries}"
                 SelectedItem="{Binding SelectedCountry, Mode=TwoWay}"
                 DisplayMemberPath="Name"
                 Placeholder="Select a country..." />

3. With Icons

<extras:ComboBox ItemsSource="{Binding Icons}"
                 SelectedItem="{Binding SelectedIcon, Mode=TwoWay}"
                 DisplayMemberPath="DisplayName"
                 IconMemberPath="ImagePath"
                 Placeholder="Select an icon..."
                 VisibleItemCount="6" />

API Reference

ComboBox Properties

Property Type Default Description
ItemsSource IEnumerable null The collection of items to display
SelectedItem object null The currently selected item (two-way)
SelectedValue object null The selected value based on ValueMemberPath (two-way)
DisplayMemberPath string null Property path for display text
ValueMemberPath string null Property path for the value
IconMemberPath string null Property path for item icons
Placeholder string "Select an item" Text shown when no selection
DefaultValue object null Value to select on initialization
VisibleItemCount int 5 Number of visible items in dropdown
AccentColor Color #0078D4 Color used for focus indication
HasSelection bool false Whether an item is selected (read-only)
IsExpanded bool false Whether dropdown is open (read-only)

ComboBox Events

Event Description
SelectionChanged Raised when the selected item changes
Opened Raised when the dropdown opens
Closed Raised when the dropdown closes

ComboBox Methods

Method Description
Open() Programmatically opens the dropdown
Close() Programmatically closes the dropdown
ClearSelection() Clears the current selection
RefreshItems() Refreshes the filtered items list

Examples

Activity Selection (Simple)

<extras:ComboBox ItemsSource="{Binding ActivityTypes}"
                 SelectedItem="{Binding SelectedActivity, Mode=TwoWay}"
                 DisplayMemberPath="Name"
                 Placeholder="Select an Activity"
                 VisibleItemCount="5" />

Icon Picker (With Images)

<extras:ComboBox ItemsSource="{Binding Icons}"
                 SelectedItem="{Binding SelectedIconOption, Mode=TwoWay}"
                 DisplayMemberPath="DisplayName"
                 IconMemberPath="IconImageSource"
                 Placeholder="Select an icon..."
                 VisibleItemCount="6" />

With Default Value

<extras:ComboBox ItemsSource="{Binding Priorities}"
                 SelectedItem="{Binding Priority, Mode=TwoWay}"
                 DisplayMemberPath="Name"
                 ValueMemberPath="Id"
                 DefaultValue="normal"
                 Placeholder="Select priority" />

Supported Platforms

  • Android 5.0+ (API 21)
  • iOS 15.0+
  • macOS Catalyst 15.0+
  • Windows 10.0.17763.0+

Requirements

  • .NET 10.0 or later
  • .NET MAUI

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Documentation

Full documentation is available at: https://stef-k.github.io/MauiControlsExtras/

Product Compatible and additional computed target framework versions.
.NET net10.0-android36.0 is compatible.  net10.0-ios26.0 is compatible.  net10.0-maccatalyst26.0 is compatible.  net10.0-windows10.0.19041 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0 90 1/23/2026