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

dropdown_plus 封面
插件详情v0.0.9

dropdown_plus

简单易用的下拉框,支持搜索、键盘导航、离线数据源、远程数据源以及轻松自定义。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
1460
喜欢数
138
Pub 分数
135

安装插件

flutter pub add dropdown_plus

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

Dropdown Plus 是一个功能强大的 Flutter 包,专为创建支持搜索、键盘导航以及离线和远程数据源的表单友好型下拉菜单而设计。它提供直观的界面和易于自定义的选项,非常适合需要动态且可访问的选择组件的应用程序。该包兼容所有主要平台,包括移动设备、网页和桌面端,确保行为一致。其轻量级设计和面向开发者的特性,简化了复杂下拉交互的实现,同时不牺牲性能或可用性。

适合场景

  • 带可搜索选项的表单输入
  • 从API动态加载数据
  • 键盘可访问的下拉菜单
  • 表单中的离线数据选择
  • 可自定义的下拉菜单样式
  • 跨平台表单组件

主要特点

  • 支持实时过滤的可搜索下拉菜单
  • 对远程和本地数据源的支持
  • 键盘导航(方向键、Enter 键)
  • 轻松的主题和样式自定义
  • 内置的加载和错误状态
  • 跨平台的响应式设计

适合对象

  • 开发表单密集型应用的开发者
  • 需要跨平台一致性的团队
  • 需要动态数据获取的应用程序
  • UI 设计师想要灵活的下拉菜单
  • 具有可访问性要求的项目
  • 交互式表单的快速原型设计

使用建议

  • 需要谨慎处理异步数据加载
  • 表单中可能需要额外的验证逻辑
  • 自定义样式可能需要深入理解 Flutter widget
  • 使用超大数据集时的性能影响
  • 内置错误处理功能有限,仅涵盖基本状态
  • 依赖外部依赖项进行远程数据解析

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

dropdown_plus

Simple and easy to use Dropdown in forms with search, keyboard navigation, offiline data source, remote data source and easy customization.

Getting Started

Simple Text Dropdown.

TextDropdownFormField(
    options: ["Male", "Female"],
    decoration: InputDecoration(
        border: OutlineInputBorder(),
        suffixIcon: Icon(Icons.arrow_drop_down),
        labelText: "Gender"),
    dropdownHeight: 120,
),

Install

packages.yaml
dropdown_plus: <lastest version>

Customizable Example


 final List<Map<String, dynamic>> _roles = [
    {"name": "Super Admin", "desc": "Having full access rights", "role": 1},
    {
      "name": "Admin",
      "desc": "Having full access rights of a Organization",
      "role": 2
    },
    {
      "name": "Manager",
      "desc": "Having Magenent access rights of a Organization",
      "role": 3
    },
    {
      "name": "Technician",
      "desc": "Having Technician Support access rights",
      "role": 4
    },
    {
      "name": "Customer Support",
      "desc": "Having Customer Support access rights",
      "role": 5
    },
    {"name": "User", "desc": "Having End User access rights", "role": 6},
  ];


// ...
// ...

DropdownFormField<Map<String, dynamic>>(
    onEmptyActionPressed: () async {},
    decoration: InputDecoration(
        border: OutlineInputBorder(),
        suffixIcon: Icon(Icons.arrow_drop_down),
        labelText: "Access"),
    onSaved: (dynamic str) {},
    onChanged: (dynamic str) {},
    validator: (dynamic str) {},
    displayItemFn: (dynamic item) => Text(
    item['name'] ?? '',
    style: TextStyle(fontSize: 16),
    ),
    findFn: (dynamic str) async => _roles,
    filterFn: (dynamic item, str) =>
        item['name'].toLowerCase().indexOf(str.toLowerCase()) >= 0,
    dropdownItemFn: (dynamic item, position, focused,
            dynamic lastSelectedItem, onTap) =>
        ListTile(
    title: Text(item['name']),
    subtitle: Text(
        item['desc'] ?? '',
    ),
    tileColor:
        focused ? Color.fromARGB(20, 0, 0, 0) : Colors.transparent,
    onTap: onTap,
    ),
),

Options

final bool autoFocus;
final bool Function(dynamic item, String str)? filterFn;
final bool Function(dynamic item1, dynamic item2)? selectedFn;
final Future<List<dynamic>> Function(String str) findFn;

final ListTile Function(
  dynamic item,
  int position,
  bool focused,
  bool selected,
  Function() onTap,
) dropdownItemFn;

final Widget Function(dynamic item) displayItemFn;
final InputDecoration? decoration;
final Color? dropdownColor;
final DropdownEditingController<T>? controller;
final void Function(dynamic item)? onChanged;
final void Function(dynamic)? onSaved;
final String? Function(T?)? validator;
final double? dropdownHeight;
final TextStyle? searchTextStyle;
final String emptyText;
final String emptyActionText;
final Future<void> Function()? onEmptyActionPressed;

所属分类

源码仓库

使用此插件的项目

暂无相关数据。