Skip to content

a11y: wide markdown table fails scrollable-region-focusable (keyboard access) #79

Description

@omars-lab

Finding

The axe-core a11y gate (make test-a11y, WCAG 2 A/AA) flags a serious scrollable-region-focusable violation on /initiatives/evolution-of-a-repo (both light + dark mode): a wide markdown <table> becomes horizontally scrollable but the scroll region has no keyboard access (a keyboard-only user can't scroll it).

Evidence

  • make test-a11y[serious] scrollable-region-focusable (1x): Scrollable region must have keyboard access on that page.
  • Pre-existing: reproduces on master with the original CSS (confirmed by stashing the theme branch and re-running) — NOT introduced by the tea-party theme change. Surfaced while verifying that theme.

Fix

Give the wide-table wrapper keyboard focusability: add tabindex="0" (+ an accessible name / role="region") to the scroll container Docusaurus wraps wide tables in, or constrain/reflow the table so it doesn't overflow. Likely a small swizzle of the table/markdown wrapper or a CSS overflow + tabindex via a rehype plugin (sibling of rehype-task-list-labels).

Source: the accessibility.spec.ts gate; surfaced 2026-06-25 during the theme re-color.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions