Overview
The Drawer block is a panel that slides in over the page — from the side on desktop, from the bottom on mobile by default. It comes in two variants: Card (you compose its header, body, and footer) and Page (it embeds another page with inputs you pass in). A drawer starts closed and is opened by the Control drawer action or its Show method.


Note: New Card drawers arrive pre-assembled with a title header and a footer holding Cancel and Confirm buttons. Customize slot content by dropping blocks into each slot.
For a centered dialog that blocks the whole page instead of sliding in from an edge, see Modal.
Drawer Variants
| Variant | What it shows | Use case |
| Card | Three slots: Header, Body, Footer — each holds one block (Stack by default) | Edit forms, detail views, custom composed layouts |
| Page | Embeds an existing app page with Page Inputs you bind | Reusing detail pages as overlays, drill-down navigation between drawers |
Content Properties
Property | Type | Default | Appears When | Description |
|---|---|---|---|---|
variant | "card" | "page" |
| Always | Whether to show composed Card slots or an embedded Page |
pageId | page reference | — | variant = page | The app page to embed. Only static-path pages are selectable |
inputs | object (bindable) | — | variant = page | Values passed to the embedded page's inputs (e.g., selected row ID) |
slots | header, body, footer | Title header + Cancel/Confirm footer | variant = card | The three layout areas of a Card drawer |
containerId | block reference | page root | Always | Which part of the page the drawer overlays. Default: whole page |
hideOnClickOutside | boolean |
| Always | Close the drawer when user clicks outside it |
allowResize (Enable Resizing) | boolean |
| Always | Let users resize the drawer |
dragDownToClose | boolean |
| position = Bottom | Let users swipe down to dismiss the drawer |
interactions | event list | — | Always | On Open, On Close, On Collapse, On Expand and (for Bottom drawers) On Snap Index Change event handlers |
permissions | permission rule | — | Always | Restrict who can see or use the drawer |
Appearance Properties
Property | Type | Default | Description |
|---|---|---|---|
position | Start | End | Bottom | End (desktop), Bottom (mobile) | Which edge the drawer slides in from. All three positions are offered on every device; a Bottom drawer shows as a bottom sheet, on desktop too |
defaultWidth | px or % | 38.2% | Width of Start/End positioned drawers |
heightMode (Height) | Fixed Height | Snap Position | Fixed Height | For Bottom drawers: a fixed height, or a sheet that rests at snap points |
defaultHeight | px or % | 61.8% (mobile) | Height of a Bottom drawer in Fixed Height mode |
snapPoints (Snap Points) | list of px or % values | 30%, 60%, 100% (30% initial) | The heights a Bottom drawer in Snap Position mode can rest at; one is marked as the initial position |
type | "fixed" | "floating" | fixed | Floating insets the drawer from screen edges with rounded corners |
backdrop.showBackdrop | boolean | false | Dims the page behind the drawer |
backdrop.backdropStyles | color + blur (0–20) | backdrop color, blur 8 | Backdrop tint and blur intensity. High blur can hurt performance on low-end devices |
visibility | condition | — | Show/hide the block itself |
Events
Event | Trigger | Payload |
|---|---|---|
On Open | The drawer opens (content appears) | — |
On Close | The drawer closes (content removed) | — |
On Collapse | The drawer is collapsed | — |
On Expand | The drawer is expanded | — |
On Snap Index Change | A Bottom drawer moves to a different snap point (Bottom position only) | — |
Methods
Method | Parameters | What it does |
|---|---|---|
Show | — | Opens the drawer |
Hide | — | Closes the drawer |
Snap to Index | index (starting at 1) | Moves a Bottom drawer in Snap Position mode to the given snap point |
Call these via a Trigger Component Method action or the Control drawer action. They can also be called directly from a script at the block's own name.
Exposed State
State key | Type | Description |
|---|---|---|
| boolean | True while the drawer is on screen. Starts false and changes only with the Show and Hide methods. |
| number | Bottom drawers only: the snap point the sheet is resting on, counting from 1. |
Behaviors & Gotchas
Warning: A closed drawer doesn't exist: While closed, the drawer and all blocks inside it are removed from the page entirely. Blocks inside have no state, bindings resolve to nothing, and data sources don't run. Each open starts fresh — forms inside a drawer won't remember prior input.
Warning: Hide-on-click-outside locks the backdrop toggle: With Hide on Click Outside on, Show Backdrop is locked. The drawer places a transparent backdrop to catch outside clicks — meaning the first click outside closes the drawer but does NOT reach elements under it.
Note: Only static-path pages can be embedded: The Page variant only shows pages with static paths. Pass record IDs through Page Inputs rather than URL segments.
Note: One drawer at a time: Opening a second drawer closes the first. Drawers only stack when the opener is itself a page embedded inside a drawer (drill-down pattern).
Note: Start/End positions flip in RTL: In right-to-left locales, End slides from the left, Start from the right.
Note: Mobile default is a bottom sheet: The mobile variant defaults to Position = Bottom, 61.8% height, Drag Down to Close enabled.
Examples & Patterns
Drawer vs. Modal
Both are overlays with Card and Page variants. Reach for a Drawer when the panel should sit at the edge of the page and may leave the rest of the page usable. Reach for a Modal when the user must deal with the dialog before doing anything else.
Feature | Drawer | Modal |
|---|---|---|
Position | Edge of page (start, end, bottom) | Centered over page |
Backdrop | Optional, configurable | Always blocks interaction behind it |
Default size | 38.2% wide (desktop), 61.8% tall (mobile) | 400×400 px |
Full-screen mode | Not applicable | Set width+height to 100% |
Page variant | Yes (embeds another page) | Yes (embeds another page) |
Exposed state |
|
|
Mobile default | Bottom sheet at 61.8% height | Same centered dialog |
Multiple open | One at a time (second closes first) | Standard: one centered |
Dismiss methods | Hide method, click-outside, drag-down (Bottom position) | hideModal(), Escape, click-outside, close button |
Related Blocks
Block | Relationship |
|---|---|
Centered blocking dialog — use when the page behind must not be interactive | |
Bottom Sheet | Purpose-built swipeable bottom panel for mobile |
Mobile Contextual Dialog | Small anchored popover for in-context menus |
Stack | The default container inside each slot (header/body/footer) |
Form / Table | Typical drawer contents and triggers |