Drawer

v1.0.0·Added in 1.0.0

The library's bottom sheet on vaul: drag to dismiss, snap points, nesting, and a side panel or dialog on desktop.

Tap the trigger and the sheet slides up from the bottom on the iOS sheet curve while the page dims. Drag it down by the handle or anywhere on it and it follows your finger; let go past a quarter of its height, or flick it, and it closes, otherwise it settles back. A long list inside scrolls first and only drags the sheet once it is back at the top; the header hairline appears as soon as the list scrolls and the footer hairline while there is more below. Snap points stop it half open and a tap on the handle steps to the next point. A drawer opened from inside another one pushes the first one back, like iOS. Escape, a tap on the dim page or the close button close it, unless it is not dismissible. Opening moves focus to the sheet itself (no field pops the phone keyboard, Tab goes on to the first control; the desktop dialog focuses its first text field, or itself when there is none), keeps it inside while open and returns it to the trigger after. A shortcut, when set, toggles it from anywhere. From 768px it stays a centered sheet, or becomes a side panel from the right or a centered dialog, whichever desktop asks for. With reduced motion the sheet's slide ends in 200ms and the dialog only fades.