6.3.0

Author: Macacoazul01

CHANGELOG.md

@@ -1,3 +1,6 @@
+## 6.3.0 - 2025-07-04
+- Added `onYearSelected` and `onMonthSelected` functions to provide a callback after the user selects a value.
+
 ## 6.2.5 - 2025-07-04
 - Added copyWith Method to picker settings. Tks [nomoruyi](https://github.com/nomoruyi).
 

example/lib/main.dart

@@ -205,6 +205,12 @@ class _MyAppState extends State<MyApp> {
         ),
       ),
       rangeList: true,
+      onMonthSelected: (DateTime date) {
+        print('Selected month: ${date.toIso8601String()}');
+      },
+      onYearSelected: (int date) {
+        print('Selected year: $date');
+      },
     ).then((List<DateTime>? dates) {
       if (dates != null && dates.isNotEmpty) {
         setState(() {

lib/src/month_picker_dialog.dart

@@ -201,7 +201,7 @@ class MonthPickerDialogState extends State<MonthPickerDialog> {
         );
       },
     );
-    if (widget.controller.onYearSelected != null) {
+    if (widget.controller.onMonthSelected != null) {
       widget.controller.onMonthSelected!(date);
     }
   }

lib/src/pickers/show_month_picker.dart

@@ -1,5 +1,3 @@
-//TODO let the user pass a custom controller to the dialog
-//TODO remake the controller docs
 import 'package:flutter/material.dart';
 import 'package:provider/provider.dart';
 
@@ -27,6 +25,10 @@ import '/month_picker_dialog.dart';
 ///
 /// `onlyYear:` Displays only year picker dialog. Prefer to use `showYearPicker` instead of `showMonthPicker` with this parameter set to `true` to avoid unnecessary parameters.
 ///
+/// `onYearSelected:` the function that triggers after the user selected an year (default is `null`).
+///
+/// `onMonthSelected:` the function that triggers after the user selected a month (default is `null`).
+///
 Future<DateTime?> showMonthPicker({
   required BuildContext context,
   DateTime? initialDate,
@@ -40,22 +42,25 @@ Future<DateTime?> showMonthPicker({
   MonthPickerDialogSettings monthPickerDialogSettings =
       defaultMonthPickerDialogSettings,
   bool onlyYear = false,
+  Function(DateTime)? onMonthSelected,
+  Function(int)? onYearSelected,
 }) async {
   final ThemeData theme = Theme.of(context);
   final MonthpickerController controller = MonthpickerController(
-    initialDate: initialDate,
-    firstDate: firstDate,
-    lastDate: lastDate,
-    monthPickerDialogSettings: monthPickerDialogSettings,
-    selectableMonthPredicate: selectableMonthPredicate,
-    selectableYearPredicate: selectableYearPredicate,
-    monthStylePredicate: monthStylePredicate,
-    yearStylePredicate: yearStylePredicate,
-    theme: theme,
-    useMaterial3: theme.useMaterial3,
-    headerTitle: headerTitle,
-    onlyYear: onlyYear,
-  );
+      initialDate: initialDate,
+      firstDate: firstDate,
+      lastDate: lastDate,
+      monthPickerDialogSettings: monthPickerDialogSettings,
+      selectableMonthPredicate: selectableMonthPredicate,
+      selectableYearPredicate: selectableYearPredicate,
+      monthStylePredicate: monthStylePredicate,
+      yearStylePredicate: yearStylePredicate,
+      theme: theme,
+      useMaterial3: theme.useMaterial3,
+      headerTitle: headerTitle,
+      onlyYear: onlyYear,
+      onMonthSelected: onMonthSelected,
+      onYearSelected: onYearSelected);
   controller.initialize();
   final DateTime? dialogDate = await showDialog<DateTime?>(
     context: context,

lib/src/pickers/show_month_range_picker.dart

@@ -27,6 +27,10 @@ import '/month_picker_dialog.dart';
 ///
 /// `rangeList:` defines if the controller will return the full list of months between the two selected or only them (default is `false`).
 ///
+/// `onYearSelected:` the function that triggers after the user selected an year (default is `null`).
+///
+/// `onMonthSelected:` the function that triggers after the user selected a month (default is `null`).
+///
 Future<List<DateTime>?> showMonthRangePicker({
   required BuildContext context,
   DateTime? initialRangeDate,
@@ -39,26 +43,29 @@ Future<List<DateTime>?> showMonthRangePicker({
   ButtonStyle? Function(int)? yearStylePredicate,
   Widget? headerTitle,
   bool rangeList = false,
+  Function(DateTime)? onMonthSelected,
+  Function(int)? onYearSelected,
   MonthPickerDialogSettings monthPickerDialogSettings =
       defaultMonthPickerDialogSettings,
 }) async {
   final ThemeData theme = Theme.of(context);
   final MonthpickerController controller = MonthpickerController(
-    initialRangeDate: initialRangeDate.firstDayOfMonth(),
-    endRangeDate: endRangeDate.firstDayOfMonth(),
-    firstDate: firstDate,
-    lastDate: lastDate,
-    selectableMonthPredicate: selectableMonthPredicate,
-    selectableYearPredicate: selectableYearPredicate,
-    monthStylePredicate: monthStylePredicate,
-    yearStylePredicate: yearStylePredicate,
-    theme: theme,
-    useMaterial3: theme.useMaterial3,
-    headerTitle: headerTitle,
-    rangeMode: true,
-    rangeList: rangeList,
-    monthPickerDialogSettings: monthPickerDialogSettings,
-  );
+      initialRangeDate: initialRangeDate.firstDayOfMonth(),
+      endRangeDate: endRangeDate.firstDayOfMonth(),
+      firstDate: firstDate,
+      lastDate: lastDate,
+      selectableMonthPredicate: selectableMonthPredicate,
+      selectableYearPredicate: selectableYearPredicate,
+      monthStylePredicate: monthStylePredicate,
+      yearStylePredicate: yearStylePredicate,
+      theme: theme,
+      useMaterial3: theme.useMaterial3,
+      headerTitle: headerTitle,
+      rangeMode: true,
+      rangeList: rangeList,
+      monthPickerDialogSettings: monthPickerDialogSettings,
+      onMonthSelected: onMonthSelected,
+      onYearSelected: onYearSelected);
   controller.initialize();
   final List<DateTime>? dialogDate = await showDialog<List<DateTime>>(
     context: context,

lib/src/pickers/show_year_picker.dart

@@ -18,6 +18,8 @@ import '/month_picker_dialog.dart';
 ///
 /// `monthPickerDialogSettings:` holds all the style of the picker dialog (default is `defaultMonthPickerDialogSettings`).
 ///
+/// `onYearSelected:` the function that triggers after the user selected an year (default is `null`).
+///
 Future<int?> showYearPicker({
   required BuildContext context,
   DateTime? initialDate,
@@ -28,18 +30,19 @@ Future<int?> showYearPicker({
   Widget? headerTitle,
   MonthPickerDialogSettings monthPickerDialogSettings =
       defaultMonthPickerDialogSettings,
+  Function(int)? onYearSelected,
 }) async {
   final DateTime? monthPickerDate = await showMonthPicker(
-    context: context,
-    initialDate: initialDate,
-    firstDate: firstDate,
-    lastDate: lastDate,
-    selectableYearPredicate: selectableYearPredicate,
-    yearStylePredicate: yearStylePredicate,
-    headerTitle: headerTitle,
-    monthPickerDialogSettings: monthPickerDialogSettings,
-    onlyYear: true,
-  );
+      context: context,
+      initialDate: initialDate,
+      firstDate: firstDate,
+      lastDate: lastDate,
+      selectableYearPredicate: selectableYearPredicate,
+      yearStylePredicate: yearStylePredicate,
+      headerTitle: headerTitle,
+      monthPickerDialogSettings: monthPickerDialogSettings,
+      onlyYear: true,
+      onYearSelected: onYearSelected);
 
   return monthPickerDate?.year;
 }

pubspec.yaml

@@ -1,6 +1,6 @@
 name: month_picker_dialog
 description: Internationalized dialog for picking a single month from an infinite list of years.
-version: 6.2.5
+version: 6.3.0
 homepage: https://github.com/Macacoazul01/month_picker_dialog
 
 environment: