操作与选择Actions · 07 / 64

NumberStepper

ui.widgets.NumberStepper

精确递增、递减数值，适合数量和参数。Precise increment and decrement for quantities and parameters.

BEHAVIOR CONTRACT

min / max / step、直接输入、禁用态与按钮步进共享同一数值约束。min / max / step, direct entry, disabled and the step buttons share one numeric constraint.

RECORDED INTERACTION

Harness 点击加号，数值按 step 改变。The harness clicks plus; the value moves by one step.

examples/storybook/stories.zig:3025

// ── NumberStepper ──
pub fn buildNumberStepper(scope: *ui.Scope, cx: *ui.Cx) anyerror!*ui.Node {
    const a = cx.allocator;
    const c = try col(cx, 12);
    const ns = try ui.widgets.NumberStepper(.{ .value = 5, .min = 0, .max = 10 }, scope, cx);
    ns.wrapper.meta.ownership.meta.test_id = "story.stepper.basic";
    try c.appendChild(a, try label(cx, "0–10, step 1"));
    try c.appendChild(a, ns.wrapper);
    const ns2 = try ui.widgets.NumberStepper(.{ .value = 0.5, .step = 0.25, .width = 160 }, scope, cx);
    try c.appendChild(a, try label(cx, "step 0.25"));
    try c.appendChild(a, ns2.wrapper);
    const ns3 = try ui.widgets.NumberStepper(.{ .value = 3, .disabled = true }, scope, cx);
    try c.appendChild(a, try label(cx, "Disabled"));
    try c.appendChild(a, ns3.wrapper);
    return c;
}

在 GitHub 查看源码View source on GitHubexamples/storybook/stories.zig:3025

这是 Storybook 中该 story 的原样代码（zenit 5f9add5+wip 2026-09-30）。其中 W 即 ui.widgets，col / row / label 是 Storybook 内的布局小工具。The story's verbatim source from the Storybook (zenit 5f9add5+wip 2026-09-30). W is ui.widgets; col / row / label are small Storybook layout helpers.

← PREV

RateRate

InputInput