Flutter广告日历插件flutter_bs_ad_calendar的使用

功能

• 简易的API接口
• 可根据需求自定义组件
• 支持在尼泊尔日期（BS）和公历日期（AD）之间切换
• 支持动态事件和节假日

安装

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

dependencies:
  flutter_bs_ad_calendar: ^1.0.4

基本设置

完整的示例代码可以在这里查看。

import 'package:flutter_bs_ad_calendar/flutter_bs_ad_calendar.dart';

// 设置初始日历类型为公历（AD）
CalendarType _calendarType = CalendarType.ad;

// 使用flutter_bs_ad_calendar插件创建日历
FlutterBSADCalendar(
    calendarType: _calendarType, // 日历类型
    firstDate: DateTime(1970), // 日历起始日期
    lastDate: DateTime(2024), // 日历结束日期
    onMonthChanged: (date) => print('month changed: ${date.toString()}'), // 月份变化时回调
    onDateSelected: (date) => print('selected day: ${date.toString()}'), // 日期选择时回调
);

额外信息

以下是一些额外的功能选项：

onDateSelected: (date) {
    print('selected day: ${date.toString()}'); // 日期选择时回调
},
onMonthChanged: (date) {
    print('month changed: ${date.toString()}'); // 月份变化时回调
},
todayDecoration: BoxDecoration(
    borderRadius: const BorderRadius.all(Radius.circular(10)), // 圆角
    color: Theme.of(context).primaryColorLight, // 背景色
    shape: BoxShape.rectangle, // 形状
),
selectedDayDecoration: BoxDecoration(
    borderRadius: const BorderRadius.all(Radius.circular(10)), // 圆角
    color: Theme.of(context).primaryColorDark, // 背景色
    shape: BoxShape.rectangle, // 形状
),
dayBuilder: (dayToBuild) {
    return Container(
        padding: const EdgeInsets.symmetric(horizontal: 8.0), // 内边距
        child: Column(
            mainAxisAlignment: MainAxisAlignment.center, // 主轴居中
            children: [
                Align(
                    alignment: Alignment.topCenter, // 对齐方式
                    child: Text(
                        '${dayToBuild.day}', // 显示日期
                        style: Theme.of(context).textTheme.bodyMedium, // 文本样式
                    ),
                ),
            ],
        ),
    );
},

要动态更新可见的日历格式，可以将以下行添加到组件中：

calendarType: _calendarType

通过更改_calendarType的值来切换日历类型。例如：

setState(() {
    _calendarType = CalendarType.bs; // 切换到尼泊尔日期
});

示例代码

以下是完整的示例代码，展示了如何使用flutter_bs_ad_calendar插件：

import 'dart:collection';

import 'package:calendar_example/pages/dynamic_calendar.dart';
import 'package:flutter/material.dart';
import 'package:flutter_bs_ad_calendar/flutter_bs_ad_calendar.dart';

import 'pages/basic_calendar.dart';
import 'pages/event_calendar.dart';
import 'pages/feature_calendar.dart';

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Nepali Calendar',
      theme: ThemeData(
        colorScheme: const ColorScheme.light(
          primary: Colors.lightBlue,
          secondary: Colors.red,
        ),
      ),
      home: const MyHomePage(title: 'Flutter Nepali Calendar'),
    );
  }
}

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

  final String? title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  CalendarType _calendarType = CalendarType.ad; // 初始日历类型为公历

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title ?? ''),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            const SizedBox(height: 30.0),
            ElevatedButton(
              child: const Text('Basics Calendar'),
              onPressed: () => Navigator.push(
                context,
                MaterialPageRoute(builder: (_) => const BasicCalendar()),
              ),
            ),
            const SizedBox(height: 15.0),
            ElevatedButton(
              child: const Text('Dynamic Calendar'),
              onPressed: () => Navigator.push(
                context,
                MaterialPageRoute(builder: (_) => const DynamicCalendar()),
              ),
            ),
            const SizedBox(height: 15.0),
            ElevatedButton(
              child: const Text('Calendar with Features'),
              onPressed: () => Navigator.push(
                context,
                MaterialPageRoute(builder: (_) => const FeatureCalendar()),
              ),
            ),
            const SizedBox(height: 15.0),
            ElevatedButton(
              child: const Text('Calendar with Event'),
              onPressed: () => Navigator.push(
                context,
                MaterialPageRoute(builder: (_) => const EventCalendar()),
              ),
            ),
            const SizedBox(height: 15.0),
            ElevatedButton(
              child: const Text('Nepali Calendar Dialog'),
              onPressed: () async {
                DateTime? date = await showFlutterBSADCalendarDialog(
                  context: context,
                );
              },
            ),
            const SizedBox(height: 15.0),
            ElevatedButton(
              child: const Text('English Calendar Dialog'),
              onPressed: () async {
                DateTime? date = await showFlutterBSADCalendarDialog(
                  context: context,
                  calendarType: CalendarType.ad,
                );
              },
            ),
            const SizedBox(height: 30.0),
          ],
        ),
      ),
    );
  }
}