GitHub

@@ -10641,11 +10641,17 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>

1064110641

<li>If the value of <code>aria-brailleroledescription</code> does not contain characters in <a>Unicode Braille Patterns</a>, translate the value according to the user's preferred translation table.</li>

1064210642

<li>Otherwise, pass the value to the user without translation.</li>

1064310643

</ol>

10644-

<p>The following example shows the use of <code>aria-brailleroledescription</code> to indicate that a button's description has a particular braille contraction.</p>

10645-

<pre class="example highlight">&lt;button aria-roledescription="planet" aria-brailleroledescription="pln" id="jupiter"&gt;

10646-

&lt;img alt="jupiter" src="images/jupiter.jpg"/&gt;

10647-

&lt;/button&gt;</pre>

10648-

<p>In the previous example, a braille display may display "pln Jupiter" in Braille rather than the verbose "planet Jupiter".</p>

10644+10645+

<p>The following two examples show the use of <code>aria-brailleroledescription</code> to abbreviate the role of a repeated non-interactive "slide" container in a web-based presentation application.</p>

10646+

<pre class="example highlight">&lt;div role="article" aria-roledescription="slide" aria-brailleroledescription="sld" id="slide" aria-labelledby="slideheading"&gt;

10647+

&lt;h1 id="slideheading">Quarterly Report&lt;/h1&gt;

10648+

&lt;!-- remaining slide contents --&gt;

10649+

&lt;/div&gt;</pre>

10650+

<pre class="example highlight">&lt;article aria-roledescription="slide" aria-brailleroledescription="sld" id="slide" aria-labelledby="slideheading"&gt;

10651+

&lt;h1 id="slideheading">Quarterly Report&lt;/h1&gt;

10652+

&lt;!-- remaining slide contents --&gt;

10653+

&lt;/div&gt;</pre>

10654+

<p>In the previous examples, a braille screen reader user may read "sld Quarterly Report" rather than the more verbose "slide Quarterly Report."</p>

1064910655

</div>

1065010656

<table class="property-features">

1065110657

<caption>Characteristics:</caption>

@@ -12696,15 +12702,15 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>

1269612702

</ol>

1269712703

<p><a>Assistive technologies</a> SHOULD use the value of <code>aria-roledescription</code> when presenting the role of an element, but SHOULD NOT change other functionality based on the role of an element that has a value for <code>aria-roledescription</code>. For example, an assistive technology that provides functions for navigating to the next <rref>region</rref> or <rref>button</rref> SHOULD allow those functions to navigate to regions and buttons that have an <code>aria-roledescription</code>.</p>

1269812704

<p>The following two examples show the use of <code>aria-roledescription</code> to indicate that a non-interactive container is a "slide" in a web-based presentation application.</p>

12699-

<pre class="example highlight">&lt;div role="region" aria-roledescription="slide" id="slide42" aria-labelledby="slide42heading"&gt;

12700-

&lt;h1 id="slide42heading">Quarterly Report&lt;/h1&gt;

12705+

<pre class="example highlight">&lt;div role="article" aria-roledescription="slide" id="slide" aria-labelledby="slideheading"&gt;

12706+

&lt;h1 id="slideheading">Quarterly Report&lt;/h1&gt;

1270112707

&lt;!-- remaining slide contents --&gt;

1270212708

&lt;/div&gt;</pre>

12703-

<pre class="example highlight">&lt;section aria-roledescription="slide" id="slide42" aria-labelledby="slide42heading"&gt;

12704-

&lt;h1 id="slide42heading">Quarterly Report&lt;/h1&gt;

12709+

<pre class="example highlight">&lt;article aria-roledescription="slide" id="slide" aria-labelledby="slideheading"&gt;

12710+

&lt;h1 id="slideheading">Quarterly Report&lt;/h1&gt;

1270512711

&lt;!-- remaining slide contents --&gt;

1270612712

&lt;/section&gt;</pre>

12707-

<p>In the previous examples, a screen reader user may hear "Quarterly Report, slide" rather than the more vague "Quarterly Report, region" or "Quarterly Report, group."</p>

12713+

<p>In the previous examples, a screen reader user may hear "Quarterly Report, slide" rather than the more vague "Quarterly Report, article" or "Quarterly Report, group."</p>

1270812714

</div>

1270912715

<table class="property-features">

1271012716

<caption>Characteristics:</caption>

Read the original on github.com ↗