Skip to content

[docs] Add the accessibility conformance report page - #48926

Open
michelengelen wants to merge 13 commits into
mui:masterfrom
michelengelen:a11y/stack/vpat
Open

[docs] Add the accessibility conformance report page#48926
michelengelen wants to merge 13 commits into
mui:masterfrom
michelengelen:a11y/stack/vpat

Conversation

@michelengelen

@michelengelen michelengelen commented Aug 4, 2026

Copy link
Copy Markdown
Member

Adds a public accessibility conformance report at Getting started → Accessibility, answering #14187 (open since 2019, and explicitly a sales-enablement request).

It is a VPAT-style report of the library's WCAG 2.2 Level A/AA conformance, built from the per-component reports rather than written by hand. Every claim traces to a report in this series.

Includes the full Level A and AA criterion tables with remarks, the ● Component / ◐ Shared / ○ Author responsibility axis explained for procurement readers, and documented workarounds for each known gap.

It states its own limits up front, deliberately:

  • 12 components assessed, not the library — Select, Autocomplete, Dialog, Menu, Table and others are untouched
  • no assistive-technology testing has been performed
  • self-assessed, not externally audited
  • Section 508 and EN 301 549 chapters are not yet written

Those four are what still stand between this and something procurement can file, and they are worth discussing before this leaves draft.

Important

How to review this PR

Layer 13 of 13 in a stacked series (#48915#48926). Its branch is built on a11y/stack/scorecard (#48925). GitHub cannot chain PR bases across a fork, so every PR in the series targets master instead.

Review only the last commit1ab4a59. Everything above it belongs to the layers below, and disappears as those merge.

Part of the WCAG conformance effort (#14187).

@code-infra-dashboard

code-infra-dashboard Bot commented Aug 4, 2026

Copy link
Copy Markdown

Deploy preview

Bundle size

Bundle Parsed size Gzip size
@mui/material 0B(0.00%) 0B(0.00%)
@mui/lab 0B(0.00%) 0B(0.00%)
@mui/private-theming 0B(0.00%) 0B(0.00%)
@mui/system 0B(0.00%) 0B(0.00%)
@mui/utils 0B(0.00%) 0B(0.00%)

Details of bundle changes


Check out the code infra dashboard for more information about this PR.

@michelengelen
michelengelen marked this pull request as ready for review August 7, 2026 10:15
mj12albert and others added 13 commits August 7, 2026 14:58
Lets a fixture assert every axe rule it exercises rather than only the
CSS-dependent visual ones, which is what the per-component WCAG reports
need.
Adds a table-driven Playwright suite covering 1.4.10 Reflow, 1.4.4 Resize
Text and 1.4.12 Text Spacing across the assessed components. axe has no rule
for any of them, so they were rated Manual on evidence from source review.
Adds `pnpm a11y:scorecard`, which parses the count table out of every
`<Component>/accessibility.md`, regenerates the index table, and emits the
JSON that the public conformance page is built from. `--check` fails when
either output is stale so a new report cannot land without its rollup.
A VPAT-style report of the library's WCAG 2.2 A/AA conformance, built from
the per-component reports, for procurement and accessibility review. States
its own limits up front: partial component coverage, no assistive-technology
testing yet, and self-assessed rather than externally audited.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

accessibility a11y docs Improvements or additions to the documentation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants