Skip to content

[docs][Backdrop] Move Backdrop to Utils and clarify it is a low-level utility - #49072

Open
webernir wants to merge 2 commits into
mui:masterfrom
webernir:docs/backdrop-utils-nav
Open

[docs][Backdrop] Move Backdrop to Utils and clarify it is a low-level utility#49072
webernir wants to merge 2 commits into
mui:masterfrom
webernir:docs/backdrop-utils-nav

Conversation

@webernir

Copy link
Copy Markdown

Fixes #31371

Scope

Maintainer @mj12albert reframed this on 19 Apr 2026: the original report is a poor/unrealistic demo, not a library ARIA bug. Components that usually use a backdrop (Dialog, Modal) already include it. Typical apps should not use Backdrop directly.

This PR is docs-only. No Backdrop component runtime or ARIA changes.

Changes

  • Move Backdrop from Feedback to Utils in the Material UI docs nav (docs/data/material/pages.ts), next to Modal.
  • Update the Backdrop page so it describes Backdrop as a low-level utility normally used through Dialog/Modal, and note that the SimpleBackdrop demo is a low-level example.

Why not component ARIA

WCAG 4.1.2 on the standalone Backdrop demo is expected: Backdrop is a dimmed layer, not a dialog. Accessible overlay patterns already live on Dialog and Modal (focus trap, labeling, assistive tech). Adding generic ARIA onto Backdrop would be the wrong layer, which is why the 2023 component approach in #37202 was abandoned.

Test plan

  • Docs nav lists Backdrop under Utils, not Feedback
  • Backdrop page copy matches the maintainer's utility framing
  • No changes under packages/mui-material/src/Backdrop

@code-infra-dashboard

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.

@zannager zannager added the scope: backdrop This is the name of the generic UI component, not the React module! label Aug 31, 2026
@zannager
zannager requested a review from siriwatknp August 31, 2026 14:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

scope: backdrop This is the name of the generic UI component, not the React module!

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[docs][backdrop] Gives only visual feedback of state change, no communication to assistive tech

2 participants