Flutter日历数据获取插件calendar_fetcher的使用

Flutter日历数据获取插件calendar_fetcher的使用

插件简介

calendar_fetcher 是一个用于在 Flutter 应用中获取日历数据的插件。它支持跨平台使用（移动端、桌面端、浏览器），且无需任何原生依赖。

特性

• 🚀 跨平台：支持移动设备、桌面应用和网页。
• ❤️ 简单易用。
• 🎈 无原生依赖。

开始使用

安装插件

首先，在 pubspec.yaml 文件中添加 calendar_fetcher 依赖：

dependencies:
  calendar_fetcher: ^版本号

然后运行 flutter pub get 命令以安装该插件。

获取日历数据

你可以通过 CalenderController() 来获取指定年份范围内的日历数据（年、月、日）。

List<Year> calender = CalenderController().getFullCalender(startYear, endYear);

Year 类

class Year {
  final int id;
  final int value;
  final List<Month> months;
  bool isSelected;
  bool isCurrentYear;
  final dynamic data;

  Year(this.id, this.value, this.months, this.isSelected, this.isCurrentYear, {this.data});
}

• id: 唯一的整数标识符。
• value: 年份值（如1997, 2015, 2023等）。
• months: 包含月份列表。
• isSelected: 用户点击该年时是否选中（true 或 false）。
• isCurrentYear: 当前年份（如果 yyyy 等于 value）。
• data: 可以存储任何类型的数据。

Month 类

class Month {
  final int id;
  final String name;
  final int value;
  final List<Day> days;
  bool isSelected;
  bool isCurrentMonth;
  final dynamic data;

  Month(this.id, this.name, this.value, this.days, this.isSelected, this.isCurrentMonth, {this.data});
}

• id: 唯一的整数标识符。
• name: 月份名称（如January, February, March等）。
• value: 月份值（1, 2, 3… 12）。
• days: 包含天数列表。
• isSelected: 用户点击该月时是否选中（true 或 false）。
• isCurrentMonth: 当前月份（如果 yyyy/MM 等于 value）。
• data: 可以存储任何类型的数据。

Day 类

class Day {
  final int id;
  final String name;
  final int value;
  bool isSelected;
  bool isToday;
  final dynamic data;

  Day(this.id, this.name, this.value, this.isSelected, this.isToday, {this.data});
}

• id: 唯一的整数标识符。
• name: 星期几的名称（如Saturday, Sunday等）。
• value: 日期值（1, 2, 3, 4, 5, … 31）。
• isSelected: 用户点击该天时是否选中（true 或 false）。
• isToday: 如果当前日期等于 yyyy/mm/dd 则为 true。
• data: 可以存储任何类型的数据。

完整示例代码

以下是一个完整的示例代码，展示了如何使用 calendar_fetcher 插件来获取并展示日历数据。

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: CalendarScreen(),
    );
  }
}

class CalendarScreen extends StatefulWidget {
  [@override](/user/override)
  _CalendarScreenState createState() => _CalendarScreenState();
}

class _CalendarScreenState extends State<CalendarScreen> {
  List<Year> calender = [];

  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化日历数据
    calender = CalenderController().getFullCalender(2020, 2023);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('日历数据'),
      ),
      body: ListView.builder(
        itemCount: calender.length,
        itemBuilder: (context, index) {
          final year = calender[index];
          return ExpansionTile(
            title: Text('${year.value}年'),
            children: year.months.map((month) {
              return ListTile(
                title: Text('${month.name}月'),
                subtitle: ListView.builder(
                  shrinkWrap: true,
                  physics: NeverScrollableScrollPhysics(),
                  itemCount: month.days.length,
                  itemBuilder: (context, dayIndex) {
                    final day = month.days[dayIndex];
                    return ListTile(
                      title: Text('${day.value}日'),
                      trailing: day.isToday ? Text('今天') : null,
                      onTap: () {
                        setState(() {
                          day.isSelected = !day.isSelected;
                        });
                      },
                    );
                  },
                ),
              );
            }).toList(),
          );
        },
      ),
    );
  }
}