Skip to content

Commit

Permalink
Landmark Regions: Fix labeling requirement issue #453 (#687)
Browse files Browse the repository at this point in the history
Editorial clarification to landmark labeling guidance to explain when unique labels are needed and when duplicate labels may be appropriate.
  • Loading branch information
jnurthen authored and mcking65 committed Jun 24, 2018
1 parent 386113e commit 87d5739
Showing 1 changed file with 6 additions and 1 deletion.
7 changes: 6 additions & 1 deletion aria-practices.html
Original file line number Diff line number Diff line change
Expand Up @@ -2903,7 +2903,12 @@ <h3>General Principles of Landmark Design</h3>
<p id="aria_lh_step3"><strong>Step 3: Label areas</strong></p>

<ul>
<li>If a specific landmark role is used more than once on a web page, it should have a unique label.</li>
<li>
If a specific landmark role is used more than once on a page, provide each instance of that landmark with a unique label.
There is one rare circumstance where providing the same label to multiple instances of a landmark can be beneficial: the content and purpose of each instance is identical.
For example, a large search results table has two sets of identical pagination controls -- one above and one below the table, so each set is in a navigation region labeled <q>Search Results</q>.
In this case, adding extra information to the label that distinguishes the two instances may be more distracting than helpful.
</li>

<li>If a landmark is only used once on the page it may not require a label. See Landmark Roles section below. </li>

Expand Down

0 comments on commit 87d5739

Please sign in to comment.