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.

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

Sync WCAG-2.1 branch contents with its change log and errata #4179

Open
wants to merge 12 commits into
base: WCAG-2.1
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
86 changes: 49 additions & 37 deletions guidelines/index.html

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion guidelines/input-purposes.html
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ <h2>Input Purposes for User Interface Components</h2>
<li><strong>bday-month</strong> - Month component of birthday</li>
<li><strong>bday-year</strong> - Year component of birthday</li>
<li><strong>sex</strong> - Gender identity (e.g., Female, Fa’afafine)</li>
<li><strong>url</strong> - Home page or other Web page corresponding to the company, person, address, or contact information in the other fields associated with this field</li>
<li><strong>url</strong> - Home page or other web page corresponding to the company, person, address, or contact information in the other fields associated with this field</li>
<li><strong>photo</strong> - Photograph, icon, or other image corresponding to the company, person, address, or contact information in the other fields associated with this field</li>
<li><strong>tel</strong> - Full telephone number, including country code</li>
<li><strong>tel-country-code</strong> - Country code component of the telephone number</li>
Expand Down
2 changes: 1 addition & 1 deletion guidelines/relative-luminance.html
Original file line number Diff line number Diff line change
Expand Up @@ -341,7 +341,7 @@ <h1>MathML version of the relative luminance definition</h1>
</div>
<div class="note" role="note" id="issue-container-generatedID-129"><div role="heading" class="note-title marker" id="h-note-129" aria-level="3"><span>Note</span><!---0.410359%--></div><p class="">Before May 2021 the value of 0.04045 in the definition was different (0.03928). It was taken from an older version of the specification and has been updated. It has no practical effect on the calculations in the context of these guidelines.</p></div>

<div class="note" role="note" id="issue-container-generatedID-130"><div role="heading" class="note-title marker" id="h-note-130" aria-level="3"><span>Note</span><!---0.410359%--></div><p class="">Almost all systems used today to view Web content assume sRGB encoding. Unless it
<div class="note" role="note" id="issue-container-generatedID-130"><div role="heading" class="note-title marker" id="h-note-130" aria-level="3"><span>Note</span><!---0.410359%--></div><p class="">Almost all systems used today to view web content assume sRGB encoding. Unless it
is known that another color space will be used to process and display the content,
authors should evaluate using sRGB colorspace. If using other color spaces, see <a href="https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum">Understanding Success Criterion 1.4.3</a>.
</p></div>
Expand Down
4 changes: 2 additions & 2 deletions guidelines/sc/20/audio-control.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,12 @@ <h4>Audio Control</h4>

<p class="conformance-level">A</p>

<p>If any audio on a Web page plays automatically for more than 3 seconds, either a <a>mechanism</a> is available to pause or stop the audio, or a mechanism is available to control audio
<p>If any audio on a web page plays automatically for more than 3 seconds, either a <a>mechanism</a> is available to <a>pause</a> or stop the audio, or a mechanism is available to control audio
volume independently from the overall system volume level.
</p>

