Changeset 53913 for trunk/src/wp-includes/category-template.php

Timestamp:

08/19/2022 11:04:04 PM (3 years ago)

Author:

joedolson

Message:

Taxonomy: Associate field descriptions with fields.

Use aria-describedby to associate the field descriptions and instructions with the form fields when creating or editing taxonomy terms.

Props afercia.
Fixes #55651.

File:

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

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

@@ -301 +301 @@
  * @since 4.2.0 Introduced the `value_field` argument.
  * @since 4.6.0 Introduced the `required` argument.
+ * @since 6.1.0 Introduced the `aria_describedby` argument.
  *
  * @param array|string $args {
@@ -336 +337 @@
  *     @type Walker       $walker            Walker object to use to build the output. Default empty which results in a
  *                                           Walker_CategoryDropdown instance being used.
+ *     @type string       $aria_describedby  The 'id' of an element that contains descriptive text for the select.
+ *                                           Default empty string.
  * }
  * @return string HTML dropdown list of categories.
@@ -362 +365 @@
         'value_field'       => 'term_id',
         'required'          => false,
+        'aria_describedby'  => '',
     );
 
@@ -407 +411 @@
     $required = $parsed_args['required'] ? 'required' : '';
 
+    $aria_describedby_attribute = $parsed_args['aria_describedby'] ? ' aria-describedby="' . esc_attr( $parsed_args['aria_describedby'] ) . '"' : '';
+
     if ( ! $parsed_args['hide_if_empty'] || ! empty( $categories ) ) {
-        $output = "<select $required name='$name' id='$id' class='$class' $tab_index_attribute>\n";
+        $output = "<select $required name='$name' id='$id' class='$class'$tab_index_attribute$aria_describedby_attribute>\n";
     } else {
         $output = '';