Skip to content

Commit

Permalink
Accessible Name Guidance by Role Table: Advise that empty cells are r…
Browse files Browse the repository at this point in the history
…epresented by empty names (pull #1081)

* Add note to cell and gridcell guidance explaining that an empty name represents and empty cell.
* Add thead and tbody elements to name guidance by role table.
  • Loading branch information
mcking65 authored Jul 13, 2019
1 parent ea5f0c1 commit 37ec3a9
Showing 1 changed file with 14 additions and 8 deletions.
22 changes: 14 additions & 8 deletions aria-practices.html
Original file line number Diff line number Diff line change
Expand Up @@ -4189,12 +4189,15 @@ <h4><span id="naming_role_guidance_heading">Accessible Name Guidance by Role</sp
</dd>
</dl>
<table aria-labelledby="naming_role_guidance_heading">
<tr>
<th>role</th>
<th>Necessity of Naming</th>
<th>Guidance</th>
</tr>
<tr>
<thead>
<tr>
<th>role</th>
<th>Necessity of Naming</th>
<th>Guidance</th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="#alert" class="role-reference"><code>alert</code></a></td>
<td>Discretionary</td>
<td>
Expand Down Expand Up @@ -4251,7 +4254,8 @@ <h4><span id="naming_role_guidance_heading">Accessible Name Guidance by Role</sp
<ul>
<li>Warning! Using <code>aria-label</code> or <code>aria-labelledby</code> will hide descendant content from assistive technologies.</li>
<li>Ideally named by visible, descendant content.</li>
<li>Note that associated row or column headers do not name a cell; a cell's name is its content. Headers are complementary information.</li>
<li>Note that a name is not required; assistive technologies expect an empty cell in a table to be represented by an empty name.</li>
<li>Note that associated row or column headers do not name a <code>cell</code>; the name of a cell in a table is its content. Headers are complementary information.</li>
</ul>
</td>
</tr>
Expand Down Expand Up @@ -4389,7 +4393,8 @@ <h4><span id="naming_role_guidance_heading">Accessible Name Guidance by Role</sp
<ul>
<li>Warning! Using <code>aria-label</code> or <code>aria-labelledby</code> will hide descendant content from assistive technologies.</li>
<li>Ideally named by visible, descendant content.</li>
<li>Note that associated row or column headers do not name a cell; a cell's name is its content. Headers are complementary information.</li>
<li>Note that a name is not required; assistive technologies expect an empty cell in a grid to be represented by an empty name.</li>
<li>Note that associated row or column headers do not name a <code>gridcell</code>; the name of a cell in a grid is its content. Headers are complementary information.</li>
</ul>
</td>
</tr>
Expand Down Expand Up @@ -4872,6 +4877,7 @@ <h4><span id="naming_role_guidance_heading">Accessible Name Guidance by Role</sp
</ul>
</td>
</tr>
</tbody>
</table>
</section>

Expand Down

0 comments on commit 37ec3a9

Please sign in to comment.