flutter pub add scrollable_clean_calendar基于插件公开信息、社区数据与项目使用情况整理的选型参考。
一个干净、可垂直滚动的 Flutter 日历小部件，支持本地化自定义和日期范围选择。设计简洁易用，允许用户通过平滑滚动浏览月份，并直观地选择日期范围。该包可在所有主要平台（包括 Android、iOS、Web、macOS、Windows 和 Linux）上兼容使用。适用于需要简约但功能齐全的日历界面并支持国际化功能的应用程序。
以下为关联源码仓库的 README 原文快照，最新内容请访问源码仓库。
A clean calendar widget with vertical scroll, locale and range selection date.
 Rodrigo Dobbin Fellows |
 Eduardo Natale |
 Fabio Fiuza |
 Filippo Pizzicola |
 Lucian Risso Correia |
Add
scrollable_clean_calendar: 1.5.0
to your pubspec.yaml and run
flutter pub get
in the project's main folder.
| Parameter | Type | Default | Description |
|---|---|---|---|
| calendarController | CleanCalendarController | required | The controller of ScrollableCleanCalendar |
| locale | String | en | The language locale |
| scrollController | ScrollController | null | Scroll controller, if you use this controller the Parameter initialFocusDate and the Functions scrollToMonth and jumpToMonth won't work since this override the scrollable list controller. Do not use them together or you will receive a nullPointer Exception |
| showWeekdays | bool | true | If is to show or not the weekdays in calendar |
| layout | Layout | null | What layout (design) is going to be used. Important: layout is required if you don't use all the layout builders |
| spaceBetweenMonthAndCalendar | double | 24 | The space between month and calendar |
| spaceBetweenCalendars | double | 24 | The space between calendars |
| initialFocusDate | DateTime | null | Initial date that the calendar scroll should focus when open |
| scrollToMonth | Function({required DateTime date, double alignment = 0, required Duration duration, Curve curve = Curves.linear, List<double> opacityAnimationWeights = const [40, 20, 40]}) | null | Animate the list over duration using the given curve such that the item at index ends up with its leading edge at the given alignment. |
| jumpToMonth | Function ({required DateTime date, double alignment = 0}) | null | Immediately, without animation, reconfigure the list so that the item at index's leading edge is at the given alignment. |
| calendarCrossAxisSpacing | double | 4 | The horizontal space in the calendar dates |
| calendarMainAxisSpacing | double | 4 | The vertical space in the calendar dates |
| padding | EdgeInsetsGeometry | EdgeInsets.symmetric(horizontal: 16, vertical: 32) | The parent padding |
| monthTextStyle | TextStyle | Theme.of(context).textTheme.headline6 | The label text style of month |
| monthTextAlign | TextAlign | TextAlign.left | The label text align of month |
| weekdayTextStyle | TextStyle | Theme.of(context).textTheme.bodyText1 | The label text align of month |
| weekdayAspectRatio | double | 1.0 | The aspect ratio of weekday items |
| dayTextStyle | TextStyle | Theme.of(context).textTheme.bodyText1 | The label text style of day |
| dayAspectRatio | double | 1.0 | The aspect ratio of day items |
| daySelectedBackgroundColor | Color | Theme.of(context).colorScheme.primary | The day selected background color |
| dayBackgroundColor | Color | Theme.of(context).colorScheme.surface | The day background color |
| daySelectedBackgroundColorBetween | Color | Theme.of(context).colorScheme.primary.withOpacity(.3) | The day selected background color that is between day selected edges |
| dayDisableBackgroundColor | Color | Theme.of(context).colorScheme.surface.withOpacity(.4) | The day disable background color |
| dayDisableColor | Color | Theme.of(context).colorScheme.onSurface.withOpacity(.5) | The day disable color |
| dayRadius | double | 6 | The radius of day items |
| monthBuilder | Widget Function(BuildContext context, String month) | null | A builder to make a customized month |
| weekdayBuilder | Widget Function(BuildContext context, String weekday) | null | A builder to make a customized weekday |
| dayBuilder | Widget Function(BuildContext context, DayValues values) | null | A builder to make a customized day of calendar |
| Parameter | Type | Default | Description |
|---|---|---|---|
| minDate | DateTime | required | Obrigatory: The mininimum date to show |
| maxDate | DateTime | required | Obrigatory: The maximum date to show |
| initialDateSelected | DateTime | null | An initial selected date |
| endDateSelected | DateTime | null | The end of selected range |
| weekdayStart | int | DateTime.monday | In what weekday position the calendar is going to start |
| onDayTapped | Function(DateTime date) | null | Function when a day is tapped |
| onRangeSelected | Function(DateTime minDate, DateTime? maxDate) | null | Function when a range is selected |
| onPreviousMinDateTapped | Function(DateTime date) | null | When a date before the min date is tapped |
| onAfterMaxDateTapped | Function(DateTime date) | null | When a date after max date is tapped |
| rangeMode | bool | true | If the range is enabled |
| readOnly | bool | false | If the Calendar Widget is on read-only mode |
ScrollableCleanCalendar(
calendarController: calendarController,
layout: Layout.DEFAULT,
),
ScrollableCleanCalendar(
calendarController: calendarController,
layout: Layout.BEAUTY,
calendarCrossAxisSpacing: 0,
),
依赖清单 2 项
any^0.3.8