#108492File tables – incorrect column headers announced for data cells (NVDA)
Description
Context/Background:
The file table is visually correct (columns, rows, headers present). Testing with NVDA shows wrong or missing column header announcements for data cells. With JAWS 2022, this issue does not occur.
Problem:
Semantic associations between header cells and data cells are missing or incorrect. Screen reader users do not get the correct column context when navigating; in some cases, cell content is announced without context or not announced at all.
Compliance:
BITV 1.3.1 (Info and Relationships) and 4.1.2 (Name, Role, Value) are not met. WCAG 2.1: 1.3.1 Info and Relationships, 4.1.2 Name, Role, Value.
Observation: Non-interactive, purely informational cells are rightly skipped by Tab. The issue is the missing semantic linkage of content to its column headers.
Goal and Business Value
Correct semantic markup of the table so screen readers reliably announce the appropriate column headers for each data cell. Improves accessibility, compliance (BITV/WCAG), and usability.
Scope
- Mark table headers with th and scope=“col”; row headers (if any) with th and scope=“row”.
- Ensure each td is correctly associated with its th via native table semantics.
- For interactive elements inside cells (e.g., buttons/links), compose accessible names via aria-labelledby referencing both the column header and the cell content (e.g., “Size 4 files”).
- Avoid ARIA roles/attributes that break native table semantics (no role=“grid” unless fully implemented).
Definition of Done (DoD)
- th/td structure with proper scope/headers implemented; NVDA announces correct column headers.
- Interactive elements have meaningful accessible names via aria-labelledby.
- Tests run: NVDA, JAWS 2022, VoiceOver; no regression.
- Documentation in component/frontend guide.
- PO sign-off; WCAG/BITV checks 1.3.1 and 4.1.2 passed.
Reviews 0
No change resolves or names this issue in its commit message, and no comment links one.
History 4
-
Benni Mack changed Sprint Focus On Location Sprint <span data-processor="relativetime" data-value="2026-08-06T16:02:45+00:00" > 08/06/26, 16:02 </span>
-
Oliver Bartsch commented and changed status
NewNeeds Feedback <span data-processor="relativetime" data-value="2026-10-20T08:22:39+00:00" > 10/20/26, 08:22 </span> -
Christian Rath-Ulrich commented <span data-processor="relativetime" data-value="2026-10-20T09:51:53+00:00" > 10/20/26, 09:51 </span>
That doesn’t seem to be a problem anymore in the current core; NVDA reads all columns and rows correctly in table mode. I would close the ticket since the test refers to version 13.
-
Garvin Hicking commented and changed status
Needs FeedbackClosed <span data-processor="relativetime" data-value="2026-10-21T12:11:36+00:00" > 10/21/26, 12:11 </span>closing as suggested
Hey,
thanks for testing the file list with screen readers.
I looked at the markup in the current main branch. The list view is a plain native table: the header row is made of
Some details in the markup could be involved: the icon column has no header of its own (the “Name” header spans the icon and name columns), and the checkbox column header is just an icon button labelled “Open selection options”. If your findings point there, I’ll push a patch that gives these columns proper header text and adds scope=“col”.
Thanks, Oli