diff --git a/aria-practices.html b/aria-practices.html index 6a172e088b..fdf96615f8 100644 --- a/aria-practices.html +++ b/aria-practices.html @@ -86,7 +86,7 @@

No ARIA is better than Bad ARIA

Functionally, ARIA roles, states, and properties are sort of like CSS for assistive technologies. In the case of screen readers, ARIA controls the rendering of the non-visual experience. - Incorrect ARIA misrepresents the visual experience, with potentially devastating effects on non-visual experiences. + Incorrect ARIA misrepresents visual experiences, with potentially devastating effects on the corresponding non-visual experiences.

Before using ARIA or any of the guidance in this document, please take time to understand the following two essential principles.

Principal 1: A role is a promise

@@ -102,10 +102,10 @@

Principal 1: A role is a promise

One of the objectives of this guide is to define expected behaviors for each ARIA role.

Principle 2: ARIA Can Both Cloak and Enhance, Creating Both Power and Danger

- From the perspective of assistive technologies, ARIA gives authors the ability to dress up HTML and SVG elements to describe critical aspects of meaning and purpose that assistive technologies would not otherwise be able to reliably derive. The information assistive technologies need about the meaning and purpose of user interface elements is called accessibility semantics. + From the perspective of assistive technologies, ARIA gives authors the ability to dress up HTML and SVG elements with critical accessibility semantics that the assistive technologies would not otherwise be able to reliably derive.

-

Some of ARIA is like a dress or cloak; it covers up, or overrides, the original semantics or content.

+

Some of ARIA is like a cloak; it covers up, or overrides, the original semantics or content.


         <a role="menuitem">Assistive tech users perceive this element as an item in a menu, not a link.</a>
         <a aria-label="Assistive tech users perceive this aria-label, not the link text">Link Text</a>
@@ -143,8 +143,8 @@ 

Principle 2: ARIA Can Both Cloak and Enhance, Creating Both Power and Danger

Browser and Assistive Technology Support

This guide illustrates appropriate use of ARIA 1.1 as defined in the ARIA specification. - The design patterns, reference examples, and sample code intentionally do not implement code that fixes problems caused by gaps in support for ARIA 1.1 in browsers or assistive technologies. - This approach enables both browser and assistive technology developers to utilize code in the guide as references for test cases to assess the quality of their support for ARIA 1.1. + The design patterns, reference examples, and sample code intentionally do not implement code to fix problems that are caused by gaps in support for ARIA 1.1 in browsers or assistive technologies. + Browser and assistive technology developers can thus utilize code in this guide to help assess the quality of their support for ARIA 1.1.

Similarly, JavaScript and CSS in this guide is written to be compatible with the most recent version of Chrome, Firefox, Internet Explorer, and Safari at the time of writing. @@ -152,7 +152,7 @@

Browser and Assistive Technology Support

In other words, except in cases where the ARIA Working Group and other contributors have overlooked an error, - examples that do not function well in a particular browser or with a specific assistive technology are demonstrating a lack of ARIA support and can be referenced in a bug report to its developer. + examples in this guide that do not function well in a particular browser or with a specific assistive technology are demonstrating browser or assistive technology bugs.