Flutter日期选择插件birth_picker的使用

介绍

birth_picker 是一个用于 Flutter 应用程序的可定制日期选择器小部件，特别适用于选择出生日期。它通过支持平台特定的日期选择器（iOS 的 Cupertino 和 Android 的 Material）以及可定制的 UI 组件，提供了无缝的用户体验。

特性

• 支持 iOS 风格（Cupertino）和 Android 风格（Material）的日期选择器。
• 自动格式化日期字段（年、月、日）并验证输入。
• 支持 本地化，可以自定义日期字段顺序。
• 灵活的输入选项：
  • 允许用户直接使用键盘输入日期。
  • 提供一个 图标按钮，方便用户使用平台特定的日期选择器选择日期。

安装

1. 在 pubspec.yaml 文件的 dependencies 部分添加以下行：

   birth_picker: ^1.1.1
   

2. 运行以下命令安装包：

   flutter pub get
   

3. 导入包：

   import 'package:birth_picker/birth_picker.dart';
   

使用

在使用 BirthPicker 小部件之前，需要初始化日期格式化，因为它依赖于 intl 包来处理本地化的日期格式：

import 'package:birth_picker/birth_picker.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await initializeDateFormatting(); // 重要：初始化日期格式化
  runApp(const MyApp());
}

属性

示例

以下是一个完整的示例代码，展示了如何在 Flutter 应用程序中使用 BirthPicker：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await initializeDateFormatting(); // 初始化默认本地化
  runApp(const MyApp());
}

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'birth_picker',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Birth Picker Demo'),
    );
  }
}

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

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Padding(
        padding: const EdgeInsets.symmetric(horizontal: 24.0),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            BirthPicker(
              onChanged: (DateTime? dateTime) {
                if (dateTime != null) {
                  print('Selected Date: ${dateTime.toIso8601String()}');
                } else {
                  print('Invalid Date');
                }
              },
            ),
          ],
        ),
      ),
    );
  }
}

贡献

欢迎贡献！请打开 issues 和 pull requests 来改进这个包。

希望这个指南对你有所帮助！如果你有任何问题或需要进一步的帮助，请随时提问。