Sheet stackPro
Nested sheets with depth: a new sheet rises while the one below scales back 5 %, dims and peeks; back names the sheet below; drag or fling the top one away; stacked dialogs on wide screens.
oxyn add sheet-stackThe preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.
Rendered from Rust at build time · goes live when visible
When to use
- Settings that go deeper than one screen: run settings → tools → shell access.
- Each level keeps the one below visible so the user knows where they came from and how to get back.
When not to use
- The dialog docked to an edge for inspectors and run details: use Sheet instead.
- A modal window on a dimmed backdrop: use Dialog instead.
- A sheet that rests at a peek or full height and follows your finger: use Bottom sheet instead.
Installation
Sheet stack is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.
oxyn add sheet-stackUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Sheets
Two sheets, the lower one peeking.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Deep
Three levels with a breadcrumb.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Dialogs
Stacked dialogs (wide screens).
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Side
Inspectors stacking sideways.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
SheetStack
| Prop | Type | Default | Description |
|---|---|---|---|
pagesrequired | Vec<StackPage> | — | Sheets (rows that `push` open the next one). |
default_stack | Vec<String> | Default::default() | Sheets open at first, bottom first. |
mode | String | "auto" | `auto` · `sheet` · `dialog` · `side`. |
breakpoint | f32 | 640.0 | Auto switches to dialogs at this width px. |
contained | bool | Default::default() | Inside the nearest positioned ancestor. |
trigger_label | Option<String> | Default::default() | A button that opens the first page. |
breadcrumb | bool | Default::default() | Oxyn plus: a breadcrumb of the open sheets. |
on_stack_change | EventHandler<Vec<String>> | — | Stack changed. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Esc | Close the top sheet only |
| TaborShiftTab | Cycle inside the top sheet |
| EnterorSpace | Back, close and rows |
Accessibility
- Each sheet is a dialog named by its title; only the top one is aria-modal, the rest are inert.
- The back button names the sheet it returns to; the close button reads Close all when more than one is open.
From the spec
Only the top sheet is modal and focusable; the rest are inert. The back button names its destination; the close button says Close all when it will close more than one. Escape closes one level at a time.
Motion & interaction
A new sheet rises from the bottom while the one below scales back 5 %, dims 18 % and peeks 12 px above it. While the top sheet is dragged the lower one moves back toward full size in proportion. Titles rise in; the breadcrumb tracks the trail.
Timing
| Transition | Duration | Easing | Reduced motion |
|---|---|---|---|
| Push | 380 ms | ease.out | 120 ms fade |
| Pop / depth change | 340 ms | ease.out | instant |
| Dialog mode in | 220 ms | ease.out | 120 ms fade |
Responsive behaviour
- auto: bottom sheets under 640 px, centred dialogs at or above; each level loses room for the peek.
Edge cases (spec)
Deep stacks keep at most three visible levels; deeper ones sit hidden behind. Narrow screens lose the peek room per level. A non-dismissible sheet ignores drag and scrim but still has Back.
Notes for AI
- Import
SheetStack,StackPage,StackRowfromoxyn_dioxusand includePRIMITIVES_CSSplus the token stylesheet once. - A GPUI version exists:
SheetStackElinoxyn_gpui. - Props to set first:
pages. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.