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

Add accessibility support note about aria-busy to all rules with accessibility tree as input aspect #2160

Open
wants to merge 2 commits into
base: develop
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
1 change: 1 addition & 0 deletions _rules/aria-required-context-role-ff89c9.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@ The rule assumes that the [explicit role][] of the applicable elements is approp
- User agents do not all have the same accessibility tree. This can lead to different results for this rule, depending on which accessibility tree is used as input.
- `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.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
1 change: 1 addition & 0 deletions _rules/aria-required-owned-element-bc4a75.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@ If the [explicit semantic role][] on the target element is incorrectly used, and
- `aria-owns` has limited support in some user agents.
- 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.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
3 changes: 2 additions & 1 deletion _rules/aria-state-or-property-permitted-5c01ea.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,8 @@ There are no assumptions.

## Accessibility Support

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 their attributes fail this rule with some technologies but users of other technology would not experience any accessibility issue.
- 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 their attributes fail this rule with some technologies but users of other technology would not experience any accessibility issue.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
1 change: 1 addition & 0 deletions _rules/autocomplete-valid-value-73f2c2.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,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.
- Some user agents treat the value of the `aria-disabled` attribute as case-sensitive.
- In some user agents, querying the value of the `autocomplete` property returns an empty string ("") even when the attribute was set according to the rule's expectations. It affects assistive technologies which rely on this property to personalize input fields collecting information about the user.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

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 @@ -40,7 +40,7 @@ There are no assumptions.

## Accessibility Support

There are no accessibility support issues known.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

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 @@ -37,8 +37,8 @@ Each target element has an [accessible name][] that is not empty (`""`).
## Accessibility Support

- 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 `button` and fail this rule with some technology but users of other technologies would not experience any accessibility issue.

- Some elements have a role of `button` and a default accessible name defined by the [HTML Accessibility API Mapping][html aam input button], for example `input` elements whose `type` [attribute value][] is either `submit` or `reset`. This rule considers that these default names can be descriptive and therefore does not fail them.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

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 @@ -49,7 +49,7 @@ For each registered [device orientation event][device orientation] or [device mo

## Accessibility Support

There are no accessibility support issues known.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

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 @@ -46,7 +46,7 @@ For each registered [device orientation event][device orientation] or [device mo

## Accessibility Support

There are no accessibility support issues known.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,7 @@ In each test target, either there is no [non-repeated content after repeated con

- 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].
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ This rule assumes that there is at least one [block of repeated content][] befor

## Accessibility Support

There are no accessibility support issues known.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,8 @@ Within each test target, either there is no [non-repeated content after repeated

## Accessibility Support

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.
- 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.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

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 @@ -54,7 +54,7 @@ For each test target, the [primary language][] of its `lang` [attribute value][]

## Accessibility Support

There are no accessibility support issues known.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
3 changes: 2 additions & 1 deletion _rules/element-lang-valid-de46e4.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,8 @@ For each test target, the `lang` [attribute value][] has a [known primary langua

## Accessibility Support

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.
- 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.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
3 changes: 2 additions & 1 deletion _rules/element-marked-decorative-is-not-exposed-46ca7f.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,8 @@ There are no assumptions.

## Accessibility Support

Implementation of the [Presentational Roles Conflict Resolution][] differs slightly from one user agent to the other. Hence, some elements might be exposed by one user agent and not by another, and consequently might create accessibility issues only for some users. Nevertheless, triggering the conflict is a bad practice.
- Implementation of the [Presentational Roles Conflict Resolution][] differs slightly from one user agent to the other. Hence, some elements might be exposed by one user agent and not by another, and consequently might create accessibility issues only for some users. Nevertheless, triggering the conflict is a bad practice.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
1 change: 1 addition & 0 deletions _rules/form-field-label-descriptive-cc0f0a.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,7 @@ Each test target, together with its [visual context][], describes the purpose of
## Accessibility Support

- Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some elements can have one of the applicable [semantic roles][semantic role] and fail this rule with some technology but users of other technologies would not experience any accessibility issue.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
1 change: 1 addition & 0 deletions _rules/form-field-non-empty-accessible-name-e086e5.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@ There are no assumptions.

- Several assistive technologies have a functionality to list all form fields on a page, including the `disabled` ones. Therefore this rule is still applicable to `disabled` form fields. If an assistive technology consistently ignores `disabled` form fields in all its interactions, then it is possible to have a `disabled` form field with no accessible name without creating accessibility issues for the user.
- Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some elements can have one of the applicable [semantic roles][] and fail this rule with some technology but users of other technologies would not experience any accessibility issue.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
3 changes: 2 additions & 1 deletion _rules/heading-descriptive-b49b2e.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,8 @@ This rule also assumes that the content the heading is intended to describe is [

## Accessibility Support

Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some [semantic][semantic role] `heading` elements can fail this rule with some technology but users of other technologies would not experience any accessibility issue.
- Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some [semantic][semantic role] `heading` elements can fail this rule with some technology but users of other technologies would not experience any accessibility issue.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
3 changes: 1 addition & 2 deletions _rules/heading-non-empty-accessible-name-ffd0e9.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,10 +38,9 @@ There are no assumptions.
## Accessibility Support

- Some assistive technologies may hide headings with empty [accessible name][] from the users. This depends on the user agent, on how the [accessible name][] was computed (the [accessible name and description computation][] is not clear concerning which characters should be trimmed), and on the assistive technology itself. Hence, there are cases where the outcome of this rule is _failed_, but users of certain assistive technology and browser combinations will not experience an issue.

- Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some [semantic][semantic role] `heading` elements can fail this rule with some technology but users of other technologies would not experience any accessibility issue because the same elements would have a [semantic role][] of `presentation` and be hidden for these users.

- The [accessible name and description computation][] suggests that if an `aria-labelledby` attribute refers to an existing but empty element, the computation should stop and return an empty name without defaulting to the next steps. Several user agents and assistive technologies chose to use the next step in the computation in this case (ultimately defaulting to the content).
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
2 changes: 1 addition & 1 deletion _rules/html-page-lang-matches-default-ucwvc8.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ For each test target, the [known primary language tag][] of its `lang` attribute

## Accessibility Support

There are no accessibility support issues known.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
3 changes: 2 additions & 1 deletion _rules/image-accessible-name-descriptive-qt1vmo.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,8 @@ There are no assumptions.

## Accessibility Support

Some popular browser / screen reader combinations do not pronounce the accessible names of `svg` elements. This can be resolved by adding an [explicit semantic role][] of `img` to the `svg` element.
- Some popular browser / screen reader combinations do not pronounce the accessible names of `svg` elements. This can be resolved by adding an [explicit semantic role][] of `img` to the `svg` element.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
2 changes: 1 addition & 1 deletion _rules/image-filename-as-accessible-name-9eb3f6.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ There are no assumptions.

## Accessibility Support

There are no accessibility support issues known.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
1 change: 1 addition & 0 deletions _rules/image-non-empty-accessible-name-23a2a8.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,7 @@ There are no assumptions.
- There are several popular browsers that do not treat images with an empty `alt` attribute (`alt=""`) as having a role of `presentation` but instead add the `img` element to the accessibility tree with a [semantic role][] of either `img` or `graphic`.
- Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some [semantic][semantic role] `img` elements can fail this rule with some technology but users of other technologies would not experience any accessibility issue.
- Images can have their role set to `presentation` through an empty `alt` attribute. [Presentational Roles Conflict Resolution][] does not specify what to do if such an image is [focusable][] (it only specifies what to do in case of explicit `role="none"` or `role="presentation"`). Some browsers expose these images and some don't. Thus, this rule may fail for technologies that expose these without creating an accessibility issue for users of other technologies.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
2 changes: 1 addition & 1 deletion _rules/image-not-in-acc-tree-is-decorative-e88epe.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ Each test target is [purely decorative][].

## Accessibility Support

There are no accessibility support issues known.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
1 change: 1 addition & 0 deletions _rules/link-alone-descriptive-aizyf1.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,7 @@ Each test target has an [accessible name][] which describes its purpose.
## Accessibility Support

- Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some [semantic][semantic role] `link` elements can fail this rule with some technology but users of other technologies would not experience any accessibility issue.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
1 change: 1 addition & 0 deletions _rules/link-in-context-descriptive-5effbb.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,7 @@ The [accessible name][] of each target element together with its [programmatical
## Accessibility Support

- Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some [semantic][semantic role] `link` elements can fail this rule with some technology but users of other technologies would not experience any accessibility issue.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
1 change: 1 addition & 0 deletions _rules/link-non-empty-accessible-name-c487ae.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@ The rule assumes that all links are [user interface components](https://www.w3.o
- For `area` elements that have an `href` attribute, but are not nested inside a `map` element, there are differences between browsers and assistive technology on if the `area` is [included in the accessibility tree][].
- Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some [semantic][semantic role] `link` elements can fail this rule with some technology but users of other technologies would not experience any accessibility issue.
- Accessibility support for some elements inheriting the semantic role of `link` (e.g. elements with `doc-*` attributes) may vary depending on the assistive technology in use.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
1 change: 1 addition & 0 deletions _rules/links-identical-name-equivalent-purpose-b20e66.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@ When followed, the links in each set of target elements resolve to the [same res

- This rule assumes that assistive technologies are exposing all links on the page in the same way no matter which [document tree](https://dom.spec.whatwg.org/#document-trees) they are in. If an assistive technology requires the user to "enter" an `iframe` or a [shadow tree][] before exposing its links, then it is possible for two links to have identical name but resolve to different resources without failing [Success Criterion 2.4.9 Link Purpose (Link Only)][sc249] (if said links are in separate [documents][document] or [shadow trees][shadow tree]).
- Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some [inheriting semantic][] `link` elements can fail this rule with some technology but users of other technologies would not experience any accessibility issue.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
3 changes: 2 additions & 1 deletion _rules/menuitem-non-empty-name-m6b1q3.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,8 @@ This rule assumes that all menuitems are [user interface components as defined b

## Accessibility Support

Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some [semantic][semantic role] `menuitem` elements can fail this rule with some technology but users of other technologies would not experience any accessibility issue.
- Implementation of [Presentational Roles Conflict Resolution][] varies from one browser or assistive technology to another. Depending on this, some [semantic][semantic role] `menuitem` elements can fail this rule with some technology but users of other technologies would not experience any accessibility issue.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
2 changes: 1 addition & 1 deletion _rules/non-visual-reference-alternative-9bd38c.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ This rule assumes that [visual reference words][] are forms of information conve

## Accessibility Support

There are no accessibility support issues known.
- `aria-busy` exists but, currently, is not widely supported, so the rule ignores it.

## Background

Expand Down
Loading
Loading