aria-colcount attribute (aria)
Screen Reader support level: partial (7/22)
On this page
About this feature
Defines the total number of columns in a table, grid, or treegrid. See related aria-colindex.
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
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 the total column count when some columns are hidden | supported | supported | supported | supported | supported | supported | supported | unknown | none | none | none |
| MUST NOT convey a column count when total column count is unknown | none | none | none | none | none | none | none | unknown | none | none | none |
Expectation: convey the total column count when some columns are hidden
Rationale:
The user needs to know how many columns are in the whole grid / table when some columns are hidden
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 | |
| aria-colcount attribute | supported | supported | supported | supported | supported | supported | supported | unknown | none | none | none |
Expectation: convey a column count when total column count is unknown
Rationale:
Screen readers should not attempt to calculate the column 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 columns is unknown, authors MUST set the value of aria-colcount to -1 to indicate that the value should not be calculated by the user agent."