Skip to content

Commit

Permalink
Read Me First section: Suggested Editorial Changes
Browse files Browse the repository at this point in the history
Based on feedback from @accdc and @devarshipant in issue #482,
modified aria-practices.html:
* Wording of comparison of CSS and ARIA
* aria-label content for example link code
* Label of toggle button code
  • Loading branch information
mcking65 committed Oct 28, 2017
1 parent c99876a commit 0ef198f
Showing 1 changed file with 5 additions and 5 deletions.
10 changes: 5 additions & 5 deletions aria-practices.html
Original file line number Diff line number Diff line change
Expand Up @@ -89,9 +89,9 @@ <h2>Read Me First</h2>
<section id="no_aria_better_bad_aria">
<h3>No ARIA is better than Bad ARIA</h3>
<p>
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 visual experiences, with potentially devastating effects on the corresponding non-visual experiences.
Functionally, ARIA roles, states, and properties are analogous to a CSS for assistive technologies.
For screen reader users, ARIA controls the rendering of their non-visual experience.
Incorrect ARIA misrepresents visual experiences, with potentially devastating effects on their corresponding non-visual experiences.
</p>
<p>Before using ARIA or any of the guidance in this document, please take time to understand the following two essential principles.</p>
<h4>Principal 1: A role is a promise</h4>
Expand All @@ -113,11 +113,11 @@ <h4>Principle 2: ARIA Can Both Cloak and Enhance, Creating Both Power and Danger
<p>Some of ARIA is like a cloak; it covers up, or overrides, the original semantics or content.</p>
<pre><code>
&lt;a role=&quot;menuitem&quot;&gt;Assistive tech users perceive this element as an item in a menu, not a link.&lt;/a&gt;
&lt;a aria-label=&quot;Assistive tech users perceive this aria-label, not the link text&quot;&gt;Link Text&lt;/a&gt;
&lt;a aria-label=&quot;Assistive tech users can only perceive the contents of this aria-label, not the link text&quot;&gt;Link Text&lt;/a&gt;
</code></pre>
<p>On the other hand, some uses of ARIA are more like suspenders or belts; they add meaning that provides essential support to the original content.</p>
<pre><code>
&lt;button aria-pressed=&quot;false&quot;&gt;Press Me&lt;/button&gt;
&lt;button aria-pressed=&quot;false&quot;&gt;Mute&lt;/button&gt;
</code></pre>
<p>
This is the power of ARIA.
Expand Down

0 comments on commit 0ef198f

Please sign in to comment.