year_month_picker
A Flutter package that enables users to select a year and month via a dialog or bottom sheet interface.
Installation
Add the following dependency to your pubspec.yaml
file:
dependencies:
year_month_picker: ^1.0.1
Then, run flutter pub get
to install the package.
Importing
Import the package in your Dart code where you want to use it:
import 'package:year_month_picker/year_month_picker.dart';
Usage
Show Year-Month Picker Dialog
Use showYearMonthPickerDialog
to display a dialog for selecting year and month:
import 'package:year_month_picker/year_month_picker.dart';
// ...existing code...
final selected = await showYearMonthPickerDialog(
context: context,
firstYear: 2000,
lastYear: 2100,
initialYearMonth: DateTime.now(),
);
// `selected` is a DateTime (year & month) or null if cancelled
Dialog Example:
Show Year-Month Picker Bottom Sheet
Use showYearMonthPickerBottomSheet
to display a bottom sheet picker:
import 'package:year_month_picker/year_month_picker.dart';
// ...existing code...
final selected = await showYearMonthPickerBottomSheet(
context: context,
firstYear: 2000,
lastYear: 2100,
initialYearMonth: DateTime.now(),
);
// `selected` is a DateTime (year & month) or null if cancelled
Bottom Sheet Example:
Customization
Both functions support various customization options:
yearItemBuilder
,monthItemBuilder
: Customize year/month item widgets.okButtonBuilder
,cancelButtonBuilder
: Customize action buttons.locale
,textDirection
: Localization and text direction support.onYearChanged
,onMonthChanged
: Callbacks for selection changes.
See the API documentation for all available parameters.
☕ Buy Me a Coffee
If you find this package useful, you can support me here: