Skip to content

Commit

Permalink
Naming and Describing Section: Add guidance for blockquote, meter and…
Browse files Browse the repository at this point in the history
… time (pull #1231)

* Add naming guidance for blockquote, meter and time roles

Fixes #1212.

* Apply suggestions from code review

Co-Authored-By: Matt King <[email protected]>

* Change suggestion for blockquote; change time to Do Not Name

* Clarify what is not supported by ATs
Finish resolving #1077 by adding rows to the naming guidance by role table for blockquote, meter, and time.
  • Loading branch information
zcorpan authored and mcking65 committed Nov 6, 2019
1 parent 6ec616f commit 7cb6858
Showing 1 changed file with 26 additions and 2 deletions.
28 changes: 26 additions & 2 deletions aria-practices.html
Original file line number Diff line number Diff line change
Expand Up @@ -4276,6 +4276,13 @@ <h4><span id="naming_role_guidance_heading">Accessible Name Guidance by Role</sp
</ul>
</td>
</tr>
<tr>
<td><a href="#blockquote" class="role-reference"><code>blockquote</code></a></td>
<td>Discretionary</td>
<td>
If a visible label is present, associating it with the blockquote by using <code>aria-labelledby</code> could benefit some assistive technology users.
</td>
</tr>
<tr>
<td><a href="#button" class="role-reference"><code>button</code></a></td>
<td>Required <strong>Only If</strong> Content Insufficient</td>
Expand Down Expand Up @@ -4530,7 +4537,7 @@ <h4><span id="naming_role_guidance_heading">Accessible Name Guidance by Role</sp
<tr>
<td><a href="#listitem" class="role-reference"><code>listitem</code></a></td>
<td>Do Not Name</td>
<td>Not supported by assistive technologies; it is necessary to include relevant content within the list item.</td>
<td>Naming is not supported by assistive technologies; it is necessary to include relevant content within the list item.</td>
</tr>
<tr>
<td><a href="#log" class="role-reference"><code>log</code></a></td>
Expand Down Expand Up @@ -4629,6 +4636,17 @@ <h4><span id="naming_role_guidance_heading">Accessible Name Guidance by Role</sp
</ul>
</td>
</tr>
<tr>
<td><a href="#meter" class="role-reference"><code>meter</code></a></td>
<td>Required</td>
<td>
<ul>
<li>If based on an HTML <code>meter</code> element, can be named with an HTML <code>label</code> element.</li>
<li>Otherwise use <code>aria-labelledby</code> if a visible label is present.</li>
<li>Use <code>aria-label</code> if a visible label is not present.</li>
</ul>
</td>
</tr>
<tr>
<td><a href="#navigation" class="role-reference"><code>navigation</code></a></td>
<td>Recommended</td>
Expand Down Expand Up @@ -4736,7 +4754,7 @@ <h4><span id="naming_role_guidance_heading">Accessible Name Guidance by Role</sp
<tr>
<td><a href="#rowgroup" class="role-reference"><code>rowgroup</code></a></td>
<td>Do Not Name</td>
<td>Not supported by assistive technologies.</td>
<td>Naming is not supported by assistive technologies.</td>
</tr>
<tr>
<td><a href="#rowheader" class="role-reference"><code>rowheader</code></a></td>
Expand Down Expand Up @@ -4910,6 +4928,11 @@ <h4><span id="naming_role_guidance_heading">Accessible Name Guidance by Role</sp
</ul>
</td>
</tr>
<tr>
<td><a href="#time" class="role-reference"><code>time</code></a></td>
<td>Do Not Name</td>
<td>Naming is not supported by assistive technologies.</td>
</tr>
<tr>
<td><a href="#timer" class="role-reference"><code>timer</code></a></td>
<td>Discretionary</td>
Expand Down Expand Up @@ -6505,6 +6528,7 @@ <h2>Roles That Automatically Hide Semantics by Making Their Descendants Presenta
<li>button</li>
<li>checkbox</li>
<li>img</li>
<li>meter</li>
<li>math</li>
<li>menuitemcheckbox</li>
<li>menuitemradio</li>
Expand Down

0 comments on commit 7cb6858

Please sign in to comment.