You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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]>
Copy file name to clipboardExpand all lines: techniques/aria/ARIA11.html
+13-10Lines changed: 13 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -20,19 +20,19 @@ <h1>Using ARIA landmarks to identify regions of a page</h1>
20
20
</p>
21
21
<p>Landmarks also can help sighted keyboard-only users navigate to sections of a page using a <ahref="https://www.tpgi.com/improving-access-to-landmark-navigation/">browser plugin</a>.
22
22
</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 <ahref="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 <ahref="https://www.w3.org/TR/html-aria/">ARIA In HTML recommendation</a>.</p>
24
24
<ul>
25
-
<li><codeclass="language-html">banner</code>: A region that contains the prime heading or internal title of a page.</li>
26
-
<li><codeclass="language-html">navigation</code>: A region that contains navigation links links to other pages or different parts of the same page.</li>
25
+
<li><codeclass="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><codeclass="language-html">navigation</code>: A region that contains navigation links to other pages or different parts of the same page.</li>
27
27
<li><codeclass="language-html">main</code>: A region that contains a page's main content.</li>
28
-
<li><codeclass="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 <codeclass="language-html">region</code> landmark isn't exposed as a landmark region unless it has an accessible name.</li>
29
-
<li><codeclass="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><codeclass="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 <codeclass="language-html">region</code> landmark isn't exposed as a landmark region unless it has an accessible name, often provided using <codeclass="language-html">aria-label</code> or <codeclass="language-html">aria-labelledby</code>.</li>
29
+
<li><codeclass="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 <codeclass="language-html">form</code> landmark isn't exposed as a landmark region unless it has an accessible name.</li></li>
30
30
<li><codeclass="language-html">search</code>: A region of the page containing search functionality.</li>
31
31
<li><codeclass="language-html">complementary</code>: Any section of the document that supports the main content, yet is separate and meaningful on its own.</li>
32
32
<li><codeclass="language-html">contentinfo</code>: A region that contains information about the parent document such as copyrights and links to privacy statements.</li>
33
33
</ul>
34
34
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>
36
36
37
37
<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>
38
38
@@ -112,12 +112,13 @@ <h3>Procedure</h3>
112
112
<li>Examine each element with a <ahref="https://www.w3.org/TR/wai-aria/#landmark_roles">landmark role</a>.</li>
113
113
<li>Examine whether the correct element has been used to mark up content. For example: a <codeclass="language-html">navigation</code> role has been used to mark up a section with navigation links, or the <codeclass="language-html">main</code> role is used to contain the page's main content.</li>
114
114
<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>
0 commit comments