diff --git a/docs/data/material/components/backdrop/backdrop.md b/docs/data/material/components/backdrop/backdrop.md index 0f932e3a56fa2c..87674b8bec57b2 100644 --- a/docs/data/material/components/backdrop/backdrop.md +++ b/docs/data/material/components/backdrop/backdrop.md @@ -8,18 +8,21 @@ githubSource: packages/mui-material/src/Backdrop # Backdrop -
The Backdrop component narrows the user's focus to a particular element on the screen.
+The Backdrop component is a low-level utility that adds a dimmed layer over the application.
-The Backdrop signals a state change within the application and can be used for creating loaders, dialogs, and more. -In its simplest form, the Backdrop component will add a dimmed layer over your application. +Backdrop is normally used through higher-level components such as [Dialog](/material-ui/react-dialog/) and [Modal](/material-ui/react-modal/), which already include it and handle focus and assistive technology. + +Most apps should not use Backdrop directly. Reach for it only when you need a custom overlay (for example a full-screen loader you fully control). {{"component": "@mui/internal-core-docs/ComponentLinkHeader"}} ## Example -The demo below shows a basic Backdrop with a Circular Progress component in the foreground to indicate a loading state. +The demo below is a low-level example: a basic Backdrop with a Circular Progress component in the foreground to indicate a loading state. After clicking **Show Backdrop**, you can click anywhere on the page to close it. +For loading and overlay UI that must communicate state to assistive technology, prefer Dialog or Modal, which already manage the backdrop. + {{"demo": "SimpleBackdrop.js"}} ## Transitions diff --git a/docs/data/material/pages.ts b/docs/data/material/pages.ts index f98fc7ea8c8a92..ec0b000cac48e7 100644 --- a/docs/data/material/pages.ts +++ b/docs/data/material/pages.ts @@ -72,7 +72,6 @@ const pages: MuiPage[] = [ subheader: 'feedback', children: [ { pathname: '/material-ui/react-alert' }, - { pathname: '/material-ui/react-backdrop' }, { pathname: '/material-ui/react-dialog' }, { pathname: '/material-ui/react-progress' }, { pathname: '/material-ui/react-skeleton' }, @@ -130,6 +129,7 @@ const pages: MuiPage[] = [ title: 'InitColorSchemeScript', }, { pathname: '/material-ui/react-modal' }, + { pathname: '/material-ui/react-backdrop' }, { pathname: '/material-ui/react-no-ssr', title: 'No SSR' }, { pathname: '/material-ui/react-popover' }, { pathname: '/material-ui/react-popper' },