Merge pull request #127 from gabrielezereik/fix/accessibility-labels

Fix/accessibility labels

Author: Macacoazul01

CHANGELOG.md

@@ -1,3 +1,6 @@
+## 6.7.2 - 2026-02-26
+- Added semantics support (`previousButtonSemanticsLabel`, `nextButtonSemanticsLabel`) to header navigation arrows via `PickerHeaderSettings`.
+
 ## 6.7.1 - 2026-01-19
 - Added operation order fix from [Jerrywell](https://github.com/jerrywellcake) fork.
 

lib/src/helpers/settings/header_settings.dart

@@ -16,6 +16,8 @@ class PickerHeaderSettings {
     this.headerPadding = const EdgeInsets.all(16.0),
     this.arrowAlpha = 0.5,
     this.headerAlignment = CrossAxisAlignment.start,
+    this.previousButtonSemanticsLabel,
+    this.nextButtonSemanticsLabel,
   });
 
   /// Hides the row with the arrows + years/months page range from the header, forcing the user to scroll to change the page.
@@ -85,6 +87,16 @@ class PickerHeaderSettings {
   /// default: `CrossAxisAlignment.start`
   final CrossAxisAlignment headerAlignment;
 
+  /// The semantics label of the previous button.
+  ///
+  /// default: `null`
+  final String? previousButtonSemanticsLabel;
+
+  /// The semantics label of the next button.
+  ///
+  /// default: `null`
+  final String? nextButtonSemanticsLabel;
+
   PickerHeaderSettings copyWith({
     bool? hideHeaderRow,
     bool? hideHeaderArrows,

lib/src/month_picker_widgets/header/header_arrows.dart

@@ -14,6 +14,8 @@ class HeaderArrows extends StatelessWidget {
     this.nextIcon,
     required this.arrowAlpha,
     required this.verticalScrolling,
+    this.previousButtonSemanticsLabel,
+    this.nextButtonSemanticsLabel,
   });
   final Color? arrowcolors;
   final double? arrowSize;
@@ -23,37 +25,51 @@ class HeaderArrows extends StatelessWidget {
   final IconData? previousIcon;
   final IconData? nextIcon;
   final bool verticalScrolling;
+  final String? previousButtonSemanticsLabel;
+  final String? nextButtonSemanticsLabel;
 
   @override
   Widget build(BuildContext context) {
     return Row(
       mainAxisSize: MainAxisSize.min,
       children: <Widget>[
-        IconButton(
-          icon: Icon(
-            previousIcon ??
-                (verticalScrolling
-                    ? Icons.keyboard_arrow_up
-                    : Icons.keyboard_arrow_left),
-            color: upState
-                ? arrowcolors
-                : arrowcolors!.withValues(alpha: arrowAlpha),
-            size: arrowSize,
+        Semantics(
+          label: previousButtonSemanticsLabel ??
+              MaterialLocalizations.of(context).previousMonthTooltip,
+          button: true,
+          excludeSemantics: true,
+          child: IconButton(
+            icon: Icon(
+              previousIcon ??
+                  (verticalScrolling
+                      ? Icons.keyboard_arrow_up
+                      : Icons.keyboard_arrow_left),
+              color: upState
+                  ? arrowcolors
+                  : arrowcolors!.withValues(alpha: arrowAlpha),
+              size: arrowSize,
+            ),
+            onPressed: upState ? onUpButtonPressed : null,
           ),
-          onPressed: upState ? onUpButtonPressed : null,
         ),
-        IconButton(
-          icon: Icon(
-            nextIcon ??
-                (verticalScrolling
-                    ? Icons.keyboard_arrow_down
-                    : Icons.keyboard_arrow_right),
-            color: downState
-                ? arrowcolors
-                : arrowcolors!.withValues(alpha: arrowAlpha),
-            size: arrowSize,
+        Semantics(
+          label: nextButtonSemanticsLabel ??
+              MaterialLocalizations.of(context).nextMonthTooltip,
+          button: true,
+          excludeSemantics: true,
+          child: IconButton(
+            icon: Icon(
+              nextIcon ??
+                  (verticalScrolling
+                      ? Icons.keyboard_arrow_down
+                      : Icons.keyboard_arrow_right),
+              color: downState
+                  ? arrowcolors
+                  : arrowcolors!.withValues(alpha: arrowAlpha),
+              size: arrowSize,
+            ),
+            onPressed: downState ? onDownButtonPressed : null,
           ),
-          onPressed: downState ? onDownButtonPressed : null,
         ),
       ],
     );

lib/src/month_picker_widgets/header/header_row.dart

@@ -79,6 +79,12 @@ class HeaderRow extends StatelessWidget {
                     .monthPickerDialogSettings.headerSettings.arrowAlpha,
                 verticalScrolling: controller
                     .monthPickerDialogSettings.dialogSettings.verticalScrolling,
+                previousButtonSemanticsLabel: controller
+                    .monthPickerDialogSettings
+                    .headerSettings
+                    .previousButtonSemanticsLabel,
+                nextButtonSemanticsLabel: controller.monthPickerDialogSettings
+                    .headerSettings.nextButtonSemanticsLabel,
               ),
           ]
         : <Widget>[

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.7.1
+version: 6.7.2
 homepage: https://github.com/Macacoazul01/month_picker_dialog
 
 environment: