Skip to content
Merged
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
2 changes: 1 addition & 1 deletion _rules/aria-attr-defined-5f99a7.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ There are no assumptions.

There are no accessibility support issues known.

### Bibliography
### Other Resources

- [ARIA in HTML](https://www.w3.org/TR/html-aria/#index-aria-global)
- [WAI ARIA Supported States and Properties](https://www.w3.org/TR/wai-aria-1.2/#supportedState)
Expand Down
2 changes: 1 addition & 1 deletion _rules/aria-hidden-no-focusable-content-6cfa84.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ Some user agents treat the value of `aria-hidden` attribute as case-sensitive.

- [Element with presentational children has no focusable content](https://www.w3.org/WAI/standards-guidelines/act/rules/307n5z/)

### Bibliography
### Other Resources

- [CSS Scoping Module Level 1 (editor's draft)](https://drafts.csswg.org/css-scoping/)
- [Understanding Success Criterion 1.3.1: Info and Relationships](https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships)
Expand Down
2 changes: 1 addition & 1 deletion _rules/aria-required-context-role-ff89c9.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ The rule assumes that the [explicit role][] of the applicable elements is approp
- `aria-owns` has limited support in some user agents.
- There exist some combination of popular browsers and assistive technologies who do not announce correctly relationships based on a mix of [implicit][implicit role] and [explicit][explicit role] roles.

### Bibliography
### Other Resources

- [Understanding Success Criterion 1.3.1: Info and Relationships](https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html)
- [Required Context Role][]
Expand Down
2 changes: 1 addition & 1 deletion _rules/aria-required-id-references-in6db8.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ There are no assumptions.

Some user agents treat the value of `aria-*` attribute as case-sensitive (even when these are not IDs) while some treat them as case-insensitive.

### Bibliography
### Other Resources

- [ARIA5: Using WAI-ARIA state and property attributes to expose the state of a user interface component](https://www.w3.org/WAI/WCAG22/Techniques/aria/ARIA5)
- [WAI-ARIA required states and properties](https://www.w3.org/TR/wai-aria-1.2/#requiredState)
Expand Down
2 changes: 1 addition & 1 deletion _rules/aria-required-owned-element-bc4a75.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ If the [semantic role][] on the target element is incorrectly used, and any rela
- Assistive technologies are not consistent in how they handle situations where a [required owned element][] has a missing or incorrect role. This can lead to situations where inaccurate owned elements behave as expected in one assistive technology, but not in another.
- Some user agents treat the value of `aria-busy` as case-sensitive.

### Bibliography
### Other Resources

- [Understanding Success Criterion 1.3.1: Info and Relationships](https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html)
- [Required Owned Element](https://www.w3.org/TR/wai-aria-1.2/#mustContain)
Expand Down
2 changes: 1 addition & 1 deletion _rules/aria-state-or-property-permitted-5c01ea.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ Implementation of [Presentational Roles Conflict Resolution][] varies from one b

- [ARIA state or property has valid value](https://www.w3.org/WAI/standards-guidelines/act/rules/6a7281/)

### Bibliography
### Other Resources

- [Understanding Success Criterion 4.1.1: Parsing](https://www.w3.org/WAI/WCAG22/Understanding/parsing.html)
- [Understanding Success Criterion 4.1.2: Name, Role, Value](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html)
Expand Down
2 changes: 1 addition & 1 deletion _rules/aria-state-or-property-valid-value-6a7281.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ Some user agents treat the value of `aria-*` attribute as case-sensitive (even w
- [ARIA state or property is permitted](https://www.w3.org/WAI/standards-guidelines/act/rules/5c01ea/)
- [ARIA required ID references exist](https://www.w3.org/WAI/standards-guidelines/act/rules/in6db8/)

### Bibliography
### Other Resources

- [Understanding Success Criterion 4.1.2: Name, Role, Value](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html)
- [ARIA5: Using WAI-ARIA state and property attributes to expose the state of a user interface component](https://www.w3.org/WAI/WCAG22/Techniques/aria/ARIA5)
Expand Down
2 changes: 1 addition & 1 deletion _rules/attr-not-duplicated-e6952f.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ There are no assumptions.

There are no accessibility support issues known.

### Bibliography
### Other Resources

- [H94: Ensuring that elements do not contain duplicate attributes](https://www.w3.org/WAI/WCAG22/Techniques/html/H94)

Expand Down
2 changes: 1 addition & 1 deletion _rules/audio-as-media-alternative-afb423.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ There are no assumptions.

There are no accessibility support issues known.

### Bibliography
### Other Resources

- [Understanding SC 1.2.1: Audio-only and Video-only (Prerecorded)](https://www.w3.org/WAI/WCAG22/Understanding/audio-only-and-video-only-prerecorded)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,7 @@ The native `video` and `audio` controls in several browser and assistive technol

User agents do not always automatically play media, even when an `autoplay` attribute is present. This is done to avoid autoplaying media interrupting the user when they do not want to, especially when the media is likely to contain sound. The decision to respect the `autoplay` attribute or not depends on user settings and previous behavior (interaction with the site). Therefore, some media files may fail this rule but satisfy [Success Criterion 1.4.2 Audio Control][sc142] on some combination of User Agent and user settings. The rule considers that the presence of the `autoplay` attribute is an indication of the author intention to have automatically playing media, and therefore requires the author to provide a mechanism to control the sound.

### Bibliography
### Other Resources

- [Understanding Success Criterion 1.4.2: Audio Control](https://www.w3.org/WAI/WCAG22/Understanding/audio-control.html)
- [Accessible Multimedia](https://developer.mozilla.org/en-US/docs/Learn/Accessibility/Multimedia)
Expand Down
2 changes: 1 addition & 1 deletion _rules/audio-text-alternative-e7aa44.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ This rule assumes that the language of each test target can be correctly determi

There are no accessibility support issues known.

### Bibliography
### Other Resources

- [Understanding SC 1.2.1: Audio-only and Video-only (Prerecorded)](https://www.w3.org/WAI/WCAG22/Understanding/audio-only-and-video-only-prerecorded)
- [G158: Providing an alternative for time-based media for audio-only content](https://www.w3.org/WAI/WCAG22/Techniques/general/G158)
Expand Down
2 changes: 1 addition & 1 deletion _rules/audio-transcript-2eb176.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ There are no assumptions.

There are no accessibility support issues known.

### Bibliography
### Other Resources

- [Understanding SC 1.2.1:Audio-only and Video-only (Prerecorded)](https://www.w3.org/WAI/WCAG22/Understanding/audio-only-and-video-only-prerecorded)
- [G158: Providing an alternative for time-based media for audio-only content](https://www.w3.org/WAI/WCAG22/Techniques/general/G158)
Expand Down
2 changes: 1 addition & 1 deletion _rules/auto-play-audio-does-not-exceed-3-seconds-aaa1bf.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ There are no assumptions.

There are no accessibility support issues known.

### Bibliography
### Other Resources

- [Understanding Success Criterion 1.4.2: Audio Control](https://www.w3.org/WAI/WCAG22/Understanding/audio-control.html)
- [F23: Failure of 1.4.2 due to playing a sound longer than 3 seconds where there is no mechanism to turn it off](https://www.w3.org/WAI/WCAG22/Techniques/failures/F23)
Expand Down
2 changes: 1 addition & 1 deletion _rules/auto-play-audio-has-control-mechanism-4c31df.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ There are no assumptions.

The native `video` and `audio` controls in several browser and assistive technology combinations are not keyboard accessible and the `video` or `audio` element itself may not be announced. Authors are recommended to use custom controls for keyboard navigation and cross browser accessibility support in general.

### Bibliography
### Other Resources

- [Understanding Success Criterion 1.4.2: Audio Control](https://www.w3.org/WAI/WCAG22/Understanding/audio-control.html)
- [Failure of Success Criterion 1.4.2 for absence of a way to pause or stop an HTML5 media element that autoplays](https://www.w3.org/WAI/WCAG22/Techniques/failures/F93)
Expand Down
2 changes: 1 addition & 1 deletion _rules/auto-update-text-efbfc7.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ The [instruments][instrument] used to pass this rule (if any), must meet all lev

There are no accessibility support issues known.

### Bibliography
### Other Resources

- [Understanding Success Criterion 2.2.2: Pause, Stop, Hide][sc 2.2.2]
- [G186: Using a control in the Web page that stops moving, blinking, or auto-updating content][g186]
Expand Down
2 changes: 1 addition & 1 deletion _rules/autocomplete-valid-value-73f2c2.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ The purpose of a control is programmatically identifiable even when its `autocom
- Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some elements can have a [semantic role][] of `none` and fail this rule with some technology but users of other technologies would not experience any accessibility issue.
- Authors may assign inappropriate `autocomplete` attribute values. Moreover, HTML specifications restrict certain `autocomplete` attribute values to specific form controls. Mismatches between `autocomplete` attribute values and form control types may or may not lead to a failure of [success criterion 1.3.5 Identify Input Purpose](https://www.w3.org/TR/WCAG22/#identify-input-purpose). However, this rule focuses exclusively on validating valid `autocomplete` attribute values, disregarding their contextual appropriateness.

### Bibliography
### Other Resources

- [Understanding Success Criterion 1.3.5: Identify Input Purpose](https://www.w3.org/WAI/WCAG22/Understanding/identify-input-purpose.html)
- [Definition: programmatically determined (programmatically determinable)](https://www.w3.org/TR/WCAG22/#dfn-programmatically-determinable)
Expand Down
2 changes: 1 addition & 1 deletion _rules/block-collapsible-3e12e1.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Usually the same [instrument][] removes both [visibility][visible] and [inclusio

There are no accessibility support issues known.

### Bibliography
### Other Resources

- [Technique SCR28: Using an expandable and collapsible menu to bypass block of content][tech scr28]

Expand Down
2 changes: 1 addition & 1 deletion _rules/button-non-empty-accessible-name-97a4e1.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ This rule considers an exception for "image buttons" (i.e., `input` elements wit

- [Image button has non-empty accessible name](https://www.w3.org/WAI/standards-guidelines/act/rules/59796f/)

### Bibliography
### Other Resources

- [HTML Accessibility API Mappings 1.0 (working draft), 5.2 `input type="button"`, `input type="submit"` and `input type="reset"`](https://www.w3.org/TR/html-aam/#input-type-button-input-type-submit-and-input-type-reset)
- [Understanding Success Criterion 4.1.2: Name, Role, Value](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value)
Expand Down
2 changes: 1 addition & 1 deletion _rules/bypass-blocks-cf77f2.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@ If the [instruments][instrument] used to pass some of the atomic rules are not k

This rule only checks if there is a way to bypass at least one section of repeated content. On pages with several interleaved repeated and non-repeated content, this is not sufficient to satisfy [Success Criterion 2.4.1 Bypass blocks][sc241]. Checking for more sections to bypass was considered but rejected due to both the added complexity it would create, and the risk of failing on pages that might be correct.

### Bibliography
### Other Resources

- [Understanding Success Criterion 2.4.1: Bypass Blocks][usc241]
- Creating links to skip blocks of content:
Expand Down
2 changes: 1 addition & 1 deletion _rules/css-restrict-orientation-b33eff.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ This rule does not consider and may produce incorrect results for:

There are no accessibility support issues known.

### Bibliography
### Other Resources

- [Understanding Success Criterion 1.3.4: Orientation](https://www.w3.org/WAI/WCAG22/Understanding/orientation.html)
- [CSS Transforms Module Level 1](https://www.w3.org/TR/css-transforms/#funcdef-transform-matrix)
Expand Down
2 changes: 1 addition & 1 deletion _rules/device-motion-disabled-c249d5.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ The [instruments][instrument] used to pass this rule (if any), must meet all lev

There are no accessibility support issues known.

### Bibliography
### Other Resources

- [Understanding Success Criterion 2.5.4: Motion Actuation][sc2.5.4]
- [G213: Provide conventional controls and an application setting for motion activated input](https://www.w3.org/WAI/WCAG22/Techniques/general/G213.html)
Expand Down
2 changes: 1 addition & 1 deletion _rules/device-motion-user-interface-7677a9.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ The [instruments][instrument] used to pass this rule (if any), must meet all lev

There are no accessibility support issues known.

### Bibliography
### Other Resources

- [Understanding Success Criterion 2.5.4: Motion Actuation][sc2.5.4]
- [G213: Provide conventional controls and an application setting for motion activated input](https://www.w3.org/WAI/WCAG22/Techniques/general/G213.html)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ Neither this rule, nor technique [H69: Providing heading elements at the beginni
- Having a heading for the non-repeated content is sufficient to pass [Success Criterion 2.4.1 Bypass blocks][sc241]. However, if headings are used for that goal, they will only benefit users who can actually navigate from heading to heading (such a functionality can be provided by browsers, browsers plugins, screen readers or other assistive technologies). Users without any possibility for headings navigation will be left without way of bypassing blocks of repeated content and will still experience accessibility issues. Therefore, it is recommended to provide other ways of bypassing blocks.
- When headings are rendered without sufficient visual cues, they are not perceived as headings by sighted users. In this case, passing this rule might still fail [Technique H69: Providing heading elements at the beginning of each section of content][h69] and [Success Criterion 2.4.1 Bypass blocks][sc241]. Additionally, this is likely a failure of [Success Criterion 1.3.1 Info and Relationships][sc131].

### Bibliography
### Other Resources

- [Understanding Success Criterion 2.4.1: Bypass Blocks][usc241]
- [H69: Providing heading elements at the beginning of each section of content][h69]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ This rule assumes that there is at least one [block of repeated content][] befor

There are no accessibility support issues known.

### Bibliography
### Other Resources

- [Technique G1: Adding a link at the top of each page that goes directly to the main content area][tech g1]
- [Technique G123: Adding a link at the beginning of a block of repeated content to go to the end of the block][tech g123]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Most of the time, this rule passes by enclosing the primary content of the page

Marking content with landmarks is sufficient to pass [Success Criterion 2.4.1 Bypass blocks][sc241]. However, this will only benefit users who can actually navigate using landmark roles (such a functionality is usually provided by assistive technologies, but could also be provided by browsers or browsers plugins). Users without any possibility for landmarks navigation will be left without way of bypassing blocks of repeated content and will still experience accessibility issues. Therefore, it is recommended to provide other ways of bypassing blocks.

### Bibliography
### Other Resources

- [Technique ARIA11: Using ARIA landmarks to identify regions of a page][tech aria11]
- [ARIA Landmarks Example](https://www.w3.org/TR/wai-aria-practices/examples/landmarks/index.html)
Expand Down
2 changes: 1 addition & 1 deletion _rules/element-lang-matches-default-language-off6ek.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ There are no accessibility support issues known.

- [_Element with `lang` Attribute Has Valid Language Tag_](https://www.w3.org/WAI/standards-guidelines/act/rules/de46e4/)

### Bibliography
### Other Resources

- [Understanding Success Criterion 3.1.2: Language of Page][usc312]
- [H58: Using language attributes to identify changes in the human language](https://www.w3.org/WAI/WCAG22/Techniques/html/H58)
Expand Down
2 changes: 1 addition & 1 deletion _rules/element-lang-valid-de46e4.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ For each test target, the `lang` [attribute value][] has a [known primary langua

There are differences in how assistive technologies handle unknown and invalid language tags. Some will default to the language of the page, whereas others will default to the closest ancestor with a valid lang attribute.

### Bibliography
### Other Resources

- [CSS Scoping Module Level 1 (editor's draft)](https://drafts.csswg.org/css-scoping/)
- [H58: Using language attributes to identify changes in the human language](https://www.w3.org/WAI/WCAG22/Techniques/html/H58)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Browser and assistive technology support for SVG `<title>` and `<desc>` elements

Until browser support for the [SVG Accessibility API Mappings][] is more consistent it is recommended to explicitly remove decorative `<svg>` elements from the accessibility tree.

### Bibliography
### Other Resources

- [Understanding Success Criterion 1.1.1: Non-text Content](https://www.w3.org/WAI/WCAG22/Understanding/non-text-content.html)
- [SVG Accessibility API Mappings (working draft)][svg accessibility api mappings]
Expand Down
2 changes: 1 addition & 1 deletion _rules/focusable-no-keyboard-trap-80af7b.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ There are no assumptions.

There are no accessibility support issues known.

### Bibliography
### Other Resources

- [Understanding Success Criterion 2.1.2: No Keyboard Trap](https://www.w3.org/WAI/WCAG22/Understanding/no-keyboard-trap.html)
- [G21: Ensuring that users are not trapped in content](https://www.w3.org/WAI/WCAG22/Techniques/general/G21)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ For each target element focus can cycle to the browser UI by using the method ad

Some browsers have settings that will immediately cycle focus back to the web document. This fulfills the expectation because focus can cycle to the browser UI and the browser UI cycles focus back to the web document.

### Bibliography
### Other Resources

- [Understanding Success Criterion 2.1.2: No Keyboard Trap](https://www.w3.org/WAI/WCAG22/Understanding/no-keyboard-trap.html)
- [G21: Ensuring that users are not trapped in content](https://www.w3.org/WAI/WCAG22/Techniques/general/G21)
Expand Down
Loading