Issue Bug Closed

#108492File tables – incorrect column headers announced for data cells (NVDA)

Jennifer Geiß 12/16/25, 09:04 updated 10/21/26, 12:11

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

  1. Oliver Bartsch commented and changed status New Needs Feedback <span data-processor="relativetime" data-value="2026-10-20T08:22:39+00:00" > 10/20/26, 08:22 </span>

    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 cells inside , the data rows are cells inside , and there are no ARIA roles or CSS display overrides on table elements that would break table semantics. A in is a column header even without scope=“col”. That also fits with JAWS announcing the headers correctly.

    To find what NVDA trips over, I need a few more details:
    • Browser and version (Firefox or Chrome/Edge?) and NVDA version
    • Which view: Media module list view or the file browser/element browser in a modal?
    • Which columns or cells are affected, and what NVDA announces compared to what you expect (e.g. “checkbox column has header ‘Open selection options’”, or “icon cell announces ‘Name’”)
    • How you navigate: NVDA announces column headers only with the table navigation commands (Ctrl+Alt+Arrow keys) and only when “Row/column headers” is enabled in the document formatting settings. It does not announce them when reading line by line with the arrow keys in browse mode.

    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

  2. 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.

  3. Garvin Hicking commented and changed status Needs Feedback Closed <span data-processor="relativetime" data-value="2026-10-21T12:11:36+00:00" > 10/21/26, 12:11 </span>

    closing as suggested