Skip to content

Commit

Permalink
Editorial: Add landmark term to all landmark definitions & make consi…
Browse files Browse the repository at this point in the history
…stent (#1060)
  • Loading branch information
jnurthen authored and carmacleod committed May 7, 2020
1 parent 7e24755 commit 22703a0
Showing 1 changed file with 6 additions and 6 deletions.
12 changes: 6 additions & 6 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1386,7 +1386,7 @@ <h2>Definition of Roles</h2>
<div class="role" id="banner">
<rdef>banner</rdef>
<div class="role-description">
<p>A region that contains mostly site-oriented content, rather than page-specific content.</p>
<p>A <rref>landmark</rref> that contains mostly site-oriented content, rather than page-specific content.</p>
<p>Site-oriented content typically includes things such as the logo or identity of the site sponsor, and a site-specific search tool. A banner usually appears at the top of the page and typically spans the full width.</p>
<p>User agents SHOULD treat elements with the role of <code>banner</code> as navigational <a>landmarks</a>.</p>
<!-- keep the following paragraphs synced with the similar paragraphs in #main and #contentinfo-->
Expand Down Expand Up @@ -2306,7 +2306,7 @@ <h2>Definition of Roles</h2>
<div class="role" id="complementary">
<rdef>complementary</rdef>
<div class="role-description">
<p>A supporting section of the document, designed to be complementary to the main content at a similar level in the DOM hierarchy, but remains meaningful when separated from the main content.</p>
<p>A <rref>landmark</rref> that is designed to be complementary to the main content at a similar level in the DOM hierarchy, but remaining meaningful when separated from the main content.</p>
<p>There are various types of content that would appropriately have this <a>role</a>. For example, in the case of a portal, this may include but not be limited to show times, current weather, related articles, or stocks to watch. The complementary role indicates that contained content is relevant to the main content. If the complementary content is completely separable from the main content, it may be appropriate to use a more general role.</p>
<p>User agents SHOULD treat elements with the role of <code>complementary</code> as navigational <a>landmarks</a>.</p>
</div>
Expand Down Expand Up @@ -2456,7 +2456,7 @@ <h2>Definition of Roles</h2>
<div class="role" id="contentinfo">
<rdef>contentinfo</rdef>
<div class="role-description">
<p>A large perceivable region that contains information about the parent document.</p>
<p>A <rref>landmark</rref> that contains information about the parent document.</p>
<p>Examples of information included in this region of the page are copyrights and links to privacy statements.</p>
<p>User agents SHOULD treat elements with the role of <code>contentinfo</code> as navigational <a>landmarks</a>.</p>
<!-- keep the following paragraphs synced with the similar paragraphs in #banner and #main -->
Expand Down Expand Up @@ -4716,7 +4716,7 @@ <h2>Definition of Roles</h2>
<div class="role" id="main">
<rdef>main</rdef>
<div class="role-description">
<p>The main content of a document.</p>
<p>A <rref>landmark</rref> containing the main content of a document.</p>
<p>This marks the content that is directly related to or expands upon the central topic of the document. The <code>main</code> <a>role</a> is a non-obtrusive alternative for "skip to main content" links, where the navigation option to go to the main content (or other <a>landmarks</a>) is provided by the <a>user agent</a> through a dialog or by <a>assistive technologies</a>.</p>
<p>User agents SHOULD treat elements with the role of <code>main</code> as navigational landmarks.</p>
<!-- keep the following paragraphs synced with the similar paragraphs in #banner and #contentinfo -->
Expand Down Expand Up @@ -5590,7 +5590,7 @@ <h4>Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula</h4>
<div class="role" id="navigation">
<rdef>navigation</rdef>
<div class="role-description">
<p>A collection of navigational <a>elements</a> (usually links) for navigating the document or related documents.</p>
<p>A <rref>landmark</rref> containing a collection of navigational <a>elements</a> (usually links) for navigating the document or related documents.</p>
<p>User agents SHOULD treat elements with the role of <code>navigation</code> as navigational <a>landmarks</a>.</p>
</div>
<table class="role-features">
Expand Down Expand Up @@ -6562,7 +6562,7 @@ <h5>Presentational Roles Conflict Resolution</h5>
<div class="role" id="region">
<rdef>region</rdef>
<div class="role-description">
<p>A perceivable <rref>section</rref> containing content that is relevant to a specific, author-specified purpose and sufficiently important that users will likely want to be able to navigate to the section easily and to have it listed in a summary of the page. Such a page summary could be generated dynamically by a user agent or assistive technology.</p>
<p>A <rref>landmark</rref> containing content that is relevant to a specific, author-specified purpose and sufficiently important that users will likely want to be able to navigate to the section easily and to have it listed in a summary of the page. Such a page summary could be generated dynamically by a user agent or assistive technology.</p>
<p>Authors SHOULD limit use of the region role to sections containing content with a purpose that is not accurately described by one of the other <rref>landmark</rref> roles, such as <rref>main</rref>, <rref>complementary</rref>, or <rref>navigation</rref>.</p>
<p>Authors MUST give each element with role region a brief label that describes the purpose of the content in the region. Authors SHOULD reference a visible label with <pref>aria-labelledby</pref> if a visible label is present. Authors SHOULD include the label inside of a heading whenever possible. The heading MAY be an instance of the standard host language heading element or an instance of an element with role <rref>heading</rref>.</p>
<p><a>Assistive technologies</a> SHOULD enable users to quickly navigate to elements with role region. Mainstream <a>user agents</a> MAY enable users to quickly navigate to elements with role region.</p>
Expand Down

0 comments on commit 22703a0

Please sign in to comment.