Ticket #32600: 32600-alt.patch

src/wp-includes/js/wp-a11y.js

@@ -3 +3 @@
 ( function ( wp, $ ) {
         'use strict';
 
-        var $container;
+        var $container, $body;
 
         /**
          * Update the ARIA live notification area text node.
          *
          * @since 4.2.0
+         * @since 4.3.0 Introduced the 'ariaLive' argument.
          *
-         * @param {String} message
+         * @param {String} message  The message to be announced by Assistive Technologies.
+         * @param {String} ariaLive Optional. The politeness level for aria-live. Possible values:
+         *                            polite or assertive. Default polite.
          */
-        function speak( message ) {
-                if ( $container ) {
+        function speak( message, ariaLive ) {
+                // Clear previous messages to allow repeated strings being read out.
+                $container.text( '' );
+
+                ariaLive = ariaLive || 'polite';
+
+                if ( $container.attr( 'aria-live' ) !== ariaLive ) {
+                        $container.attr( 'aria-live', ariaLive );
+                        $body.append( $container );
+                }
+
+                window.setTimeout( function() {
                         $container.text( message );
-                }
+                }, 0 );
         }
 
         /**
@@ -25 +38 @@
          */
         $( document ).ready( function() {
                 $container = $( '#wp-a11y-speak' );
+                $body = $( document.body );
 
                 if ( ! $container.length ) {
                         $container = $( '<div>', {
@@ -31 +45 @@
                                 id: 'wp-a11y-speak',
                                 role: 'status',
                                 'aria-live': 'polite',
-                                'aria-relevant': 'all',
+                                'aria-relevant': 'additions text',
                                 'aria-atomic': 'true',
                                 'class': 'screen-reader-text'
-                        } );
-
-                        $( document.body ).append( $container );
+                        });
                 }
-        } );
 
+                $body.append( $container );
+        });
+
         wp.a11y = wp.a11y || {};
         wp.a11y.speak = speak;