ArnaCalendarDatePicker constructor

ArnaCalendarDatePicker({
  1. Key? key,
  2. required DateTime initialDate,
  3. required DateTime firstDate,
  4. required DateTime lastDate,
  5. DateTime? currentDate,
  6. required ValueChanged<DateTime> onDateChanged,
  7. ValueChanged<DateTime>? onDisplayedMonthChanged,
  8. ArnaDatePickerMode initialCalendarMode = ArnaDatePickerMode.day,
  9. ArnaSelectableDayPredicate? 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 ArnaDatePickerMode.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

ArnaCalendarDatePicker({
  super.key,
  required DateTime initialDate,
  required DateTime firstDate,
  required DateTime lastDate,
  DateTime? currentDate,
  required this.onDateChanged,
  this.onDisplayedMonthChanged,
  this.initialCalendarMode = ArnaDatePickerMode.day,
  this.selectableDayPredicate,
})  : initialDate = ArnaDateUtils.dateOnly(initialDate),
      firstDate = ArnaDateUtils.dateOnly(firstDate),
      lastDate = ArnaDateUtils.dateOnly(lastDate),
      currentDate = ArnaDateUtils.dateOnly(currentDate ?? DateTime.now()) {
  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.',
  );
}