mockingbird_select 是一个用于 Flutter 的选择组件插件，它可以帮助你在应用中实现类似于下拉选择、单选、多选等功能。以下是如何使用 mockingbird_select 插件的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 mockingbird_select 插件的依赖。

dependencies:
  flutter:
    sdk: flutter
  mockingbird_select: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 导入插件

在你的 Dart 文件中导入 mockingbird_select 插件。

import 'package:mockingbird_select/mockingbird_select.dart';

3. 使用 MockingbirdSelect 组件

MockingbirdSelect 是一个可以用于显示选择项的组件。你可以通过传递选项列表来使用它。

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Mockingbird Select Example'),
        ),
        body: Center(
          child: MockingbirdSelect(
            options: ['Option 1', 'Option 2', 'Option 3'],
            onChanged: (selectedValue) {
              print('Selected: $selectedValue');
            },
          ),
        ),
      ),
    );
  }
}

4. 自定义选项

你可以通过传递 options 参数来定义选择项的列表。onChanged 回调会在用户选择某个选项时触发，并返回选中的值。

5. 其他配置

MockingbirdSelect 还提供了其他一些可配置的属性，例如：

• hintText: 提示文本，显示在选择框上方的提示信息。
• icon: 选择框右侧的图标。
• style: 文本样式。
• dropdownColor: 下拉菜单的背景颜色。

MockingbirdSelect(
  options: ['Option 1', 'Option 2', 'Option 3'],
  onChanged: (selectedValue) {
    print('Selected: $selectedValue');
  },
  hintText: 'Select an option',
  icon: Icon(Icons.arrow_drop_down),
  style: TextStyle(fontSize: 16, color: Colors.black),
  dropdownColor: Colors.white,
);

6. 处理多选

如果你需要实现多选功能，可以使用 MockingbirdMultiSelect 组件。

MockingbirdMultiSelect(
  options: ['Option 1', 'Option 2', 'Option 3'],
  onChanged: (selectedValues) {
    print('Selected: $selectedValues');
  },
);

7. 处理单选

MockingbirdSelect 默认就是单选的，你可以通过 onChanged 回调来获取用户选择的值。

8. 处理表单集成

如果你需要将 MockingbirdSelect 集成到表单中，可以将其包装在 FormField 中。

Form(
  child: Column(
    children: [
      FormField<String>(
        builder: (FormFieldState<String> state) {
          return MockingbirdSelect(
            options: ['Option 1', 'Option 2', 'Option 3'],
            onChanged: (selectedValue) {
              state.didChange(selectedValue);
            },
          );
        },
      ),
      ElevatedButton(
        onPressed: () {
          // 处理表单提交
        },
        child: Text('Submit'),
      ),
    ],
  ),
);

9. 处理验证

你可以在 FormField 中添加验证逻辑。

FormField<String>(
  validator: (value) {
    if (value == null || value.isEmpty) {
      return 'Please select an option';
    }
    return null;
  },
  builder: (FormFieldState<String> state) {
    return MockingbirdSelect(
      options: ['Option 1', 'Option 2', 'Option 3'],
      onChanged: (selectedValue) {
        state.didChange(selectedValue);
      },
    );
  },
);

10. 处理异步数据

如果选项数据是异步加载的，你可以在 MockingbirdSelect 中使用 FutureBuilder。

Future<List<String>> fetchOptions() async {
  // 模拟异步加载
  await Future.delayed(Duration(seconds: 2));
  return ['Option 1', 'Option 2', 'Option 3'];
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Mockingbird Select Example'),
        ),
        body: Center(
          child: FutureBuilder<List<String>>(
            future: fetchOptions(),
            builder: (context, snapshot) {
              if (snapshot.connectionState == ConnectionState.waiting) {
                return CircularProgressIndicator();
              } else if (snapshot.hasError) {
                return Text('Error: ${snapshot.error}');
              } else {
                return MockingbirdSelect(
                  options: snapshot.data!,
                  onChanged: (selectedValue) {
                    print('Selected: $selectedValue');
                  },
                );
              }
            },
          ),
        ),
      ),
    );
  }
}