These tools are under active development in Drupal 8. This documentation page may be out of date
Announce page updates aurally
Many page updates are expressed visually through color changes and animations. In order to make page updates apparent in a non-visual way, Drupal provides the
aria-live element on the page. Text appended to this node is read by a screen-reading user agent.
Drupal.announce accepts a string to be read by an audio UA. You can also set a second parameter: the priority. Here are a couple examples:
Drupal.announce('Entering edit mode');
Drupal.announce('Please fill in your user name', 'assertive');
Drupal.announce('You look beautiful today.');
The two accepted priority values are
polite is the default.