Skip to content

Commit 54e54b8

Browse files
JAWS-test2kfranqueiroscottaoharapatrickhlaukembgower
authored
Update ARIA11 (#1023)
Fixes #919 Also: * Update and addition of links * Remove `role=application` (no landmark region) * Adding `role=region` * Adding the test for meaningful labeling --------- Co-authored-by: JAWS-test2 <> Co-authored-by: Kenneth G. Franqueiro <[email protected]> Co-authored-by: Scott O'Hara <[email protected]> Co-authored-by: Patrick H. Lauke <[email protected]> Co-authored-by: Mike Gower <[email protected]> Co-authored-by: Mike Gower <[email protected]>
1 parent 6e22d07 commit 54e54b8

File tree

1 file changed

+13
-10
lines changed

1 file changed

+13
-10
lines changed

techniques/aria/ARIA11.html

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -20,19 +20,19 @@ <h1>Using ARIA landmarks to identify regions of a page</h1>
2020
</p>
2121
<p>Landmarks also can help sighted keyboard-only users navigate to sections of a page using a <a href="https://www.tpgi.com/improving-access-to-landmark-navigation/">browser plugin</a>.
2222
</p>
23-
<p>Landmarks are inserted into the page using the role attribute on an element that marks the section. The value of the attribute is the name of the landmark. These role values are listed below. For HTML mappings of landmark roles, refer to the <cite>Rules of ARIA attribute usage by HTML element</cite> table in the <a href="https://www.w3.org/TR/html-aria/">ARIA In HTML recommendation</a>.</p>
23+
<p>Landmarks are inserted into the page using the role attribute on an element that marks the section. The value of the attribute designates the type of landmark. These role values are listed below. For HTML mappings of landmark roles, refer to the <cite>Rules of ARIA attribute usage by HTML element</cite> table in the <a href="https://www.w3.org/TR/html-aria/">ARIA In HTML recommendation</a>.</p>
2424
<ul>
25-
<li><code class="language-html">banner</code>: A region that contains the prime heading or internal title of a page.</li>
26-
<li><code class="language-html">navigation</code>: A region that contains navigation links links to other pages or different parts of the same page.</li>
25+
<li><code class="language-html">banner</code>: A region that contains mostly site-oriented content, such as the logo or a site-specific search tool.</li>
26+
<li><code class="language-html">navigation</code>: A region that contains navigation links to other pages or different parts of the same page.</li>
2727
<li><code class="language-html">main</code>: A region that contains a page's main content.</li>
28-
<li><code class="language-html">region</code>: A region that contains a perceivable section of the page containing content that is sufficiently important for users to be able to navigate to the section. A <code class="language-html">region</code> landmark isn't exposed as a landmark region unless it has an accessible name.</li>
29-
<li><code class="language-html">form</code>: A region of the document that represents a collection of form-associated elements, some of which can represent editable values that can be submitted to a server for processing.</li>
28+
<li><code class="language-html">region</code>: A region that contains a perceivable section of the page containing content that is sufficiently important for users to be able to navigate to the section. A <code class="language-html">region</code> landmark isn't exposed as a landmark region unless it has an accessible name, often provided using <code class="language-html">aria-label</code> or <code class="language-html">aria-labelledby</code>.</li>
29+
<li><code class="language-html">form</code>: A region of the document that represents a collection of form-associated elements, some of which can represent editable values that can be submitted to a server for processing. A <code class="language-html">form</code> landmark isn't exposed as a landmark region unless it has an accessible name.</li></li>
3030
<li><code class="language-html">search</code>: A region of the page containing search functionality.</li>
3131
<li><code class="language-html">complementary</code>: Any section of the document that supports the main content, yet is separate and meaningful on its own.</li>
3232
<li><code class="language-html">contentinfo</code>: A region that contains information about the parent document such as copyrights and links to privacy statements.</li>
3333
</ul>
3434

35-
<p>There are cases when a particular landmark role could be used more than once on a page, such as on primary and secondary blocks of navigation. In these cases, identical roles should be labeled using a valid technique for labelling regions.</p>
35+
<p>There are cases when a particular landmark role could be used more than once on a page, such as on primary and secondary blocks of navigation. In these cases, identical roles should be named using a valid technique for labeling regions.</p>
3636

3737
<p>Landmarks should supplement native semantic markup such as HTML headings, lists and other structural markup. Landmarks are interpretable by WAI-ARIA-aware assistive technologies and are not exposed by browsers directly to users.</p>
3838

@@ -112,12 +112,13 @@ <h3>Procedure</h3>
112112
<li>Examine each element with a <a href="https://www.w3.org/TR/wai-aria/#landmark_roles">landmark role</a>.</li>
113113
<li>Examine whether the correct element has been used to mark up content. For example: a <code class="language-html">navigation</code> role has been used to mark up a section with navigation links, or the <code class="language-html">main</code> role is used to contain the page's main content.</li>
114114
<li>If a landmark region needs to have an accessible name to be exposed as a landmark, check to see that there is an accessible name.</li>
115+
<li>If the same type of landmark appears multiple times on the page, check that each one is given a unique and meaningful accessible name.</li>
115116
</ol>
116117
</section>
117118
<section class="results" id="expected-test-results">
118119
<h3>Expected Results</h3>
119120
<ul>
120-
<li>#1, #2, and #3 are true.</li>
121+
<li>#1, #2, #3, and #4 are true.</li>
121122
</ul>
122123
</section>
123124
</section>
@@ -126,6 +127,8 @@ <h2>Related Techniques</h2>
126127
<ul>
127128
<li><a href="../general/G1">G1</a></li>
128129
<li><a href="../general/G124">G124</a></li>
130+
<li><a href="ARIA13">ARIA13</a></li>
131+
<li><a href="ARIA20">ARIA20</a></li>
129132
<li><a href="../html/H69">H69</a></li>
130133
<li><a href="../html/H100">H100</a></li>
131134
<li><a href="../client-side-script/SCR28">SCR28</a></li>
@@ -134,13 +137,13 @@ <h2>Related Techniques</h2>
134137
<section id="resources"><h2>Resources</h2>
135138
<ul>
136139
<li>
137-
<a href="https://www.w3.org/TR/wai-aria-practices/">WAI-ARIA Authoring Practices</a>
140+
<a href="https://www.w3.org/WAI/ARIA/apg/practices/landmark-regions/">WAI-ARIA Authoring Practices, Landmark Regions</a>
138141
</li>
139142
<li>
140-
<a href="https://www.w3.org/TR/wai-aria/#usage_intro">Accessible Rich Internet Applications (WAI-ARIA), Using WAI-ARIA Roles</a>
143+
<a href="https://www.w3.org/WAI/tutorials/page-structure/regions/">W3C Web Accessibility Tutorials, Page Regions</a>
141144
</li>
142145
<li>
143-
<a href="https://www.w3.org/TR/wai-aria/#states_and_properties">Accessible Rich Internet Applications (WAI-ARIA), Supported States and Properties</a>
146+
<a href="https://www.w3.org/TR/wai-aria/#landmark_roles">Accessible Rich Internet Applications (WAI-ARIA), Landmark Roles</a>
144147
</li>
145148
<li>
146149
<a href="https://www.tpgi.com/improving-access-to-landmark-navigation/">Improving access to landmark navigation</a>

0 commit comments

Comments
 (0)