Flutter自定义下拉菜单插件quanht_dropdown_custom的使用

Flutter自定义下拉菜单插件quanht_dropdown_custom的使用

简介

在本教程中，我们将详细介绍如何使用quanht_dropdown_custom插件创建自定义下拉菜单。该插件提供了许多功能，例如自动关闭下拉菜单、控制空间不足时的数据列表显示等。

破坏性变更（v0.0.2）

在v0.0.2版本中，quanht_dropdown_custom发生了一些破坏性变更：

• AppDropList小部件支持数据列表在空间不足时的显示。
• parentScrollController是一个屏幕滚动控制器，当滚动时会自动关闭下拉菜单。
• DropListItem类替代了DropdownItem类。
• onChange回调已被保留，并且在选择或取消选择时被调用。
• 许多参数已被重命名和更新，请查看文档以获取更新后的参数。

使用指南

简单使用

首先，确保你已经将quanht_dropdown_custom添加到你的pubspec.yaml文件中：

dependencies:
  quanht_dropdown_custom: ^0.0.2

然后，你可以通过以下方式简单地使用AppDropList小部件：

import 'package:quanht_dropdown_custom/quanht_dropdown_custom.dart';

AppDropList(
  onChange: (output) {},
  items: <DropListItem>[],
  label: '@label',
  colorLabel: Colors.black,
  hintText: '@hintxt',
  enabled: true,
  dropdownButtonStyle: const DropdownButtonStyle(
    height: 48,
  ),
  dropdownStyle: const DropdownStyle(elevation: 2),
),

控制自动关闭下拉菜单

如果你希望在滚动时自动关闭下拉菜单，则需要在小部件中添加parentScrollController：

import 'package:quanht_dropdown_custom/quanht_dropdown_custom.dart';

class MyHomePage extends StatefulWidget {
  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  ScrollController scrollController = ScrollController();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      body: Column(
        children: [
          AppDropList(
            onChange: (output) {},
            items: <DropListItem>[],
            label: 'Label',
            colorLabel: Colors.black,
            hintText: 'Hint text',
            enabled: true,
            dropdownButtonStyle: const DropdownButtonStyle(
              height: 48,
            ),
            dropdownStyle: const DropdownStyle(elevation: 2),
            parentScrollController: scrollController,
          ),
        ],
      ),
    );
  }
}

预览

以下是使用quanht_dropdown_custom插件的几个示例：

完整示例

以下是一个完整的示例代码，展示了如何使用quanht_dropdown_custom插件创建一个带有下拉菜单的应用程序：

import 'package:flutter/material.dart';
import 'package:quanht_dropdown_custom/droplist_overlap/droplist.item.dart';
import 'package:quanht_dropdown_custom/droplist_overlap/droplist.overlay.dart';
import 'package:quanht_dropdown_custom/quanht_dropdown_custom.dart';

import 'extension.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Dropdown custom',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Dropdown custom'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  Format _formatSelect = Format.UNKNOWN;
  ScrollController scrollController = ScrollController();
  final _itemsFormat =
      Format.values.where((v) => v != Format.UNKNOWN).map((element) {
    final index = Format.values.indexOf(element);
    return DroplistItem(
        id: index, nameSelected: element.name, index: index, data: element);
  }).toList();

  void _selectDropdown(DroplistItem item) {
    _formatSelect = item.data;
    setState(() {});
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Column(
        children: [
          const SizedBox(height: 20),
          Expanded(
            child: SingleChildScrollView(
              controller: scrollController,
              child: Padding(
                padding: const EdgeInsets.symmetric(horizontal: 16.0),
                child: Column(
                  mainAxisAlignment: MainAxisAlignment.center,
                  children: <Widget>[
                    const Text('You just select :'),
                    Text(
                      _formatSelect.name,
                      style: Theme.of(context).textTheme.headlineMedium,
                    ),
                    AppDropList(
                      onChange: (output) => _selectDropdown(output),
                      items: _itemsFormat,
                      label: 'Format',
                      parentScrollController: scrollController,
                      colorLabel: Colors.black,
                      hintText: 'Select format',
                      enabled: true,
                      dropdownButtonStyle: const DropdownButtonStyle(
                        height: 48,
                      ),
                      dropdownStyle: const DropdownStyle(elevation: 2),
                    ),
                    const SizedBox(height: 1000.0)
                  ],
                ),
              ),
            ),
          ),
        ],
      ),
    );
  }
}