Changeset 59988

Timestamp:

03/16/2025 07:38:42 PM (6 weeks ago)

Author:

joedolson

Message:

A11y: Add spoken notice when screen options are saved on change.

When some screen option input fields are changed (post table columns, welcome panel, and metabox visibility), the change is saved to options. Other screen options (e.g. number of items per page) are only saved on submit. The changes that are saved immediately are visibly changed for sighted readers immediately. Change adds a wp.a11y.speak() call to inform screen readers that a value change has updated screen options.

Props kkmuffme, joedolson, yogeshbhutkar, audrasjb, sourabhjain.
Fixes #62550.

Location:

trunk/src/js/_enqueues

Files:

• admin/common.js (modified) (1 diff)
• admin/postbox.js (modified) (1 diff)
• wp/dashboard.js (modified) (1 diff)

trunk/src/js/_enqueues/admin/common.js

@@ -420 +420 @@
     saveManageColumnsState : function() {
         var hidden = this.hidden();
-        $.post(ajaxurl, {
-            action: 'hidden-columns',
-            hidden: hidden,
-            screenoptionnonce: $('#screenoptionnonce').val(),
-            page: pagenow
-        });
+        $.post(
+            ajaxurl,
+            {
+                action: 'hidden-columns',
+                hidden: hidden,
+                screenoptionnonce: $('#screenoptionnonce').val(),
+                page: pagenow
+            },
+            function() {
+                wp.a11y.speak( __( 'Screen Options updated.' ) );
+            }
+        );
     },
 

trunk/src/js/_enqueues/admin/postbox.js

@@ -462 +462 @@
             hidden = $( '.postbox' ).filter( ':hidden' ).map( function() { return this.id; } ).get().join( ',' );
 
-            $.post(ajaxurl, {
-                action: 'closed-postboxes',
-                closed: closed,
-                hidden: hidden,
-                closedpostboxesnonce: jQuery('#closedpostboxesnonce').val(),
-                page: page
-            });
+            $.post(
+                ajaxurl,
+                {
+                    action: 'closed-postboxes',
+                    closed: closed,
+                    hidden: hidden,
+                    closedpostboxesnonce: jQuery('#closedpostboxesnonce').val(),
+                    page: page
+                },
+                function() {
+                    wp.a11y.speak( __( 'Screen Options updated.' ) );
+                }
+            );
         },
 

trunk/src/js/_enqueues/wp/dashboard.js

@@ -28 +28 @@
      */
     updateWelcomePanel = function( visible ) {
-        $.post( ajaxurl, {
-            action: 'update-welcome-panel',
-            visible: visible,
-            welcomepanelnonce: $( '#welcomepanelnonce' ).val()
-        });
+        $.post(
+            ajaxurl,
+            {
+                action: 'update-welcome-panel',
+                visible: visible,
+                welcomepanelnonce: $( '#welcomepanelnonce' ).val()
+            },
+            function() {
+                wp.a11y.speak( wp.i18n.__( 'Screen Options updated.' ) );
+            }
+        );
     };