mini_calendar：日期组件的卓越选择

mini_calendar：日期组件的卓越选择

mini_calendar Date component developed with Flutter, plans to support display, swipe left and right, add date mark, radio, display week, etc. 项目地址: https://gitcode.com/gh_mirrors/mi/mini_calendar

项目介绍

mini_calendar 是一款使用 Flutter 开发的轻量级日期组件，旨在为开发者提供丰富、灵活的日期显示和交互功能。该项目支持显示日期、左右滑动切换月份、添加日期标记、单选、多选、显示星期等多样化操作，适用于各种需要日期选择的场景。

项目技术分析

mini_calendar 基于流行的跨平台框架 Flutter 开发，这意味着它可以在 iOS 和 Android 上无缝运行。它的核心是一个高度可定制的 MonthWidget 组件，开发者可以通过控制器参数来调整显示的月份和选择的日期，实现灵活的日期操作。

项目的技术亮点包括：

• 高度可定制性：提供多种自定义选项，包括自定义背景、头部、星期头部和日视图。
• 交互丰富：支持单选、连选、多选等交互方式，并通过回调函数提供交互结果。
• 易用性：简单的引入和调用方式，使得开发者可以快速集成到项目中。

项目及技术应用场景

mini_calendar 的应用场景广泛，例如：

• 日程管理应用：用户可以查看和选择日期来安排活动。
• 在线预订系统：用户可以选择日期进行预订，如酒店、机票等。
• 个人助手应用：提供日期提醒和事件规划功能。
• 教学应用：教师和学生可以查看课程表和考试日期。

这个组件的设计使其非常适合于任何需要日期选择和显示的场景，无论是简单的日期展示还是复杂的日期交互。

项目特点

以下是 mini_calendar 的一些主要特点：

1. 灵活的日期选择：支持单选、连选和多选，满足不同的选择需求。
2. 自定义视图：提供自定义背景、头部、星期头部和日视图的接口，使得组件可以完美融入任何设计风格。
3. 丰富的交互反馈：通过回调函数提供日期选择的反馈，使得开发者可以轻松获取用户的选择结果。
4. 高度可配置：包括日期范围限制、标记等配置项，让开发者可以根据需求调整组件行为。
5. 易于集成：简单的引入和调用方式，使得开发者可以快速集成到现有项目中。

使用方法

引入库

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

dependencies:
  mini_calendar: ^2.0.0

导包

在 Dart 文件中导入：

import 'package:mini_calendar/mini_calendar.dart';

月视图 (MonthWidget)

默认显示当前月份：

MonthWidget();

通过控制器参数控制显示的月份和选择的日期：

MonthWidget(
  controller: MonthController.init(
      MonthOption<String>(
        currentDay: DateDay.now().copyWith(month: index + 1, day: Random().nextInt(27) + 1),
        currentMonth: DateMonth.now().copyWith(month: index + 1),
      )
  ),
)

滚动日历 (MonthPageView)

创建控制器并获取 onCreated 回调：

MonthPageView<T>(
  padding: EdgeInsets.all(1),
  scrollDirection: Axis.horizontal,
  option: MonthOption<T>(
    enableContinuous: true,
    marks: { 
      DateDay.now().copyWith(day: 1): '111',
      DateDay.now().copyWith(day: 5): '222',
      // 更多标记...
    },
  ),
  showWeekHead: true,
  onContinuousSelectListen: (DateDay? firstDay, DateDay? endDay) {
  },
  onMultipleSelectListen: (List list) {
  },
  onMonthChange: (month) {
  },
  onDaySelected: (DateDay day, T? markData, bool enable) {
  },
  onCreated: (controller) {
  },
  onClear: () {
  },
)

控制器

参数初始化：

MonthOption({
  DateDay currentDay,
  DateMonth currentMonth,
  int firstWeek = 7,
  DateDay firstSelectDay,
  DateDay secondSelectDay,
  bool enableContinuous = false,
  Map<DateDay, T> marks = const {},
  List<DateDay>? multipleDays,
  List<DateDay>? enableDays,
  bool enableMultiple = false,
  DateDay minDay,
  DateDay maxDay,
});

注销：

MonthPageController#dispose();

更新：

MonthPageController#reLoad();

下一月：

MonthPageController#next();

上一月：

MonthPageController#last();

跳转到指定月份：

MonthPageController#goto(DateMonth month);

mini_calendar 为开发者提供了一个强大且灵活的日期组件，无论是简单还是复杂的日期选择需求，都能得到满足。开源项目的维护者也在不断更新和优化，使得这个组件越来越完善。如果你需要一个日期组件，mini_calendar 是一个不错的选择。

mini_calendar Date component developed with Flutter, plans to support display, swipe left and right, add date mark, radio, display week, etc. 项目地址: https://gitcode.com/gh_mirrors/mi/mini_calendar