Skip to content

SheetPro

The dialog docked to an edge for inspectors and run details: slides in from its side, a drag handle to fling it away, an inset floating style and a pinned footer.

oxyn add sheet
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

  • Details that sit beside the work instead of over it: a run inspector, a tool call's full output, a settings panel, a file preview.
  • The page stays visible under a lighter scrim.

When not to use

  • A modal window on a dimmed backdrop: use Dialog instead.
  • Nested sheets with depth: use Sheet stack instead.
  • A sheet that rests at a peek or full height and follows your finger: use Bottom sheet instead.

Installation

Sheet 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

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

Right

An inspector on the right.

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

Inset left

Floating on the left.

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

Bottom

A tray from the bottom.

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

Sheet

PropTypeDefaultDescription
titlerequiredString—Title.
descriptionOption<String>Default::default()Quiet line.
openboolDefault::default()Start open.
trigger_labelOption<String>Default::default()A button that opens it.
sideString"right"`right` · `left` · `top` · `bottom`.
sizef32360.0Width (left / right) or height (top / bottom) px.
insetboolDefault::default()Floating with a gutter and rounded corners.
containedboolDefault::default()Inside the nearest positioned ancestor.
close_on_backdropbooltrueA press on the scrim closes it.
draggablebooltrueDrag handle on the inner edge.
footerOption<String>Default::default()Footer action label.
childrenElementDefault::default()Body.
on_open_changeEventHandler<bool>—Open state changed.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
EscClose
TabMove inside the sheet

Accessibility

  • role=dialog with aria-modal, named by its title; the scrim and × close it and hand focus back.
From the spec

Same dialog rules as dialog.md: modal, named by its title, focus inside, returned to the trigger. The grip is decorative; × and Escape are always available.

Motion & interaction

Slides in from its edge; the scrim fades. Dragging the grip tracks the pointer 1:1 and lightens the scrim; a release either springs back or completes the slide out.

Timing
TransitionDurationEasingReduced motion
Slide in320 msease.out120 ms fade
Slide out230 msease.outinstant
Spring back260 msease.outinstant

Responsive behaviour

  • size is the width (left / right) or height (top / bottom), never wider than the viewport.
Edge cases (spec)

size is the width for left / right and the height for top / bottom, capped at the container. Long bodies scroll. On touch the grip is the drag target, so the body still scrolls.

Notes for AI

  • Import Sheet from oxyn_dioxus and include PRIMITIVES_CSS plus the token stylesheet once.
  • A GPUI version exists: SheetEl in oxyn_gpui.
  • Props to set first: title.
  • 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