Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Editorial: Add landmark language to definitions #1060

Merged
merged 3 commits into from
Oct 10, 2019
Merged

Editorial: Add landmark language to definitions #1060

Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ba80695
Add landmark language to definitions
jnurthen Sep 26, 2019
8dbadbd
remove perceivable
jnurthen Sep 27, 2019
7351c11
remove region from landmark text
jnurthen Oct 2, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions index.html
View file
Open in desktop
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> region 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> region, 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> region 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 @@ -4715,7 +4715,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> region 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 @@ -5589,7 +5589,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> region 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 @@ -6546,7 +6546,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