Flutter时间选择器插件time_dropper的使用

Flutter时间选择器插件time_dropper的使用

TimeDropper 是一个灵感来源于 TimeDropperJS 的时间选择器插件。它提供了动画效果和完全可定制的圆形表盘。

特性

• 动画效果和完全可定制的圆形表盘。
• 可以适配系统主题或通过 TimeDropperThemeData 进行自定义。
• 提供三种不同的设计样式。

不同的设计样式

TimeDropperStyle.outerFilled	TimeDropperStyle.innerFilled	TimeDropperStyle.bordered

开始使用

1. 在 pubspec.yaml 文件中添加依赖：

   dependencies:
     time_dropper: <latest_version>
   

2. 在终端运行 flutter pub get 命令获取依赖。

3. 导入 time_dropper 包：

   import 'package:time_dropper/time_dropper.dart';
   

使用方法

完整的实现可以查看 示例代码。

_showTimeDropper(GlobalKey key) {
  showTimeDropper(
    context: context,
    onDone: () {
      // TODO: 使用此回调在时间选择器窗口关闭时更新时间
    },
    onTimeChanged: (time) {
      setState(() {
        _time = time;
      });
      // 使用此回调实时获取时间变化
    },
    containerKey: key,
    // 传递键以便时间选择器对话框靠近容器小部件打开（如果为null，则在中心打开）
    initialTime: _time,
    style: TimeDropperStyle.outerFilled,
    // 或者 TimeDropperStyle.innerFilled / TimeDropperStyle.bordered
  );
}

其他信息

showTimeDropper() 函数

showTimeDropper() 函数接受以下参数：

TimeDropperStyle 枚举

TimeDropperStyle 枚举包括以下样式：

TimeDropperThemeData

TimeDropperThemeData 可用于自定义对话框的外观：

完整示例

import 'package:flutter/material.dart';
import 'package:google_fonts/google_fonts.dart';
import 'package:time_dropper/time_dropper.dart';

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Time Dropper Example',
      theme: ThemeData(
        primarySwatch: Colors.indigo,
        fontFamily: GoogleFonts.montserrat().fontFamily,
      ),
      themeMode: ThemeMode.light,
      debugShowCheckedModeBanner: false,
      home: const Homepage(),
    );
  }
}

class Homepage extends StatefulWidget {
  const Homepage({super.key});

  [@override](/user/override)
  State<Homepage> createState() => _HomepageState();
}

class _HomepageState extends State<Homepage> {
  final _key1 = GlobalKey();
  final _key2 = GlobalKey();
  final _key3 = GlobalKey();
  TimeOfDay? _time1;
  TimeOfDay? _time2;
  TimeOfDay? _time3;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        elevation: 0.0,
        title: const Text("Time Dropper Example"),
      ),
      body: Padding(
        padding: const EdgeInsets.all(20.0),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.spaceAround,
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            FractionallySizedBox(
              widthFactor: 0.5,
              child: OutlinedButton(
                key: _key1,
                child: Text(
                    _time1 == null ? "Select time 1" : _time1!.format(context)),
                onPressed: () => _showPicker(_key1),
              ),
            ),
            Center(
              child: FractionallySizedBox(
                widthFactor: 0.5,
                child: OutlinedButton(
                  key: _key2,
                  child: Text(_time2 == null
                      ? "Select time 2"
                      : _time2!.format(context)),
                  onPressed: () => _showPicker(_key2),
                ),
              ),
            ),
            Align(
              alignment: Alignment.centerRight,
              child: FractionallySizedBox(
                widthFactor: 0.5,
                child: OutlinedButton(
                  key: _key3,
                  child: Text(_time3 == null
                      ? "Select time 3"
                      : _time3!.format(context)),
                  onPressed: () => _showPicker(_key3),
                ),
              ),
            ),
          ],
        ),
      ),
    );
  }

  _showPicker(GlobalKey key) {
    showTimeDropper(
      context: context,
      onDone: print,
      onTimeChanged: (time) {
        setState(() {
          if (key == _key1) _time1 = time;
          if (key == _key2) _time2 = time;
          if (key == _key3) _time3 = time;
        });
      },
      containerKey: key,
      initialTime: key == _key1
          ? _time1
          : key == _key2
              ? _time2
              : _time3,
      style: key == _key1
          ? TimeDropperStyle.outerFilled
          : key == _key2
              ? TimeDropperStyle.innerFilled
              : TimeDropperStyle.bordered,
      themeData: TimeDropperThemeData(elevation: 2),
    );
  }
}