NumberInput 数字输入框

只能输入数字的文本输入组件。

获取组件

import { NumberInput } from 'rsuite';

演示

默认

尺寸

使用 size 属性设置 NumberInput 组件的不同尺寸。

小数

默认支持输入小数,可通过 step 属性控制小数精度。

小数点分隔符

小数点分隔符是一个符号,用于将十进制形式的数字的整数部分与小数部分分开(例如,12.45 中的 ".")。不同的国家地区会指定不同的符号作为分隔符。

格式化

使用 formatter 函数格式化显示值。

最小值和最大值

使用 min 和 max 属性设置最小值和最大值。

设置跨度

使用 step 属性自定义值变化的步长。

禁用与只读

使用 disabled 属性禁用组件,或使用 readOnly 属性将其设置为只读。

显示或隐藏控制按钮

显示或隐藏控制按钮,或提供一个函数来渲染自定义图标。

前缀和后缀

显示在输入框前后的元素。

InputGroup 组合

受控

通过 value 和 onChange 属性控制组件状态。

Props

<NumberInput>

属性名称 类型 (默认值) 描述
classPrefix string ('number-input') 组件 CSS 类的前缀
controls boolean | ((trigger: 'up' | 'down') => ReactNode) (true) 显示或隐藏控制按钮,或通过函数自定义图标
decimalSeparator string 小数点分隔符
defaultValue number 默认值(非受控)
disabled boolean 禁用
formatter (value: number) => string 格式化输入框的值
max number 最大值
min number 最小值
onChange (value: number, event) => void value 发生改变时的回调函数
prefix ReactNode 前缀
scrollable boolean (true) 是否可以通过鼠标滚动更新值
size 'lg' | 'md' | 'sm' | 'xs' ('md') 设置输入框尺寸
step number (1) 每次改变步数,可以为小数
suffix ReactNode 后缀
value number 当前值(受控)