components/badge
数据展示 · 18 / 64

Badge

ui.widgets.Badge

低强调状态、数量和语义色标签。

BEHAVIOR CONTRACT

info / success / warning / error、尺寸、dot 与图标变体遵循主题 token。

RECORDED INTERACTION

录像扫过所有语义色和尺寸。

examples/storybook/stories.zig:463
// ── Badge / StatusBadge ──
pub fn buildBadge(scope: *ui.Scope, cx: *ui.Cx) anyerror!*ui.Node {
    const a = cx.allocator;
    const c = try col(cx, 12);
    const r1 = try row(cx, 12);
    inline for (.{ "info", "success", "warning", "error" }, .{ W.badge.BadgeStatus.info, .success, .warning, .@"error" }) |t, st| {
        try r1.appendChild(a, try W.Badge(.{ .text = t, .status = st }).mount(scope, cx));
    }
    try c.appendChild(a, try label(cx, "Badge status"));
    try c.appendChild(a, r1);

    const r2 = try row(cx, 12);
    try r2.appendChild(a, try W.Badge(.{ .count = 5 }).mount(scope, cx));
    try r2.appendChild(a, try W.Badge(.{ .count = 120, .max_count = 99 }).mount(scope, cx));
    try r2.appendChild(a, try W.Badge(.{ .dot = true }).mount(scope, cx));
    try c.appendChild(a, try label(cx, "Count / dot"));
    try c.appendChild(a, r2);

    // ── 尺寸 ──
    try c.appendChild(a, try label(cx, "Sizes (sm / md)"));
    const r_sz = try row(cx, 12);
    inline for (.{ W.badge.BadgeSize.sm, .md }) |sz| {
        try r_sz.appendChild(a, try W.Badge(.{ .count = 8, .size = sz }).mount(scope, cx));
    }
    try c.appendChild(a, r_sz);

    const r3 = try row(cx, 12);
    try r3.appendChild(a, try W.StatusBadge(.{ .label_text = "Online", .status = .success }).mount(scope, cx));
    try r3.appendChild(a, try W.StatusBadge(.{ .label_text = "Error", .status = .@"error" }).mount(scope, cx));
    try c.appendChild(a, try label(cx, "StatusBadge"));
    try c.appendChild(a, r3);
    return c;
}
在 GitHub 查看源码examples/storybook/stories.zig:463

这是 Storybook 中该 story 的原样代码(zenit 5f9add5+wip 2026-09-30)。其中 W 即 ui.widgets,col / row / label 是 Storybook 内的布局小工具。

zenit · 双授权开源项目可按 GPL-3.0-only 免费使用;闭源或商业产品需要商业授权。可联系作者:zongyi.xzy#gmail.com(# 换成 @)zenit 5f9add5+wip 2026-09-30