Flutter下拉选择插件dropdown_select的使用

dropdown_select 是一个带有 Material Design 样式的 Flutter 下拉选择小部件，支持单选或多选选项，并且支持工具提示以增强可用性。该插件是 dropdown_textfield 的分支版本，增加了许多社区所需的特性。

功能特点

• 可搜索的下拉菜单
• 单选与多选支持
• Material Design 风格
• 完全可定制的用户界面
• 多选下拉项的工具提示

使用方法

导入插件

首先，在项目的 pubspec.yaml 文件中添加依赖：

dependencies:
  dropdown_select: ^版本号

然后运行以下命令安装依赖：

flutter pub get

示例代码

以下是一个完整的示例代码，展示如何在 Flutter 应用程序中使用 dropdown_select 插件。

import 'package:flutter/material.dart';
import 'package:dropdown_select/dropdown_select.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: DropdownSelectExample(),
    );
  }
}

class DropdownSelectExample extends StatelessWidget {
  const DropdownSelectExample({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Dropdown Select Example'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            // 单选下拉框
            DropdownSelect(
              clearOption: true, // 是否显示清除按钮
              enableSearch: true, // 是否启用搜索功能
              clearIconProperty: IconProperty(color: Colors.green), // 清除按钮图标颜色
              searchTextStyle: const TextStyle(color: Colors.red), // 搜索框文本样式
              searchDecoration: const InputDecoration(
                hintText: "请输入自定义提示文字", // 搜索框提示文字
              ),
              validator: (value) {
                if (value == null) {
                  return "必填字段"; // 验证错误信息
                } else {
                  return null;
                }
              },
              dropDownItemCount: 6, // 下拉菜单最大显示项目数
              dropDownList: const [
                DropDownValueModel(name: 'name1', value: "value1"), // 下拉选项
                DropDownValueModel(
                    name: 'name2',
                    value: "value2",
                    toolTipMsg: "这是一个下拉按钮，我们可以从中选择唯一的值"), // 带有工具提示的选项
                DropDownValueModel(name: 'name3', value: "value3"),
                DropDownValueModel(
                    name: 'name4',
                    value: "value4",
                    toolTipMsg: "这是一个下拉按钮，我们可以从中选择唯一的值"),
                DropDownValueModel(name: 'name5', value: "value5"),
                DropDownValueModel(name: 'name6', value: "value6"),
                DropDownValueModel(name: 'name7', value: "value7"),
                DropDownValueModel(name: 'name8', value: "value8"),
              ],
              onChanged: (val) {
                print("Selected Value: $val"); // 选择事件回调
              },
            ),
          ],
        ),
      ),
    );
  }
}