mirror of
https://github.com/WordPress/WordPress.git
synced 2024-11-03 01:09:39 +01:00
8a23b80b56
Improve JS parsing of our inline JSDocs by introducing `@namespace`, `@lends` and `@memberOf`. Helps set the way for showing our JavaScript documentation on developer.wordpress.org, see https://meta.trac.wordpress.org/ticket/3063. * Define all used namespaces using @namespace. * Correctly specify in which namespace each class is using @memberOf. * Define each usage of the extend function as a prototype assignment using @lends. * Some comment blocks were moved to correct the parsing of certain definitions. Props herregroen, atimmer, netweb, SergeyBiryukov. Fixes #41682. Built from https://develop.svn.wordpress.org/trunk@41351 git-svn-id: http://core.svn.wordpress.org/trunk@41184 1a063a9b-81f0-0310-95a4-ce76da25c4cd
103 lines
2.5 KiB
JavaScript
103 lines
2.5 KiB
JavaScript
/** @namespace wp */
|
|
window.wp = window.wp || {};
|
|
|
|
( function ( wp, $ ) {
|
|
'use strict';
|
|
|
|
var $containerPolite,
|
|
$containerAssertive,
|
|
previousMessage = '';
|
|
|
|
/**
|
|
* Update the ARIA live notification area text node.
|
|
*
|
|
* @since 4.2.0
|
|
* @since 4.3.0 Introduced the 'ariaLive' argument.
|
|
*
|
|
* @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, ariaLive ) {
|
|
// Clear previous messages to allow repeated strings being read out.
|
|
clear();
|
|
|
|
// Ensure only text is sent to screen readers.
|
|
message = $( '<p>' ).html( message ).text();
|
|
|
|
/*
|
|
* Safari 10+VoiceOver don't announce repeated, identical strings. We use
|
|
* a `no-break space` to force them to think identical strings are different.
|
|
* See ticket #36853.
|
|
*/
|
|
if ( previousMessage === message ) {
|
|
message = message + '\u00A0';
|
|
}
|
|
|
|
previousMessage = message;
|
|
|
|
if ( $containerAssertive && 'assertive' === ariaLive ) {
|
|
$containerAssertive.text( message );
|
|
} else if ( $containerPolite ) {
|
|
$containerPolite.text( message );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Build the live regions markup.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param {String} ariaLive Optional. Value for the 'aria-live' attribute, default 'polite'.
|
|
*
|
|
* @return {Object} $container The ARIA live region jQuery object.
|
|
*/
|
|
function addContainer( ariaLive ) {
|
|
ariaLive = ariaLive || 'polite';
|
|
|
|
var $container = $( '<div>', {
|
|
'id': 'wp-a11y-speak-' + ariaLive,
|
|
'aria-live': ariaLive,
|
|
'aria-relevant': 'additions text',
|
|
'aria-atomic': 'true',
|
|
'class': 'screen-reader-text wp-a11y-speak-region'
|
|
});
|
|
|
|
$( document.body ).append( $container );
|
|
return $container;
|
|
}
|
|
|
|
/**
|
|
* Clear the live regions.
|
|
*
|
|
* @since 4.3.0
|
|
*/
|
|
function clear() {
|
|
$( '.wp-a11y-speak-region' ).text( '' );
|
|
}
|
|
|
|
/**
|
|
* Initialize wp.a11y and define ARIA live notification area.
|
|
*
|
|
* @since 4.2.0
|
|
* @since 4.3.0 Added the assertive live region.
|
|
*/
|
|
$( document ).ready( function() {
|
|
$containerPolite = $( '#wp-a11y-speak-polite' );
|
|
$containerAssertive = $( '#wp-a11y-speak-assertive' );
|
|
|
|
if ( ! $containerPolite.length ) {
|
|
$containerPolite = addContainer( 'polite' );
|
|
}
|
|
|
|
if ( ! $containerAssertive.length ) {
|
|
$containerAssertive = addContainer( 'assertive' );
|
|
}
|
|
});
|
|
|
|
/** @namespace wp.a11y */
|
|
wp.a11y = wp.a11y || {};
|
|
wp.a11y.speak = speak;
|
|
|
|
}( window.wp, window.jQuery ));
|