y_calendar 1.0.3

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

Y Calendar

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

特性

• ✅ 支持单日期选择
• ✅ 支持日期范围选择

示例

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

范围选择	单日期选择
[范围选择]	[单日期选择]

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

安装

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

dependencies:
  y_calendar: ^0.0.1

然后运行：

flutter pub get

使用方法

导入包

import 'package:y_calendar/y_calendar.dart';

单日期选择

ElevatedButton(
  onPressed: () async {
    final date = await YCalendar<DateTime>().showBottomSheet(context);
    if (date != null) {
      print('选中的日期: ${DateFormat('yyyy-MM-dd').format(date)}');
    }
  },
  child: Text('选择日期'),
)

日期范围选择

ElevatedButton(
  onPressed: () async {
    List<DateTime>? dates = await YCalendar<List<DateTime>>(
      cumFlitter: true,
    ).showBottomSheet(context);
    if (dates != null && dates.length == 2) {
      print('选中的日期范围: ${DateFormat('yyyy-MM-dd').format(dates[0])} - ${DateFormat('yyyy-MM-dd').format(dates[1])}');
    }
  },
  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 参数

参数	类型	默认值	描述
title	String	"日期选择"	日历标题
color	Color?	null	主题颜色，影响按钮和选中日期的颜色
minDate	DateTime?	当前日期	最小可选日期
maxDate	DateTime?	当前日期+180 天	最大可选日期
defaultDate	T?	null	默认选中的日期
round	BorderRadiusGeometry	BorderRadius.vertical(top: Radius.circular(20.0))	弹窗圆角
showConfirm	bool	true	是否显示确认按钮
closeOnClickOverlay	bool	true	是否允许点击遮罩层关闭
confirmText	String	"确定"	确认按钮文字
height	double	400.0	日历高度
cumFlitter	bool?	null	是否启用自定义过滤功能

泛型参数

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

依赖

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

贡献

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

许可证

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