Important: This website does not attempt to establish a standard for how assistive technologies must behave. Read the FAQ for more information. Additionally, this is a work in progress. Please submit feedback or suggestions.

aria-level attribute (aria)

Screen Reader support level: partial (15/22)

On this page

About this feature

Defines the hierarchical level of an element within a structure.

Age of results

Results across all tests for this feature range from 10 months ago to 5 years ago. Detailed dates and version information can be found in associated tests.

Caution

Failing or partial results may be out of date. The oldest result is from 10 months ago. Consider running the associated tests and contributing results.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
MUST convey the presence and value of the aria-level attributepartial (1/2)partial (1/2)partial (1/2)partial (1/2)partial (1/2)partial (1/2)supportedsupportedpartial (1/2)supportedsupported

Expectation: convey the presence and value of the aria-level attribute

Rationale:

The user needs to know that the element has a level and the value of that level.

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>"
Screen Reader support for 'MUST convey the presence and value of the aria-level attribute'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
HTML and ARIA headings test (level 6 and below) applied to: heading rolesupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
ARIA headings greater than level 6 applied to: heading rolenonenonenonepartialpartialpartialsupportedsupportednonesupportedsupported