Skip to content

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

Draft
michelengelen wants to merge 12 commits into
mui:masterfrom
michelengelen:a11y/stack/vpat
Draft

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

Conversation

@michelengelen

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.


Stack position. Builds on #48925. Until that merges this PR's diff also
shows its ancestors — review only the final commit:
105fcde

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 added docs Improvements or additions to the documentation. accessibility a11y labels Aug 5, 2026
mj12albert and others added 12 commits August 5, 2026 15:45
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 `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