UI5 / webcomponents-react / 19140943021

85%

push

github

fix(AnalyticalTable): improve accessibility (#7879)

Fixes #7387
Fixes #5819

On entry:
- “[Table title] grid” (Table title if set, “Grid” by screen reader
reading the role)
- `data-component-name="AnalyticalTableContainer"`: role=grid,
aria-labelledby --> `header` prop
- Total row/col count: “Table contains 123 rows and 14 columns ”
- `data-component-name="AnalyticalTableContainer"`: aria-rowcount,
aria-colcount

Column headers navigation:
- “Header” plus header cell text
- role=columnheader, text (if not text content, can be defined via
`headerLabel`)
- Header cells may contain actions like sort. This should be also
announced.
- aria-expanded, aria-controls, aria-haspopup, for column header popover
  - Selection, Highlight & Navigation column header announcement
- Sort/Filter Status of row/columns must be indicated
  - sort: aria-sort
  - filter: aria-label="Filtered"
  - group: aria-label="Grouped"
- Header Hierarchies (level 1, 2 ..) must be announced
  - N.A.

Row/Cell navigation:
- Grid Cell Row/Col info = header text + position while arrowing through
grid
  - Header: 
- JAWS/NVDA: relation is made via roles (`columnheader` -> `gridcell`)
to prevent duplicate announcements (following wcag2.2 specs)
- VoiceOver: `aria-labelledby` pointing to column header id (workaround)
  - position: `aria-colindex`
- For tables with n rows, speech output should always be <row nr of n
rows>, no matter how many rows are visible. If n is not known, speech
output should always be <row nr>
- `aria-rowindex` -> is ignored by VoiceOver - NVDA reads it, if this
becomes an issue use live announcement via invisible messaging
- Focused cells: Role and label of cell content
  - `aria-labelledby`
- Interactive content: native in F5 hook, otherwise has to be defined
via `cellLabel` prop
- Selection state of cell/row must be announced
  - `aria-selected` + live announcement when state changes
- Group Header Rows in Table must be announced as such
  - "Grouped" is announced wh... (continued)

3264 of 4169 branches covered (78.29%)

Branch coverage included in aggregate %.

41 of 41 new or added lines in 6 files covered. (100.0%)

5741 of 6434 relevant lines covered (89.23%)

118791.06 hits per line