custom_date_range_plus 0.0.3 copy "custom_date_range_plus: ^0.0.3" to clipboard
custom_date_range_plus: ^0.0.3 copied to clipboard

The custom date range picker is a highly customizable Flutter widget designed to simplify the process of selecting date ranges within your mobile applications.

Version License Pub Points Downloads

Custom Date Range Plus #

A customizable Flutter widget for selecting date ranges with additional UI elements such as buttons and dropdowns.

Features #

  • Select start and end dates within a given range.
  • Customize UI elements such as colors, text styles, and buttons.
  • Dropdown for month and year selection.
  • Reset and confirm action buttons with customizable appearance.
  • Weekday labels with customizable text styles.
  • Fully responsive UI.

Installation #

Add the following dependency to your pubspec.yaml:

dependencies:
  custom_date_range_plus: latest_version

Then, run:

flutter pub get

Usage #

Import the Package #

import 'package:custom_date_range_plus/custom_date_range_picker.dart';

Example Implementation #

DateRangePicker(
  startDate: DateTime.now().subtract(Duration(days: 7)),
  endDate: DateTime.now(),
  minDate: DateTime(2020, 1, 1),
  maxDate: DateTime(2030, 12, 31),
  onStartDateChanged: (date) => print("Start Date: \$date"),
  onEndDateChanged: (date) => print("End Date: \$date"),
  onDateRangeChanged: (range) => print("Selected Range: \${range?.start} - \${range?.end}"),
  selectedDateColor: Colors.blue,
  selectedDateTextColor: Colors.white,
  highlightColor: Colors.green,
  highlightTextColor: Colors.black,
  unselectedDateColor: Colors.grey,
  unselectedDateTextColor: Colors.black,
  weekDayTextStyle: TextStyle(fontWeight: FontWeight.bold),
  
  // Action Buttons
  onOutlinePressed: () => print("Reset Button Pressed"),
  onFilledPressed: () => print("Confirm Button Pressed"),
  filledColor: Colors.blue,
  outlinedColor: Colors.red,
  filledButtonText: "Confirm",
  outlinedButtonText: "Reset",
  
  // Dropdown Options
  dropDownHintText: "Select a Month",
  dropDownItems: ["January", "February", "March"],
  dropDownOnChanged: (value) => print("Selected Month: \$value"),
);

Parameters #

Date Selection #

Property Type Description
startDate DateTime? Initial start date
endDate DateTime? Initial end date
minDate DateTime? Minimum selectable date
maxDate DateTime? Maximum selectable date
onStartDateChanged ValueChanged<DateTime?>? Callback when start date changes
onEndDateChanged ValueChanged<DateTime?>? Callback when end date changes
onDateRangeChanged ValueChanged<DateTimeRange?>? Callback when date range changes

Styling #

Property Type Description
selectedDateColor Color? Color for selected dates
selectedDateTextColor Color? Text color for selected dates
highlightColor Color? Color for highlighted dates
highlightTextColor Color? Text color for highlighted dates
unselectedDateColor Color? Color for unselected dates
unselectedDateTextColor Color? Text color for unselected dates
weekDayTextStyle TextStyle? Text style for weekdays

Buttons #

Property Type Description
onOutlinePressed VoidCallback? Callback for outline button
onFilledPressed VoidCallback? Callback for filled button
filledColor Color? Filled button color
outlinedColor Color? Outline button color
filledButtonText String? Text for filled button
outlinedButtonText String? Text for outlined button
Property Type Description
dropDownHintText String? Hint text for dropdown
dropDownItems List<String>? List of dropdown options
dropDownOnChanged ValueChanged<String?>? Callback when dropdown value changes

Screenshots #

Screenshot 1 Screenshot 2 Screenshot 3
Screenshot 4 Screenshot 5 Screenshot 6
https://github.com/user-attachments/assets/d7c1b6a0-18e9-4569-90f9-efd5eb007f4c

License #

This package is open-source and licensed under the MIT License.

11
likes
150
points
35
downloads

Publisher

unverified uploader

Weekly Downloads

The custom date range picker is a highly customizable Flutter widget designed to simplify the process of selecting date ranges within your mobile applications.

Repository (GitHub)
View/report issues

Documentation

API reference

License

MIT (license)

Dependencies

flutter

More

Packages that depend on custom_date_range_plus