Changeset 59113

Timestamp:

09/28/2024 11:34:28 PM (2 weeks ago)

Author:

joedolson

Message:

Accessibility: Clarify aria-label in pagination links.

Change posts and comments pagination nav regions to have an aria-label of "Posts pagination" and "Comments pagination", respectively. This provides improved context for the numeric links contained within these regions and differentiates between posts navigation regions and posts pagination regions.

Props michaelbourne, sabernhardt, afercia, xyulex, webmandesign, tirth03, joedolson.
Fixes #54260.

File:

• trunk/src/wp-includes/link-template.php (modified) (4 diffs)

trunk/src/wp-includes/link-template.php

@@ -2932 +2932 @@
  *
  *     @type string $screen_reader_text Screen reader text for navigation element.
- *                                      Default 'Posts navigation'.
- *     @type string $aria_label         ARIA label text for the nav element. Default 'Posts'.
+ *                                      Default 'Posts pagination'.
+ *     @type string $aria_label         ARIA label text for the nav element. Default 'Posts pagination'.
  *     @type string $class              Custom class for the nav element. Default 'pagination'.
  * }
@@ -2956 +2956 @@
                 'prev_text'          => _x( 'Previous', 'previous set of posts' ),
                 'next_text'          => _x( 'Next', 'next set of posts' ),
-                'screen_reader_text' => __( 'Posts navigation' ),
-                'aria_label'         => __( 'Posts' ),
+                'screen_reader_text' => __( 'Posts pagination' ),
+                'aria_label'         => __( 'Posts pagination' ),
                 'class'              => 'pagination',
             )
@@ -3368 +3368 @@
  *     Optional. Default pagination arguments.
  *
- *     @type string $screen_reader_text Screen reader text for the nav element. Default 'Comments navigation'.
- *     @type string $aria_label         ARIA label text for the nav element. Default 'Comments'.
+ *     @type string $screen_reader_text Screen reader text for the nav element. Default 'Comments pagination'.
+ *     @type string $aria_label         ARIA label text for the nav element. Default 'Comments pagination'.
  *     @type string $class              Custom class for the nav element. Default 'comments-pagination'.
  * }
@@ -3385 +3385 @@
         $args,
         array(
-            'screen_reader_text' => __( 'Comments navigation' ),
-            'aria_label'         => __( 'Comments' ),
+            'screen_reader_text' => __( 'Comments pagination' ),
+            'aria_label'         => __( 'Comments pagination' ),
             'class'              => 'comments-pagination',
         )