Sheet
ui.widgets.Sheet从窗口边缘进入的辅助任务面板。
BEHAVIOR CONTRACT
left / right side、barrier、panel hit-test、动画和关闭策略保持一致。
RECORDED INTERACTION
Harness 打开右侧 Sheet,记录完整滑入过程。
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;
}这是 Storybook 中该 story 的原样代码(zenit 5f9add5+wip 2026-09-30)。其中 W 即 ui.widgets,col / row / label 是 Storybook 内的布局小工具。
SheetProps
ui.widgets.Sheetfn Sheet(props: SheetProps) SheetBuilder字段
类型
默认值
说明
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.Sheet字段
类型
默认值
说明
overlay*Node—
—
panel*Node—
—
content*Node—
—
portaledboolfalse见 Modal.mount:true = overlay 已挂到 portal root,caller 不要再 append。