Show no tooltip on the control a sheet or dialog focuses as it opens

A modal side sheet, bottom sheet and the modal rail move the focus to
their first control as they open (x-trap), and `<x-modal>` does in
`showModal()`. On a page loaded with the sheet already open (a
`wire:model` set from `?workout=` in the URL) the browsers count that
focus as `:focus-visible`, and so they do for a sheet or dialog opened
from the keyboard, so tooltip.js showed the close button's "Close"
tooltip the moment the layer appeared, over its title, with no keyboard
use. Confirmed in Chrome, Firefox and Safari for the deep-linked sheet
and a full-screen dialog opened with Enter; a deep-linked `<x-modal>`'s
own focus was not counted as keyboard focus. M3 lets a tooltip appear
on hover or focus and says nothing that asks for one on a focus the
component moves itself.

layers.js gains `openingFocus(event)`: a focus is a modal layer's own
when the nearest open dialog, `aria-modal` panel or modal rail around
its target is entered from outside it, or from nowhere, and no Tab is
moving it (a Tab moves the focus while its keydown is handled, by the
browser or by focus-trap wrapping round the panel). tooltip.js and
rich-tooltip.js leave such a focus out; focus moved within the layer,
a Tab onto the control and a focus returned to it from a menu inside
still show the tooltip. The docblocks, the skill and UPGRADE.md say so.

A browser test loads a page with a modal sheet open at 393px, opens a
full-screen dialog and a dialog whose first control is a rich tooltip's
trigger from the keyboard, and checks that no tooltip is up on the
focused control, then that Tab wrapping round to the close button shows
its tooltip; it fails without the change in Chrome, Firefox and Safari,
each part on its own.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Andreas Reinhold / reini
2026-09-17 07:16:32 +02:00
co-authored by Claude Opus 5
parent 16c52d46e9
commit b62c83f244
8 changed files with 170 additions and 8 deletions
+43
View File
@@ -29,6 +29,12 @@
* (materialShowModal(), dialog.js); a modal `<dialog>` keeps the rest of the page from assistive
* technology itself, and its own `x-trap` pauses the focus trap of the panel under it, whose Tab
* would otherwise pull the focus back to an inert sheet.
*
* **The focus a layer moves.** A modal panel, `<x-modal>` and the modal rail move the focus to
* their first control as they open (x-trap, `showModal()`), and on a page loaded with the layer
* open, or opened from the keyboard, the browser counts that as `:focus-visible`. `openingFocus()`
* tells that focus apart from a person's, so a tooltip does not stand over a sheet's close button
* the moment the sheet appears (tooltip.js, rich-tooltip.js).
*/
/** Everything that can hold an Escape before the window hears it, nearest first. */
@@ -62,6 +68,43 @@ const isOpen = (layer) => {
return true
}
/** The layers that move the focus into themselves as they open. */
const MODAL_LAYERS = 'dialog, [aria-modal="true"], [data-md-navigation-rail-panel]'
/**
* Whether a Tab is moving the focus: the browser moves it while the keydown is handled, and so does
* focus-trap when it takes a Tab round a panel, so a focus that lands before the next task is the
* Tab's.
*/
let tabbing = false
document.addEventListener('keydown', (event) => {
if (event.key === 'Tab') {
tabbing = true
setTimeout(() => (tabbing = false))
}
}, true)
/**
* Whether a `focusin` is an open modal layer moving the focus into itself (see the header): the
* focus arrives from outside the nearest open layer around its target, or from nowhere, and no Tab
* is moving it. Focus moved within the layer, and a Tab that focus-trap brings back to its first
* control, are a person's.
*/
export const openingFocus = (event) => {
if (tabbing || !(event.target instanceof Element)) {
return false
}
let layer = event.target.closest(MODAL_LAYERS)
while (layer !== null && !isOpen(layer)) {
layer = layer.parentElement?.closest(MODAL_LAYERS) ?? null
}
return layer !== null && !(event.relatedTarget instanceof Node && layer.contains(event.relatedTarget))
}
/** Whether an Escape keydown is this open panel's to act on (see the header). */
const owns = (panel, event) => {
if (event.defaultPrevented) {