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.

note role (aria)

Screen Reader support level: partial (7/33)

On this page

About this feature

A section whose content is parenthetic or ancillary to the main content of the resource.

Age of results

Results across all tests for this feature range from 7 days ago to 7 days ago. Detailed dates and version information can be found in associated tests.

Failing and partial results are between 7 days ago and 7 days ago.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
MUST convey its rolesupportedsupportedunknownnonenonenonenoneunknownunknownunknownsupported
MUST convey its namenonenoneunknownnonenonenonenoneunknownunknownunknownsupported
MUST convey boundariessupportedsupportedunknownnonenonenonenoneunknownunknownunknownsupported

Expectation: convey its role

Rationale:

Users need to be aware of the note context

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • A screen reader might announce an element as something like "<name>, <role>"
  • A screen reader might imply the role by the presence of certain context roles
  • Voice Control software might let the user say something like "click, <role>".
  • Voice Control software might let the user say something like "show numbers", and interactive roles will be flagged with numbers.
Screen Reader support for 'MUST convey its role'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
named note role applied to: div elementsupportedsupportedunknownnonenonenonenoneunknownunknownunknownsupported

Expectation: convey its name

Rationale:

convey the name of the note

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey its name'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
named note role applied to: div elementnonenoneunknownnonenonenonenoneunknownunknownunknownsupported

Expectation: convey boundaries

Rationale:

Users need to know when they enter and exit a note so that they can differentiate it from surrounding content.

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • Screen readers might announce the starting boundary by conveying the role.
  • Screen readers might announce the ending boundary by conveying something like "leaving note".
Screen Reader support for 'MUST convey boundaries'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
named note role applied to: div elementsupportedsupportedunknownnonenonenonenoneunknownunknownunknownsupported