advanced_dropdown 2.0.1
advanced_dropdown: ^2.0.1 copied to clipboard
A customizable Flutter dropdown with search, single-select, and multi-select support.
πΈ Screenshots #
Custom Decoration | Single Select | Single Select with Search | Multi Select | Multi Select with Search |
---|---|---|---|---|
[Custom Decoration] | [Single Select] | [Single Select with Search] | [Multi Select] | [Multi Select with Search] |
π§© Custom Dropdown for Flutter #
A fully customizable dropdown widget for Flutter that supports single-select, multi-select, and search β all in one widget.
Lightweight, flexible, and easy to integrate into any Flutter project.
π± Platform Support #
Platform | Supported | Tested |
---|---|---|
Android | β | β |
iOS | β | β |
Web | β | β |
Windows | β | βοΈ |
macOS | β | βοΈ |
Linux | β | βοΈ |
π‘ Works with Flutter 3.0+ and Dart 3.0+
β¨ Features #
β
Single Select (default) β behaves like a normal dropdown
β
Multi Select β users can select multiple items
β
Searchable Dropdown β optional search bar for filtering
β
Flexible Decoration β customize dropdown and list appearance
β
Custom InputDecoration for search bar
β
Auto position below the button
β
Lightweight (~3 KB compressed)
β
No external dependencies
β
Custom Dropdown Button Design
β
Custom Dropdown Icon
βοΈ Customization Options #
Below is a complete list of customizable properties available in the AdvancedDropdown
widget.
Property | Type | Required | Default | Description |
---|---|---|---|---|
items | List<String> |
β Yes | β | The list of items to display in the dropdown. |
onChanged | Function(dynamic) |
β Yes | β | Callback triggered when an item is selected. Returns a value (single select) or list (multi select). |
isSearch | bool |
β No | false |
Enables a search bar for filtering dropdown items. |
isMultiSelect | bool |
β No | false |
Enables multiple selection with checkboxes and removable chips. |
decoration | BoxDecoration? |
β No | null |
Customizes the main dropdown button (border, color, shape, etc.). |
dropdownDecoration | BoxDecoration? |
β No | null |
Styles the dropdown popup list container. |
inputDecoration | InputDecoration? |
β No | null |
Customizes the search fieldβs look and behavior. |
icon | Icon? |
β No | Icon(Icons.arrow_drop_down) |
The dropdown icon displayed beside the button. |
maxSelection | int? |
β No | null |
Limits the number of selections in multi-select mode. Shows a SnackBar when exceeded. |
chipColor | Color |
β No | Color(0xFFD0E6FF) |
Background color of selected chips (multi-select). |
chipTextColor | Color |
β No | Colors.black |
Text color inside chips. |
chipRemoveIconColor | Color |
β No | Colors.black54 |
Color of the remove (Γ) icon in chips. |
key | Key? |
β No | null |
Widget key used for testing or identification. |
π‘ Notes #
- Default mode = Single Select
- When
isMultiSelect: true
, theonChanged
callback returns a List of selected items. - Dropdown automatically opens below the button.
- You can style everything (dropdown, button, list, search bar).
- Works seamlessly with light and dark themes.