heading role (aria)
Screen Reader support level: supported
On this page
About this feature
A heading for a section of the page.
Age of results
Results across all tests for this feature range from 8 months ago to 5 years ago. Detailed dates and version information can be found in associated tests.
Expectations
Screen Reader support by expectation
Expectation | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
MUST convey its role and name | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
MUST convey its default level as 2 if aria-level is missing | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
MUST provide shortcuts to jump to headings | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Expectation: convey its role and name
Rationale:
The user needs to know that the element describes the following content and the name of the heading.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- When applied to a heading, the heading might be announced as something like "<name> heading level <level>"
Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
HTML and ARIA headings test (level 6 and below) | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
ARIA heading role with no aria-level attribute | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
ARIA headings greater than level 6 | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Expectation: convey its default level as 2 if aria-level is missing
Rationale:
The user needs to know the level of the heading if aria-level is missing.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- When applied to a heading, the heading might be announced as something like "<name> heading level <level>"
Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
ARIA heading role with no aria-level attribute | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Expectation: provide shortcuts to jump to headings
Rationale:
Headings provide an outline of the page and users need to be able to quickly navigate to different sections of the page.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
HTML and ARIA headings test (level 6 and below) | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
ARIA heading role with no aria-level attribute | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
ARIA headings greater than level 6 | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |