From bf8ce3f2547c9ab599db646783a1e5e7d802470b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=9B=B7=E7=94=B5=E8=8A=BD=E8=A1=A3?= Date: Thu, 1 Oct 2026 13:12:13 -0400 Subject: [PATCH] =?UTF-8?q?T48i=20Docs=20=C2=B7=20Overlays:=20only=20dialo?= =?UTF-8?q?gs,=20popovers=20and=20menus=20take=20focus;=20the=20close=20bu?= =?UTF-8?q?tton=20belongs=20to=20a=20fullscreen=20dialog?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- frontend/src/docs/overlays.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/frontend/src/docs/overlays.md b/frontend/src/docs/overlays.md index 505547a..d0df8b4 100644 --- a/frontend/src/docs/overlays.md +++ b/frontend/src/docs/overlays.md @@ -1,6 +1,6 @@ # Overlays -Dialogs, popovers, menus, tooltips and toasts draw over the page. Each takes focus while it is open and hands it back when it closes. +Dialogs, popovers, menus, tooltips and toasts draw over the page. Dialogs, popovers and menus take focus while open and hand it back when they close; tooltips and toasts leave focus alone. ## Drawing over the page @@ -14,10 +14,10 @@ Dialogs, popovers, menus, tooltips and toasts draw over the page. Each takes foc | --- | --- | | `.detail(text)` | A line under the title. | | `.child(..)` | The owner's content. | -| `.action(\|close\| ..)` | A button in the row at the bottom, in the order given. `build` gets the dialog's close; a button that ends the dialog calls it. | -| `.fullscreen()` | Fills the window below its title bar. | +| `.action(\|close\| ..)` | A button in the row at the bottom, in the order given. The closure gets the dialog's close; a button that ends the dialog calls it. | +| `.fullscreen()` | Fills the window below its title bar, under a bar with the title and a close button. | -Escape, a press on the scrim and the close button all run `on_close`. Tab stays inside the dialog, and focus returns to what held it before, on every way out. The card fits the window; its body scrolls and its actions stay. `AlertDialog`, `ConfirmDialog` and `PromptDialog` build on `Dialog`. +Escape, a press on the scrim and a fullscreen dialog's close button all run `on_close`. Tab stays inside the dialog, and focus returns to what held it before, on every way out. The card fits the window; its body scrolls and its actions stay. `AlertDialog`, `ConfirmDialog` and `PromptDialog` build on `Dialog`. ## Popovers