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, theonChangedcallback 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.