flutter_custom_calendar

4.3 KiB

Raw Blame History Unescape Escape

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

FlutterCalendarWidget

Flutter上的一个日历控件，可以定制成自己想要的样子。

Language: English|中文简体

概述
在线Demo
效果图
快速使用
2.0版本
注意事项
主要Api文档

概述

支持公历，农历，节气，传统节日，常用节假日
日期范围设置，默认支持的最大日期范围为1971.01-2055.12
禁用日期范围设置，比如想实现某范围的日期内可以点击，范围外的日期置灰
支持单选、多选模式，提供多选超过限制个数的回调和多选超过指定范围的回调。
跳转到指定日期，默认支持动画切换
自定义日历Item，支持组合widget的方式和利用canvas绘制的方式
自定义顶部的WeekBar
根据实际场景，可以给Item添加自定义的额外数据，实现各种额外的功能。比如实现进度条风格的日历，实现日历的各种标记
支持周视图的展示,支持月份视图和星期视图的展示与切换联动

在线Demo

日历支持web预览：点击此处进入预览

效果图

使用

1.在pubspec.yaml文件里面添加依赖:

flutter_custom_calendar:
    git:
      url: https://github.com/LXD312569496/flutter_custom_calendar.git

2.导入flutter_custom_calendar库

import 'package:flutter_custom_calendar/flutter_custom_calendar.dart';

3.创建CalendarViewWidget对象，配置CalendarController

CalendarController controller= new CalendarController(
        minYear: 2018,
        minYearMonth: 1,
        maxYear: 2020,
        maxYearMonth: 12,
        showMode: CalendarConstants.MODE_SHOW_MONTH_AND_WEEK);
CalendarViewWidget calendar= CalendarViewWidget(
              calendarController: controller,
            ),

boxDecoration用来配置整体的背景
利用CalendarController来配置一些数据，并且可以通过CalendarController进行一些操作或者事件监听，比如滚动到下一个月，获取当前被选中的Item等等。

4.操作日历

controller.toggleExpandStatus();//月视图和周视图的切换

controller.previousPage();//操作日历切换到上一页

controller.nextPage();//操作日历切换到下一页

2.0版本

主要改动：

UI配置相关的参数，移动到CalendarView的构造方法里面（旧版本是在controller里面配置）
日历支持padding和margin属性，item的大小计算修改
实现日历整体自适应高度
controller提供changeExtraDataMap的方法，可以随时动态的修改自定义数据extraDataMap
支持显示月视图和周视图的情况，优先显示周视图，MODE_SHOW_WEEK_AND_MONTH
支持verticalSpacing和itemSize属性

注意事项

如果使用2.0之前的版本，则需要将UI配置相关的参数，移动到CalendarView的构造方法里面（旧版本是在controller里面配置）
暂时没有发现其他问题，如果有其他问题，可以跟我说一下。
如果你用这个库做了日历，可以将展示结果分享给我，我贴到文档上进行展示

主要API文档

API Documentation

4.3 KiB Raw Blame History Unescape Escape