Notice: This is a work in progress. Please submit feedback or suggestions.

grid role (aria)

Screen reader support level: partial (22/40)

Voice Control support level: unknown

On this page

About this feature

A composite widget containing a collection of one or more rows with one or more cells where some or all cells in the grid are focusable by using methods of two-dimensional navigation, such as directional arrow keys.

Age of results

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

Failing and partial results are between 2 years ago and 2 years ago.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
MUST convey its namepartialpartialpartialsupportedpartialpartialsupportedsupportedsupportednonesupported
MUST convey its rolesupportedsupportedsupportedsupportedpartialpartialpartialpartialsupportednonepartial
SHOULD switch to interaction modepartialpartialpartialnonepartialpartialpartialpartialnot applicablenot applicablenot applicable
MUST convey boundariessupportedsupportedsupportedsupportedsupportedsupportedsupportedpartialsupportednonesupported

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
Not applicable

Expectation: convey its name

Rationale:

A user needs to know the name of the grid so that they understand what it is for

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • A screen reader might announce the name when entering the grid
Screen Reader support for 'MUST convey its name'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
ARIA readonly gridpartialpartialpartialsupportedpartialpartialsupportedsupportedsupportednonesupported

Expectation: convey its role

Rationale:

A screen reader user needs to be aware that they are entering a grid so that they know that grid keyboard commands are available.

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • Screen readers might convey the role as something like "grid"
Screen Reader support for 'MUST convey its role'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
ARIA readonly gridsupportedsupportedsupportedsupportedpartialpartialpartialpartialsupportednonepartial

Expectation: switch to interaction mode

Rationale:

Grids are usually navigated via arrow keys, so those keys presses need to be sent directly to the browser and not intercepted by the screen reader.

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: SHOULD
  • Voice Control: NA

Examples:

  • Screen readers might convey an earcon when the mode switches
  • Arrow keys will work for navigation without manually switching modes
Screen Reader support for 'SHOULD switch to interaction mode'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
ARIA readonly gridpartialpartialpartialnonepartialpartialpartialpartialnot applicablenot applicablenot applicable

Expectation: convey boundaries

Rationale:

Screen reader users need to know when they enter and exist a grid

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • Screen readers might say something like "entering grid" and "exiting grid"
Screen Reader support for 'MUST convey boundaries'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
ARIA readonly gridsupportedsupportedsupportedsupportedsupportedsupportedsupportedpartialsupportednonesupported