CalendarDatePicker constructor Null safety
- {Key? key,
- required DateTime initialDate,
- required DateTime firstDate,
- required DateTime lastDate,
- DateTime? currentDate,
- required ValueChanged<
DateTime> onDateChanged, - ValueChanged<
DateTime> ? onDisplayedMonthChanged, - DatePickerMode initialCalendarMode = DatePickerMode.day,
- SelectableDayPredicate? selectableDayPredicate}
Creates a calendar date picker.
It will display a grid of days for the initialDate
's month. The day
indicated by initialDate
will be selected.
The optional onDisplayedMonthChanged callback can be used to track the currently displayed month.
The user interface provides a way to change the year of the month being displayed. By default it will show the day grid, but this can be changed to start in the year selection interface with initialCalendarMode set to DatePickerMode.year.
The initialDate
, firstDate
, lastDate
, onDateChanged, and
initialCalendarMode must be non-null.
lastDate
must be after or equal to firstDate
.
initialDate
must be between firstDate
and lastDate
or equal to
one of them.
currentDate
represents the current day (i.e. today). This
date will be highlighted in the day grid. If null, the date of
DateTime.now()
will be used.
If selectableDayPredicate is non-null, it must return true
for the
initialDate
.
Implementation
CalendarDatePicker({
super.key,
required DateTime initialDate,
required DateTime firstDate,
required DateTime lastDate,
DateTime? currentDate,
required this.onDateChanged,
this.onDisplayedMonthChanged,
this.initialCalendarMode = DatePickerMode.day,
this.selectableDayPredicate,
}) : assert(initialDate != null),
assert(firstDate != null),
assert(lastDate != null),
initialDate = DateUtils.dateOnly(initialDate),
firstDate = DateUtils.dateOnly(firstDate),
lastDate = DateUtils.dateOnly(lastDate),
currentDate = DateUtils.dateOnly(currentDate ?? DateTime.now()),
assert(onDateChanged != null),
assert(initialCalendarMode != null) {
assert(
!this.lastDate.isBefore(this.firstDate),
'lastDate ${this.lastDate} must be on or after firstDate ${this.firstDate}.',
);
assert(
!this.initialDate.isBefore(this.firstDate),
'initialDate ${this.initialDate} must be on or after firstDate ${this.firstDate}.',
);
assert(
!this.initialDate.isAfter(this.lastDate),
'initialDate ${this.initialDate} must be on or before lastDate ${this.lastDate}.',
);
assert(
selectableDayPredicate == null || selectableDayPredicate!(this.initialDate),
'Provided initialDate ${this.initialDate} must satisfy provided selectableDayPredicate.',
);
}