Close only the topmost layer on Escape, and keep a layer opened over a sheet readable

A modal side sheet, bottom sheet or the modal rail closed on any Escape
the window heard, so a dialog opened from a sheet, a menu, select list
or searchable choice inside one, a sheet opened from a sheet, and a
sheet inside a dialog each closed two layers on one press. And a dialog
or a second sheet rendered elsewhere on the page sat inside the
`aria-hidden` the first sheet's `x-trap.inert` put on its siblings, so a
screen reader could not read it, while the sheet's focus trap took every
Tab inside the dialog back to the inert sheet.

resources/js/layers.js adds `x-layer`, on each of those panels beside
its `x-trap`. An Escape is the panel's only when nothing has handled it
and the nearest open layer around its target is the panel itself - not
an open dialog, popover or customizable select, nor a panel inside it;
the panel claims it with preventDefault(), which also keeps a dialog
around it from cancelling, and dispatches `material-escape`, which the
views close on. A panel that opens lifts `aria-hidden` from its own
ancestors and puts it back on close only where a panel still open hides
them; materialShowModal() does the same for `<x-modal>`, whose new
`x-trap.noautofocus.noreturn` pauses the sheet's focus trap while it is
open and moves no focus of its own. The searchable choice, the search
view and the supporting pane's sheet now preventDefault() the Escape
they act on, so the dialog or sheet around them stays.

Four browser tests stack the layers every way above and fail without
the change in Chrome.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Andreas Reinhold / reini
2026-09-17 05:59:32 +02:00
co-authored by Claude Opus 5
parent 029c78d301
commit 94a376a4fd
15 changed files with 360 additions and 10 deletions
+8
View File
@@ -41,6 +41,14 @@
customizable `<x-select>` while its menu is open. An open select in error now draws `error`
rather than `primary`. A test that read the hover colour off a focused field reads `primary`
now.
- **Escape closes one layer.** A dialog, menu, customizable select or searchable choice opened
over or inside a modal `<x-drawer>`, `<x-bottom-sheet>` or modal navigation rail — or a sheet
opened from a sheet, or inside `<x-modal>` — closed the layer under it on the same Escape, since
each sheet closed on any Escape the window heard. Now only the topmost layer closes; a sheet
with `close-on-escape` off still keeps the Escape from closing what is under it. A dialog or
sheet opened from a modal sheet but rendered elsewhere on the page was also hidden from screen
readers by the sheet's `aria-hidden`, and Tab could not move inside the dialog; both work now.
An application's own guard around a sheet's Escape can go.
## From 2.0.0 to 2.1.0