Sheet
ui.widgets.SheetA side panel that slides in from the window edge.
BEHAVIOR CONTRACT
left / right side, barrier, panel hit-testing, animation and close policy are consistent.
RECORDED INTERACTION
The harness opens the right sheet and records the full slide-in.
pub fn buildSheet(scope: *ui.Scope, cx: *ui.Cx) anyerror!*ui.Node {
const a = cx.allocator;
const c = try col(cx, 12);
const vis = try scope.createSignal(bool, false);
const st = try cx.bindState(SheetStory, .{ .visible = vis });
const sbtn = try W.Button(.{ .label = "Open Sheet", .on_click = cx.on(SheetStory, st, SheetStory.open) }).mount(scope, cx);
sbtn.meta.ownership.meta.test_id = "story.sheet.open";
try c.appendChild(a, sbtn);
const sh = try W.Sheet(.{ .side = .right, .width = 320 }).visible(vis).mount(scope, cx);
sh.panel.meta.ownership.meta.test_id = "story.sheet.panel";
try sh.content.appendChild(a, try ui.text(cx, "Sheet panel content.", .{ .font_size = 14, .color = light.color.fg_primary }));
if (!sh.portaled) try c.appendChild(a, sh.overlay);
return c;
}The story's verbatim source from the Storybook (zenit 4c50245 2026-10-01). W is ui.widgets; col / row / label are small Storybook layout helpers.
SheetProps
ui.widgets.Sheetfn Sheet(props: SheetProps) SheetBuilderField
Type
Default
Description
sideSheetSide.left.right.top.bottom.right—
widthf32320—
heightf32320—
overlay_color?Colornull—
background?Colornull—
close_on_overlaybooltrue—
close_on_escapebooltrue—
visible?*Signal(bool)null—
animation_msf32250—
SheetResult
ui.widgets.SheetField
Type
Default
Description
overlay*Node—
—
panel*Node—
—
content*Node—
—
portaledboolfalse见 Modal.mount:true = overlay 已挂到 portal root,caller 不要再 append。