Tag
ui.widgets.TagClosable or read-only category labels.
BEHAVIOR CONTRACT
Color, variant, size, closable and callbacks share consistent sizing and focus.
RECORDED INTERACTION
Shows neutral, accent and status colors plus outline.
// ── Tag ──
pub fn buildTag(scope: *ui.Scope, cx: *ui.Cx) anyerror!*ui.Node {
const a = cx.allocator;
const c = try col(cx, 12);
// ── 全部颜色(含 info)──
const r1 = try row(cx, 8);
inline for (.{ W.TagColor.neutral, .accent, .success, .warning, .danger, .info }, .{ "neutral", "accent", "success", "warning", "danger", "info" }) |col_, t| {
try r1.appendChild(a, try W.Tag(.{ .text = t, .color = col_ }).mount(scope, cx));
}
try c.appendChild(a, try label(cx, "Colors"));
try c.appendChild(a, r1);
// ── 尺寸 ──
try c.appendChild(a, try label(cx, "Sizes (sm / md)"));
const r_sz = try row(cx, 8);
inline for (.{ W.TagSize.sm, .md }, .{ "Small", "Medium" }) |sz, t| {
try r_sz.appendChild(a, try W.Tag(.{ .text = t, .color = .accent, .size = sz }).mount(scope, cx));
}
try c.appendChild(a, r_sz);
// ── 变体 ──
try c.appendChild(a, try label(cx, "Variants"));
const r2 = try row(cx, 8);
try r2.appendChild(a, try W.Tag(.{ .text = "Default", .variant = .default }).mount(scope, cx));
try r2.appendChild(a, try W.Tag(.{ .text = "Outline", .variant = .outline }).mount(scope, cx));
try r2.appendChild(a, try W.Tag(.{ .text = "Closable", .closable = true }).mount(scope, cx));
try r2.appendChild(a, try W.Tag(.{ .text = "Outline + close", .variant = .outline, .color = .danger, .closable = true }).mount(scope, cx));
try c.appendChild(a, r2);
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.
TagProps
ui.widgets.Tagfn Tag(props: TagProps) TagBuilderField
Type
Default
Description
text[]const u8""—
variantTagVariant.default.outline.default—
colorTagColor.neutral.accent.success.warning.danger.info.neutral—
sizeTagSize.sm.md.md—
closableboolfalse—
on_close?core.HandlerRefnull—
close_icon_asset?svg_assets.Assetnull—
*Node
ui.widgets.Tagmount returns *Node directly. Append it to a parent.