Changeset 44957

Timestamp:

03/21/2019 10:36:22 AM (6 years ago)

Author:

SergeyBiryukov

Message:

Accessibility: Introduce category_list_link_attributes filter in Walker_Category::start_el() for the HTML attributes applied to a category list item's anchor element.

This complements the page_menu_link_attributes filter in Walker_Page::start_el() and the nav_menu_link_attributes filter in Walker_Nav_Menu::start_el().

Props pbiron, audrasjb, afercia.
Fixes #40666. See #40359.

File:

• trunk/src/wp-includes/class-walker-category.php (modified) (3 diffs)

trunk/src/wp-includes/class-walker-category.php

@@ -109 +109 @@
         }
 
-        $link = '<a href="' . esc_url( get_term_link( $category ) ) . '" ';
+        $atts         = array();
+        $atts['href'] = get_term_link( $category );
+
         if ( $args['use_desc_for_title'] && ! empty( $category->description ) ) {
             /**
@@ -119 +121 @@
              * @param object $category    Category object.
              */
-            $link .= 'title="' . esc_attr( strip_tags( apply_filters( 'category_description', $category->description, $category ) ) ) . '"';
-        }
-
-        $link .= '>';
-        $link .= $cat_name . '</a>';
+            $atts['title'] = strip_tags( apply_filters( 'category_description', $category->description, $category ) );
+        }
+
+        /**
+         * Filters the HTML attributes applied to a category list item's anchor element.
+         *
+         * @since 5.2.0
+         *
+         * @param array   $atts {
+         *     The HTML attributes applied to the list item's `<a>` element, empty strings are ignored.
+         *
+         *     @type string $href  The href attribute.
+         *     @type string $title The title attribute.
+         * }
+         * @param WP_Term $category Term data object.
+         * @param int     $depth    Depth of category, used for padding.
+         * @param array   $args     An array of arguments.
+         * @param int     $id       ID of the current category.
+         */
+        $atts = apply_filters( 'category_list_link_attributes', $atts, $category, $depth, $args, $id );
+
+        $attributes = '';
+        foreach ( $atts as $attr => $value ) {
+            if ( ! empty( $value ) ) {
+                $value       = ( 'href' === $attr ) ? esc_url( $value ) : esc_attr( $value );
+                $attributes .= ' ' . $attr . '="' . $value . '"';
+            }
+        }
+
+        $link = sprintf(
+            '<a%s>%s</a>',
+            $attributes,
+            $cat_name
+        );
 
         if ( ! empty( $args['feed_image'] ) || ! empty( $args['feed'] ) ) {
@@ -135 +166 @@
 
             if ( empty( $args['feed'] ) ) {
+                /* translators: %s: category name */
                 $alt = ' alt="' . sprintf( __( 'Feed for all posts filed under %s' ), $cat_name ) . '"';
             } else {