Skip to content

Number Field

数值输入基座:Root 统一边界、步进与精度,增减按钮和输入框保持可组合。

运行时归属

useNumberFieldRoot 来自 @varo-ui/headless,H5 与小程序复用同一数值约束。

演示

安装包@varo-ui/headless

安装

bash
pnpm add @varo-ui/headless @varo-ui/h5
# 或
pnpm add @varo-ui/headless @varo-ui/weapp

为什么是基础能力

  • 数量、金额和评分调节都依赖可靠的 min/max/step。
  • 拆分 Parts 后可以自由替换布局和图标。

Parts

Part作用
NumberFieldRoot数值状态与约束
NumberFieldDecrement减少动作
NumberFieldInput原生数值输入
NumberFieldIncrement增加动作

状态与事件

  • 状态:valueminmaxstepprecisionreadonly
  • 事件:update:valuevalueChange

平台说明

边界和精度跨端一致;原生输入事件由各目标适配。

相关文档