Icons
ui.system_iconsプロバイダーに依存しないセマンティックなアイコンロール、サイズ、着色。
BEHAVIOR CONTRACT
コンポーネントは system_icons のロールにのみ依存し、アイコンプロバイダーを差し替えてもコンポーネント API は変わりません。
RECORDED INTERACTION
仮想カーソルがセマンティックアイコン、サイズ、tint をなぞります。
pub fn buildIconGallery(scope: *ui.Scope, cx: *ui.Cx) anyerror!*ui.Node {
const a = cx.allocator;
const c = try col(cx, 12);
try c.appendChild(a, try label(cx, "System icon contract (provider-neutral subset)"));
// wrap 成多行网格:每行 6 个。
var current_row = try row(cx, 8);
var in_row: usize = 0;
inline for (GALLERY_ICONS) |spec| {
if (in_row == 6) {
try c.appendChild(a, current_row);
current_row = try row(cx, 8);
in_row = 0;
}
try current_row.appendChild(a, try iconCell(scope, cx, spec.asset, spec.name));
in_row += 1;
}
try c.appendChild(a, current_row);
// 尺寸 + tint 演示行
try c.appendChild(a, try label(cx, "Sizes & tints"));
const demo = try row(cx, 16);
inline for (.{ 16, 24, 32, 48 }) |sz| {
try demo.appendChild(a, try ui.iconTint(cx, ui.system_icons.alert, light.color.fg_secondary, .{
.width = .{ .px = @as(f32, sz) },
.height = .{ .px = @as(f32, sz) },
}));
}
try demo.appendChild(a, try ui.iconTint(cx, ui.system_icons.heart, .{ .r = 220, .g = 40, .b = 60, .a = 255 }, .{
.width = .{ .px = 32 },
.height = .{ .px = 32 },
}));
try c.appendChild(a, demo);
return c;
}Storybook にあるこの story のコードそのままです(zenit 5f9add5+wip 2026-09-30)。W は ui.widgets のことで、col / row / label は Storybook 内の小さなレイアウトヘルパーです。