Skip to content
Back

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-stack
Atlas · Run 248
The code is part of Oxyn Pro

The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.

Get Pro

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.

Terminal
oxyn add sheet-stack

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Examples

Sheets

Two sheets, the lower one peeking.

Atlas · Run 248
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Deep

Three levels with a breadcrumb.

Atlas · Run 248
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Dialogs

Stacked dialogs (wide screens).

Atlas · Run 248
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Side

Inspectors stacking sideways.

Atlas · Run 248
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

SheetStack

PropTypeDefaultDescription
pagesrequiredVec<StackPage>—Sheets (rows that `push` open the next one).
default_stackVec<String>Default::default()Sheets open at first, bottom first.
modeString"auto"`auto` · `sheet` · `dialog` · `side`.
breakpointf32640.0Auto switches to dialogs at this width px.
containedboolDefault::default()Inside the nearest positioned ancestor.
trigger_labelOption<String>Default::default()A button that opens the first page.
breadcrumbboolDefault::default()Oxyn plus: a breadcrumb of the open sheets.
on_stack_changeEventHandler<Vec<String>>—Stack changed.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
EscClose the top sheet only
TaborShiftTabCycle inside the top sheet
EnterorSpaceBack, 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
TransitionDurationEasingReduced motion
Push380 msease.out120 ms fade
Pop / depth change340 msease.outinstant
Dialog mode in220 msease.out120 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, StackRow from oxyn_dioxus and include PRIMITIVES_CSS plus the token stylesheet once.
  • A GPUI version exists: SheetStackEl in oxyn_gpui.
  • Props to set first: pages.
  • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI