搜索插件、代码仓与 APP 分类

GitHub 代码仓srtraj/dropdown_textfield

下拉文本字段

自定义下拉菜单

下拉文本字段 项目封面
星标
10
复刻
62
最近推送(UTC)
2026年6月29日
项目状态
未归档

原始 README

以下为英文项目原文快照,最新内容请访问 GitHub。

Flutter DropdownTextfield

A DropdownTextfield is a Material Design TextField. The DropDownButton is a widget that can be used to select one unique value or multiple values from a set of options.

Key Features

  1. Searchable dropdown
  2. Single & multi-selection
  3. Material dropdown
  4. Easily customizable UI
  5. Easy implementation into StatelessWidget
  6. ToolTip dialogue for multi-selection dropdown items

Examples

Single Dropdown Single Dropdown with Search Option Single Dropdown with Clear Option
Single Dropdown Single Dropdown with Search Option Single Dropdown with Clear Option
Multiple Dropdown Multiple Dropdown with All Selected Items
Multiple Dropdown Multiple Dropdown with All Selected Items

Usage

Controllers

You need to use SingleValueDropDownController for single dropdown and MultiValueDropDownController for multiple dropdown.

Properties
  • dropdownRadius: Defines the radius of the dropdown list. Default value is 12.
  • boxDecoration: Add custom BoxDecoration to decorate the dropdown container styling
  • boxMargin: Add custom margins to the dropdown container and override the default vertical: 5, horizontal: 4 margins
  • initialValue: Sets the initial value. If null or not in the dropDownList, it will not display any value.
  • dropDownList: A list of dropdown values of type <DropDownValueModel>.
  • onChanged: Listens for item selection changes. Returns a single DropDownValueModel object for single selection dropdown, and a list of DropDownValueModel objects for multi-selection dropdown.
  • textFieldDecoration: Overrides the default text field decoration.
  • dropDownIconProperty: Customizes the dropdown icon size and color.
  • isEnabled: Set to false to disable the text field. Default value is true.
  • enableSearch: Set to true to enable the search option in the dropdown. Currently available only for single selection dropdown.
  • displayCompleteItem: Set to true to display the complete list of selected items in the text field. Otherwise, it will display as "number_of_items selected".
  • dropDownItemCount: Maximum number of dropdown items to display. Default value is 6.
  • searchKeyboardType: Overrides the default search keyboard type. Applicable only if enableSearch=true.
  • searchTextStyle: Text style for the search text field.
  • searchAutofocus: Set to true to autofocus the search text field. Applicable only if enableSearch=true. Default value is false.
  • searchShowCursor: Set to false to hide the cursor from the search text field. Applicable only if enableSearch=true.
  • clearOption: Set to false to hide the clear suffix icon button from the text field.
  • clearIconProperty: Customizes the clear icon size and color.
  • listSpace: Space between the text field and the list. Default value is 0.
  • listPadding: Padding for dropdown list items.
  • submitButtonText: Text for the multi-dropdown submit button.
  • submitButtonColor: Color of the multi-dropdown submit button.
  • submitButtonTextStyle: Text style for the multi-dropdown submit button.
  • listTextStyle: Text style for dropdown list items.
  • checkBoxProperty: Customizes the properties of multiple checkboxes.

Contributing

Seeking contributions to improve the DropdownTextfield! If you have ideas for new features, optimizations, or bug fixes, please feel free to open a pull request or issue on our GitHub repository. Your contributions are greatly appreciated and will help make this package even better.

sharathraj A GitHub avatar
GitHub 作者

sharathraj A ↗

语言DartC++CMakeSwiftCHTMLKotlinObjective-C

此仓库发布的插件

使用的依赖

依赖清单 5 项

  • flutter{"sdk":"flutter"}
  • collection^1.18.0
  • equatable^2.0.5
  • flutter_test开发依赖{"sdk":"flutter"}
  • lints开发依赖^4.0.0

如何选择适合项目的代码仓?

先按使用场景筛选,再比较项目活跃情况,最后到原始仓库核对使用要求。

  1. 通过仓库名、作者或描述搜索,再按技术分类缩小范围。
  2. 结合星标、复刻与最近推送比较项目;星标反映社区关注,不代表质量保证。
  3. 使用前在 GitHub 核对 README、许可证与 Issues。

来源与维护

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