Changeset 64282 for trunk/src/wp-includes/functions.php

Timestamp:

10/10/2026 02:18:37 PM (3 days ago)

Author:

joedolson

Message:

Admin: Admin notice accessibility improvements.

Capture all admin notices with message content generated via wp_get_admin_notices(). Wrap all captured notices inside an aside so notices are identified within a navigable landmark. Add information about the number of notices produced on a page in the title element of the page.

Ensures users have awareness on page entry whether there are notices present, how many there are, and provides screen readers with a mechanism to locate them as a group. Inline notices are counted in the total, but not contained within the landmark.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/13671.

Props afercia, psykro, ryokuhi, raaaahman, alexstine, sergeybiryukov, oglekler, marybaum, swissspidy, davidbaumwald, sanket.parmar, sabernhardt, peterwilsoncc, williampatton, im3dabasia1, audrasjb, khokansardar, ugyensupport, joedolson.
Fixes #50486.

File:

• trunk/src/wp-includes/functions.php (modified) (2 diffs)

trunk/src/wp-includes/functions.php

@@ -9343 +9343 @@
         $args = apply_filters( 'wp_admin_notice_args', $args, $message );
 
+        // Unique ID is intended for internal use, and is not a filterable argument.
+        $unique_id         = wp_unique_prefixed_id( 'wp-admin-notice-' );
+        $args['notice_id'] = $unique_id;
+
         $wrap_with_p  = false !== $args['paragraph_wrap'];
         $wrap_opener  = $wrap_with_p ? '<p>' : '';
@@ -9352 +9356 @@
                 $trimmed_id = trim( $args['id'] );
 
+                $html_builder->set_attribute( 'data-id', $unique_id );
                 if ( '' !== $trimmed_id ) {
                         $html_builder->set_attribute( 'id', $trimmed_id );
-                }
+                } else {
+                        $html_builder->set_attribute( 'id', $unique_id );
+                }
+        } else {
+                $html_builder->set_attribute( 'data-id', $unique_id );
+                $html_builder->set_attribute( 'id', $unique_id );
         }