Y Calendar #

一个美观、易用的 Flutter 日历选择组件，支持单日期选择和日期范围选择。

特性 #

• ✅ 支持单日期选择
• ✅ 支持日期范围选择
• ✅ 支持深/浅色主题
• ✅ 支持 Material 风格主题
• ✅ 支持预设快捷选项

示例 #

预览地址：knight-l.github.io/y_calendar/

完整的示例代码请查看 example 文件夹中的演示应用。

安装 #

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

dependencies:
  y_calendar: ^1.0.5

然后运行：

flutter pub get

使用方法 #

导入包 #

import 'package:y_calendar/y_calendar.dart';

单日期选择 #

ElevatedButton(
    onPressed: () async {
        DateTime? date = await YCalendar<DateTime>().showBottomSheet(
            context,
        );
        if (date != null) {
            data.value = DateFormat('yyyy-MM-dd').format(date);
        }
    },
    child: Text('单个日期选择'),
)

日期范围选择 #

ElevatedButton(
    onPressed: () async {
        List<DateTime>? date = await YCalendar<List<DateTime>>(
            presets: presets,
        ).showBottomSheet(context);
        if (date != null) {
            data.value = date.map(DateFormat('yyyy-MM-dd').format).toString();
        }
    },
    child: Text('范围选择'),
)

自定义配置 #

YCalendar<DateTime>(
    title: "选择日期",
    color: Colors.blue,
    minDate: DateTime(2024, 1, 1),
    maxDate: DateTime(2024, 12, 31),
    defaultDate: DateTime.now(),
    showConfirm: true,
    confirmText: "确认",
    closeOnClickOverlay: true,
    round: BorderRadius.vertical(top: Radius.circular(20.0)),
    height: 400.0,
).showBottomSheet(context)

API 参数 #

泛型参数 #

• YCalendar<DateTime>: 单日期选择模式
• YCalendar<List<DateTime>>: 日期范围选择模式

依赖 #

• Flutter SDK: >=1.17.0
• Dart SDK: ^3.7.0
• intl: ^0.20.2

贡献 #

欢迎提交 Issue 和 Pull Request 来改进这个项目。

许可证 #

本项目采用 MIT 许可证。详情请查看 LICENSE 文件。