Skip to content

Update permitted ARIA state or property for combobox role #2322

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

Open
wants to merge 7 commits into
base: develop
Choose a base branch
from
Open

Update permitted ARIA state or property for combobox role #2322

Changes from 3 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
90dc69d
update the rule for combobox role #rule-2311
shunguoy Apr 16, 2025
d0eba46
update the text #rule-2311
shunguoy Apr 16, 2025
6e61093
Update aria-state-or-property-permitted-5c01ea.md
shunguoy Apr 16, 2025
0e3efb5
Update _rules/aria-state-or-property-permitted-5c01ea.md
shunguoy May 1, 2025
b6139e5
update the required state and properties rule #rule-2311
shunguoy May 7, 2025
af583d9
Merge branch 'develop' into rule-2311
shunguoy May 7, 2025
da1650e
Update _rules/aria-state-or-property-permitted-5c01ea.md
shunguoy May 8, 2025
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
6 changes: 4 additions & 2 deletions _rules/aria-state-or-property-permitted-5c01ea.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,8 @@ The presence of prohibited ARIA attributes is often the result of a developer us

In HTML, there are language features that do not have corresponding implicit WAI-ARIA semantics. As per [ARIA in HTML](https://www.w3.org/TR/html-aria/), those elements can have [global states or properties][global]. Some of those elements can also have [inherited][], [supported][], or [required][] [states][state] or [properties][property] that correspond to a [WAI-ARIA role](https://www.w3.org/TR/wai-aria-1.2/#introroles). For example, the `audio` element has no corresponding ARIA semantics but it can have [inherited][], [supported][], or [required][] [states][state] or [properties][property] of the [`application` role](https://www.w3.org/TR/wai-aria-1.2/#application).

Note that required WAI-ARIA states or properties for a role may change with the advance of the WAI-ARIA specifications. For example, both aria-expanded and aria-controls were required in [ARIA 1.2](<[https://](https://www.w3.org/TR/wai-aria-1.2/#combobox)https://>) for combobox role, but the aria-controls was removed from required states or properties in [ARIA 1.3](<[https://](https://www.w3.org/TR/wai-aria-1.3/#combobox)https://>). The examples in this rule follow [ARIA 1.3](<[https://](https://www.w3.org/TR/wai-aria-1.3/#combobox)https://>).

Assessing the value of the attribute is out of scope for this rule.

### Assumptions
Expand Down Expand Up @@ -137,15 +139,15 @@ The `aria-expanded` [property][] is [required][] for the [semantic][semantic rol
The `aria-expanded` [property][] is [required][] for the [semantic][semantic role] `combobox`.

```html
<div role="combobox" aria-expanded="true" aria-controls="id1">My combobox</div>
<div role="combobox" aria-expanded="false" aria-controls="id1" aria-label="My combobox">My combobox</div>
```

#### Passed Example 8

The `aria-expanded` [property][] is [required][] for the [semantic][semantic role] `combobox`. [WAI-ARIA states and properties][wai-aria state or property] with `undefined` value are still applicable to this rule.

```html
<div role="combobox" aria-expanded="undefined" aria-controls="id1">My combobox</div>
<div role="combobox" aria-expanded="undefined" aria-controls="id1" aria-label="My combobox">My combobox</div>
```

#### Passed Example 9
Expand Down