<p class="note">Since any content that does not meet this success criterion can interfere with a user's
ability to use the whole page, all content on the Web page (whether or not it is used
ability to use the whole page, all content on the web page (whether or not it is used
to meet other success criteria) must meet this success criterion. See <a href="#cc5">Conformance Requirement 5: Non-Interference</a>.
</p>

Expand Down
2 changes: 1 addition & 1 deletion guidelines/sc/20/bypass-blocks.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ <h4>Bypass Blocks</h4>

<p class="conformance-level">A</p>

<p>A <a>mechanism</a> is available to bypass blocks of content that are repeated on multiple <a>Web pages</a>.
<p>A <a>mechanism</a> is available to bypass blocks of content that are repeated on multiple <a>web pages</a>.
</p>

</section>
2 changes: 1 addition & 1 deletion guidelines/sc/20/consistent-identification.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ <h4>Consistent Identification</h4>

<p class="conformance-level">AA</p>

<p>Components that have the <a>same functionality</a> within a <a>set of Web pages</a> are identified consistently.
<p>Components that have the <a>same functionality</a> within a <a>set of web pages</a> are identified consistently.
</p>

</section>
2 changes: 1 addition & 1 deletion guidelines/sc/20/consistent-navigation.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ <h4>Consistent Navigation</h4>

<p class="conformance-level">AA</p>

<p>Navigational mechanisms that are repeated on multiple <a>Web pages</a> within a <a>set of Web pages</a> occur in the <a>same relative order</a> each time they are repeated, unless a change is initiated by the user.
<p>Navigational mechanisms that are repeated on multiple <a>web pages</a> within a <a>set of web pages</a> occur in the <a>same relative order</a> each time they are repeated, unless a change is initiated by the user.
</p>

</section>
6 changes: 3 additions & 3 deletions guidelines/sc/20/error-prevention-all.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,13 @@ <h4>Error Prevention (All)</h4>

<p class="conformance-level">AAA</p>

<p>For <a>Web pages</a> that require the user to submit information, at least one of the following is true:
<p>For <a>web pages</a> that require the user to submit information, at least one of the following is true:
</p>

<dl>
<dt>Reversible</dt><dd>Submissions are reversible.</dd>
<dt>Checked</dt><dd>Data entered by the user is checked for input errors and the user is provided an opportunity to correct them.</dd>
<dt>Confirmed</dt><dd>A mechanism is available for reviewing, confirming, and correcting information before finalizing the submission.</dd>
<dt>Checked</dt><dd>Data entered by the user is checked for <a>input errors</a> and the user is provided an opportunity to correct them.</dd>
<dt>Confirmed</dt><dd>A <a>mechanism</a> is available for reviewing, confirming, and correcting information before finalizing the submission.</dd>
</dl>

</section>
6 changes: 3 additions & 3 deletions guidelines/sc/20/error-prevention-legal-financial-data.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,14 @@ <h4>Error Prevention (Legal, Financial, Data)</h4>

<p class="conformance-level">AA</p>

<p>For <a>Web pages</a> that cause <a>legal commitments</a> or financial transactions for the user to occur, that modify or delete <a>user-controllable</a> data in data storage systems, or that submit user test responses, at least one of
<p>For <a>web pages</a> that cause <a>legal commitments</a> or financial transactions for the user to occur, that modify or delete <a>user-controllable</a> data in data storage systems, or that submit user test responses, at least one of
the following is true:
</p>

<dl>
<dt>Reversible</dt><dd>Submissions are reversible.</dd>
<dt>Checked</dt><dd>Data entered by the user is checked for input errors and the user is provided an opportunity to correct them.</dd>
<dt>Confirmed</dt><dd>A mechanism is available for reviewing, confirming, and correcting information before finalizing the submission.</dd>
<dt>Checked</dt><dd>Data entered by the user is checked for <a>input errors</a> and the user is provided an opportunity to correct them.</dd>
<dt>Confirmed</dt><dd>A <a>mechanism</a> is available for reviewing, confirming, and correcting information before finalizing the submission.</dd>
</dl>

</section>
2 changes: 1 addition & 1 deletion guidelines/sc/20/focus-order.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ <h4>Focus Order</h4>

<p class="conformance-level">A</p>

<p>If a <a>Web page</a> can be <a>navigated sequentially</a> and the navigation sequences affect meaning or operation, focusable components receive
<p>If a <a>web page</a> can be <a>navigated sequentially</a> and the navigation sequences affect meaning or operation, focusable components receive
focus in an order that preserves meaning and operability.
</p>

Expand Down
3 changes: 1 addition & 2 deletions guidelines/sc/20/focus-visible.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,7 @@ <h4>Focus Visible</h4>

<p class="conformance-level">AA</p>

<p>Any keyboard operable user interface has a mode of operation where the keyboard focus
indicator is visible.
<p>Any keyboard operable user interface has a mode of operation where the keyboard focus indicator is visible.
</p>

</section>
2 changes: 1 addition & 1 deletion guidelines/sc/20/language-of-page.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ <h4>Language of Page</h4>

<p class="conformance-level">A</p>

<p>The default <a>human language</a> of each <a>Web page</a> can be <a>programmatically determined</a>.
<p>The default <a>human language</a> of each <a>web page</a> can be <a>programmatically determined</a>.
</p>

</section>
2 changes: 1 addition & 1 deletion guidelines/sc/20/language-of-parts.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ <h4>Language of Parts</h4>

<p>The <a>human language</a> of each passage or phrase in the content can be <a>programmatically determined</a> except for proper names, technical terms, words of indeterminate language, and words
or phrases that have become part of the vernacular of the immediately surrounding
text.
<a>text</a>.
</p>

</section>
2 changes: 1 addition & 1 deletion guidelines/sc/20/link-purpose-link-only.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ <h4>Link Purpose (Link Only)</h4>

<p class="conformance-level">AAA</p>

<p>A <a>mechanism</a> is available to allow the purpose of each link to be identified from link text alone,
<p>A <a>mechanism</a> is available to allow the <a>purpose of each link</a> to be identified from link text alone,
except where the purpose of the link would be <a>ambiguous to users in general</a>.
</p>

Expand Down
2 changes: 1 addition & 1 deletion guidelines/sc/20/location.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ <h4>Location</h4>

<p class="conformance-level">AAA</p>

<p>Information about the user's location within a <a>set of Web pages</a> is available.
<p>Information about the user's location within a <a>set of web pages</a> is available.
</p>

</section>
2 changes: 1 addition & 1 deletion guidelines/sc/20/multiple-ways.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ <h4>Multiple Ways</h4>

<p class="conformance-level">AA</p>

<p>More than one way is available to locate a <a>Web page</a> within a <a>set of Web pages</a> except where the Web Page is the result of, or a step in, a <a>process</a>.
<p>More than one way is available to locate a <a>web page</a> within a <a>set of web pages</a> except where the web page is the result of, or a step in, a <a>process</a>.
</p>

</section>
4 changes: 2 additions & 2 deletions guidelines/sc/20/name-role-value.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,10 +5,10 @@ <h4>Name, Role, Value</h4>
<p class="conformance-level">A</p>

<p>For all <a>user interface components</a> (including but not limited to: form elements, links and components generated by scripts),
the <a>name</a> and <a>role</a> can be <a>programmatically determined</a>; states, properties, and values that can be set by the user can be <a>programmatically set</a>; and notification of changes to these items is available to <a>user agents</a>, including <a>assistive technologies</a>.
the <a>name</a> and <a>role</a> can be <a>programmatically determined</a>; <a>states</a>, properties, and values that can be set by the user can be <a>programmatically set</a>; and notification of changes to these items is available to <a>user agents</a>, including <a>assistive technologies</a>.
</p>

<p class="note">This success criterion is primarily for Web authors who develop or script their own
<p class="note">This success criterion is primarily for web authors who develop or script their own
user interface components. For example, standard HTML controls already meet this success
criterion when used according to specification.
</p>
Expand Down
2 changes: 1 addition & 1 deletion guidelines/sc/20/no-keyboard-trap.html
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ <h4>No Keyboard Trap</h4>
</p>

<p class="note">Since any content that does not meet this success criterion can interfere with a user's
ability to use the whole page, all content on the Web page (whether it is used to
ability to use the whole page, all content on the web page (whether it is used to
meet other success criteria or not) must meet this success criterion. See <a href="#cc5">Conformance Requirement 5: Non-Interference</a>.
</p>

Expand Down
4 changes: 2 additions & 2 deletions guidelines/sc/20/pause-stop-hide.html
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ <h4>Pause, Stop, Hide</h4>

<p>For any moving, blinking or scrolling information that (1) starts automatically, (2)
lasts more than five seconds, and (3) is presented in parallel with other content,
there is a mechanism for the user to <a>pause</a>, stop, or hide it unless the movement, blinking, or scrolling is part of an activity
there is a <a>mechanism</a> for the user to <a>pause</a>, stop, or hide it unless the movement, blinking, or scrolling is part of an activity
where it is <a>essential</a>; and
</p>

Expand All @@ -39,7 +39,7 @@ <h4>Pause, Stop, Hide</h4>
</p>

<p class="note">Since any content that does not meet this success criterion can interfere with a user's
ability to use the whole page, all content on the Web page (whether it is used to
ability to use the whole page, all content on the web page (whether it is used to
meet other success criteria or not) must meet this success criterion. See <a href="#cc5">Conformance Requirement 5: Non-Interference</a>.
</p>

Expand Down
2 changes: 1 addition & 1 deletion guidelines/sc/20/reading-level.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ <h4>Reading Level</h4>

<p class="conformance-level">AAA</p>

<p>When text requires reading ability more advanced than the <a>lower secondary education level</a> after removal of proper names and titles, <a>supplemental content</a>, or a version that does not require reading ability more advanced than the lower
<p>When text requires reading ability more advanced than the <a>lower secondary education level</a> after removal of proper names and titles, <a>supplemental content</a>, or a version that does not require reading ability more advanced than the lower
secondary education level, is available.
</p>

Expand Down
2 changes: 1 addition & 1 deletion guidelines/sc/20/three-flashes-or-below-threshold.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ <h4>Three Flashes or Below Threshold</h4>
</p>

<p class="note">Since any content that does not meet this success criterion can interfere with a user's
ability to use the whole page, all content on the Web page (whether it is used to
ability to use the whole page, all content on the web page (whether it is used to
meet other success criteria or not) must meet this success criterion. See <a href="#cc5">Conformance Requirement 5: Non-Interference</a>.
</p>

Expand Down
2 changes: 1 addition & 1 deletion guidelines/sc/20/timing-adjustable.html
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ <h4>Timing Adjustable</h4>

<dd>

<p>The time limit is a required part of a real-time event (for example, an auction),
<p>The time limit is a required part of a <a>real-time event</a> (for example, an auction),
and no alternative to the time limit is possible; or
</p>

Expand Down
2 changes: 1 addition & 1 deletion guidelines/sc/20/visual-presentation.html
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ <h4>Visual Presentation</h4>
<li>Width is no more than 80 characters or glyphs (40 if CJK).</li>
<li>Text is not justified (aligned to both the left and the right margins).</li>
<li>Line spacing (leading) is at least space-and-a-half within paragraphs, and paragraph spacing is at least 1.5 times larger than the line spacing.</li>
<li>Text can be resized without assistive technology up to 200 percent in a way that does not require the user to scroll horizontally to read a line of text <a>on a full-screen window</a>.</li>
<li>Text can be resized without <a>assistive technology</a> up to 200 percent in a way that does not require the user to scroll horizontally to read a line of text <a>on a full-screen window</a>.</li>
</ul>

</section>
2 changes: 1 addition & 1 deletion guidelines/sc/21/content-on-hover-or-focus.html
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ <h4>Content on Hover or Focus</h4>

</dl>

<p>Exception: The visual presentation of the additional content is controlled by the user agent and is not modified by the author.</p>
<p>Exception: The visual presentation of the additional content is controlled by the <a>user agent</a> and is not modified by the author.</p>

<p class="note">Examples of additional content controlled by the user agent include browser tooltips created through use of the HTML <a href="https://www.w3.org/TR/html/dom.html#the-title-attribute"><code>title</code> attribute</a>.</p>
<p class="note">Custom tooltips, sub-menus, and other nonmodal popups that display on hover and focus are examples of additional content covered by this criterion.</p>
Expand Down
2 changes: 1 addition & 1 deletion guidelines/sc/21/non-text-contrast.html
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ <h4>Non-text Contrast</h4>

<dt>User Interface Components</dt>

<dd>Visual information required to identify <a>user interface components</a> and <a>states</a>, except for inactive components or where the appearance of the component is determined by the user agent and not modified by the author;</dd>
<dd>Visual information required to identify <a>user interface components</a> and <a>states</a>, except for inactive components or where the appearance of the component is determined by the <a>user agent</a> and not modified by the author;</dd>

<dt>Graphical Objects</dt>

Expand Down
2 changes: 1 addition & 1 deletion guidelines/sc/21/reflow.html
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ <h4>Reflow</h4>
</ul>
<p>Except for parts of the content which require two-dimensional layout for usage or meaning.</p>

<p class="note">320 CSS pixels is equivalent to a starting viewport width of 1280 CSS pixels wide at 400% zoom. For web content which is designed to scroll horizontally (e.g., with vertical text), 256 CSS pixels is equivalent to a starting viewport height of 1024 CSS pixels at 400% zoom.</p>
<p class="note">320 CSS pixels is equivalent to a starting <a>viewport</a> width of 1280 CSS pixels wide at 400% zoom. For web content which is designed to scroll horizontally (e.g., with vertical text), 256 CSS pixels is equivalent to a starting viewport height of 1024 CSS pixels at 400% zoom.</p>

<p class="note">Examples of content which requires two-dimensional layout are images required for understanding (such as maps and diagrams), video, games, presentations, data tables (not individual cells), and interfaces where it is necessary to keep toolbars in view while manipulating content. It is acceptable to provide two-dimensional scrolling for such parts of the content.</p>

Expand Down
6 changes: 3 additions & 3 deletions guidelines/sc/21/target-size-enhanced.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@ <h4>Target Size (Enhanced)</h4>
<dt>Equivalent</dt>
<dd>The target is available through an equivalent link or control on the same page that is at least 44 by 44 CSS pixels;</dd>
<dt>Inline</dt>
<dd>The target is in a sentence or block of text;</dd>
<dd>The target is in a sentence or <a>block of text</a>;</dd>
<dt>User Agent Control</dt>
<dd>The size of the target is determined by the user agent and is not modified by the author;</dd>
<dd>The size of the target is determined by the <a>user agent</a> and is not modified by the author;</dd>
<dt>Essential</dt>
<dd>A particular presentation of the target is <a>essential</a> to the information being conveyed.</dd>
<dd>A particular <a>presentation</a> of the target is <a>essential</a> to the information being conveyed.</dd>
</dl>

</section>
2 changes: 1 addition & 1 deletion guidelines/sc/21/text-spacing.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,6 @@ <h4>Text Spacing</h4>
<li>Word spacing to at least 0.16 times the font size.</li>
</ul>

<p>Exception: Human languages and scripts that do not make use of one or more of these text style properties in written text can conform using only the properties that exist for that combination of language and script.</p>
<p>Exception: <a>Human languages</a> and scripts that do not make use of one or more of these text style properties in written text can conform using only the properties that exist for that combination of language and script.</p>

</section>
Loading