Flutter菜单列表展示插件flutter_menu_list的使用

Flutter菜单列表展示插件flutter_menu_list的使用

flutter_menu_list 是一个用于在 Flutter 应用中展示简单菜单列表的小部件。它提供了类似于 iOS 的菜单列表显示，并且支持暗色主题。

特性

• 提供类似 iOS 的菜单列表显示。
• 支持暗色主题。

使用方法

简单使用

以下是一个简单的示例，展示了如何使用 MenuListContainer 来创建一个菜单列表。

import 'package:flutter_menu_list/flutter_menu_list.dart';

MenuListContainer(
  sections: [
    MenuListSection(
      title: MenuListSectionTitle(title: 'First Title'),
      menus: [
        MenuListContent(
          leading: Icon(
            Icons.ac_unit,
            color: Colors.white,
            size: 20,
          ),
          title: Text('Title1'),
          onTap: () {},
        ),
        MenuListContent(
          title: Text('Title2'),
          onTap: () {},
        ),
      ],
    ),
    MenuListSection(
      title: MenuListSectionTitle(title: 'Second Title'),
      menus: [
        MenuListContent(
          title: Text('Display of very long titles'),
          subTitle: MenuListSubTitle('Display of very long sub titles'),
          onTap: () {},
        ),
        MenuListContent(
          title: Text('Title4'),
          trailing: SizedBox(
            height: 20,
            child: CupertinoSwitch(
              value: true,
              onChanged: (value) {},
            ),
          ),
        ),
      ],
    ),
    MenuListSection(
      title: MenuListSectionTitle(
        title: 'Third Title',
        padding: const EdgeInsets.only(
          left: 15,
          top: 8,
          bottom: 8,
        ),
      ),
      lineIndent: 0,
      menus: [
        MenuListContent(
          leadingSpace: 15,
          title: Text('Display of very long titles'),
          subTitle: MenuListSubTitle('Display of very long sub titles'),
          onTap: () {},
        ),
        MenuListContent(
          leadingSpace: 15,
          title: Text('Title4'),
          trailing: SizedBox(
            height: 20,
            child: CupertinoSwitch(
              value: true,
              onChanged: (value) {},
            ),
          ),
        ),
      ],
    ),
  ],
);

在列中使用

如果需要将 MenuListContainer 放置在一个列中，可以使用 Expanded 小部件来确保其占据剩余的空间。

Column(
  children: [
    Container(
      padding: const EdgeInsets.all(10),
      child: const Text(
        'Example App',
        style: TextStyle(
          fontSize: 20,
        ),
      ),
    ),
    /// Wrapping it up is important.
    const Expanded(
      child: MenuListContainer(
        sections: [
          MenuListSection(
            title: MenuListSectionTitle(title: 'Drawer Menu'),
            menus: [
              MenuListContent(
                title: Text('Title'),
              ),
            ],
          )
        ],
      ),
    ),
  ],
);

自定义主题

可以通过修改默认主题来实现自定义样式。

// 修改默认的亮色主题
final customeLightTheme = MenuListThemes.lightTheme.copyWith();

// 修改默认的暗色主题
final customeDarkTheme = MenuListThemes.darkTheme.copyWith();

// 创建自定义主题
final customizedTheme = ThemeData(
  // 背景颜色
  backgroundColor: Colors.white,
  // 菜单列表内容背景颜色
  primaryColor: Colors.grey,
  textTheme: TextTheme(
    // 文本样式
    bodyText1: TextStyle(),
    subtitle1: TextStyle(), // Android 子标题样式
    subtitle2: TextStyle(), // iOS 子标题样式
  ),
  // 图标样式
  iconTheme: IconThemeData(),
  // 分割线颜色
  dividerColor: Colors.black,
);

应用自定义主题：

MenuListContainer(
  // 设置亮色主题
  theme: customizedTheme,
  // 设置暗色主题
  darkTheme: customizedTheme,
);

完整示例代码

以下是完整的示例代码，包含菜单列表的基本使用和自定义主题的应用。

import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:flutter_menu_list/flutter_menu_list.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(
      title: 'Flutter Demo',
      theme: ThemeData(primarySwatch: Colors.blue),
      darkTheme: ThemeData.dark(),
      home: const Example(),
    );
  }
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Flutter Menu List'),
      ),
      drawer: Drawer(
        child: Column(
          mainAxisSize: MainAxisSize.min,
          mainAxisAlignment: MainAxisAlignment.start,
          crossAxisAlignment: CrossAxisAlignment.center,
          children: [
            Container(
              color: Theme.of(context).backgroundColor,
              padding: const EdgeInsets.all(20),
              child: const SafeArea(
                child: Center(
                  child: Text('Test'),
                ),
                bottom: false,
              ),
            ),
            const Divider(
              height: 0,
              color: Color(0xFFEEEEEE),
            ),
            Expanded(
              child: MediaQuery.removePadding(
                context: context,
                removeTop: true,
                child: const MenuListContainer(
                  sections: [
                    MenuListSection(
                      title: MenuListSectionTitle(title: 'Drawer Menu'),
                      menus: [
                        MenuListContent(
                          title: Text('Title'),
                        ),
                      ],
                    )
                  ],
                ),
              ),
            ),
          ],
        ),
      ),
      body: SizedBox(
        height: double.infinity,
        child: MenuListContainer(
          sections: [
            MenuListSection(
              title: const MenuListSectionTitle(title: 'First Title'),
              menus: [
                MenuListContent(
                  leading: const Icon(
                    Icons.ac_unit,
                    color: Colors.white,
                    size: 20,
                  ),
                  title: const Text('Title1'),
                  onTap: () {},
                ),
                MenuListContent(
                  title: const Text('Title2'),
                  onTap: () {},
                ),
              ],
            ),
            MenuListSection(
              title: const MenuListSectionTitle(title: 'Second Title'),
              menus: [
                MenuListContent(
                  title: const Text('Display of very long titles'),
                  subTitle:
                      const MenuListSubTitle('Display of very long sub titles'),
                  onTap: () {},
                ),
                MenuListContent(
                  title: const Text('Title4'),
                  trailing: SizedBox(
                    height: 20,
                    child: CupertinoSwitch(
                      value: true,
                      onChanged: (value) {},
                    ),
                  ),
                ),
              ],
            ),
            MenuListSection(
              title: const MenuListSectionTitle(
                title: 'Third Title',
                padding: EdgeInsets.only(
                  left: 15,
                  top: 8,
                  bottom: 8,
                ),
              ),
              lineIndent: 0,
              menus: [
                MenuListContent(
                  leadingSpace: 15,
                  title: const Text('Display of very long titles'),
                  subTitle:
                      const MenuListSubTitle('Display of very long sub titles'),
                  onTap: () {},
                ),
                MenuListContent(
                  leadingSpace: 15,
                  title: const Text('Title4'),
                  trailing: SizedBox(
                    height: 20,
                    child: CupertinoSwitch(
                      value: true,
                      onChanged: (value) {},
                    ),
                  ),
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }
}