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-rowcount attribute (aria)

Screen Reader support level: partial (8/22)

On this page

About this feature

Defines the total number of rows in a table, grid, or treegrid. See related aria-rowindex.

Age of results

Results across all tests for this feature range from 2 years ago to 2 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 2 years 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 total row count when some rows are hiddensupportedsupportedsupportedsupportedsupportedsupportedsupportedunknownnonenonesupported
MUST NOT convey a row count when total row count is unknownnonenonenonenonenonenonenoneunknownnonenonenone

Expectation: convey the total row count when some rows are hidden

Rationale:

The user needs to know how many rows are in the whole grid / table when some rows are hidden

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey the total row count when some rows are hidden'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-rowcount attributesupportedsupportedsupportedsupportedsupportedsupportedsupportedunknownnonenonesupported

Expectation: convey a row count when total row count is unknown

Rationale:

Screen readers should not attempt to calculate the row count when it is unknown

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST NOT
  • Voice Control: NA

Notes:

ARIA 1.1 spec: "If the total number of rows is unknown, authors MUST set the value of aria-rowcount to -1 to indicate that the value should not be calculated by the user agent."

Screen Reader support for 'MUST NOT convey a row count when total row count is unknown'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-rowcount attributenonenonenonenonenonenonenoneunknownnonenonenone