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 sheetThe 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
- 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.
oxyn add sheetUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Right
An inspector on the right.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Inset left
Floating on the left.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Bottom
A tray from the bottom.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
Sheet
| Prop | Type | Default | Description |
|---|---|---|---|
titlerequired | String | — | Title. |
description | Option<String> | Default::default() | Quiet line. |
open | bool | Default::default() | Start open. |
trigger_label | Option<String> | Default::default() | A button that opens it. |
side | String | "right" | `right` · `left` · `top` · `bottom`. |
size | f32 | 360.0 | Width (left / right) or height (top / bottom) px. |
inset | bool | Default::default() | Floating with a gutter and rounded corners. |
contained | bool | Default::default() | Inside the nearest positioned ancestor. |
close_on_backdrop | bool | true | A press on the scrim closes it. |
draggable | bool | true | Drag handle on the inner edge. |
footer | Option<String> | Default::default() | Footer action label. |
children | Element | Default::default() | Body. |
on_open_change | EventHandler<bool> | — | Open state changed. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Esc | Close |
| Tab | Move 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
| Transition | Duration | Easing | Reduced motion |
|---|---|---|---|
| Slide in | 320 ms | ease.out | 120 ms fade |
| Slide out | 230 ms | ease.out | instant |
| Spring back | 260 ms | ease.out | instant |
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
Sheetfromoxyn_dioxusand includePRIMITIVES_CSSplus the token stylesheet once. - A GPUI version exists:
SheetElinoxyn_gpui. - Props to set first:
title. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.