NumberInput 数字输入框

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

获取组件

import { NumberInput } from 'rsuite';

演示

默认

尺寸

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

小数

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

小数点分隔符

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

格式化

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

最小值和最大值

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

设置跨度

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

禁用与只读

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

显示或隐藏控制按钮

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

前缀和后缀

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

InputGroup 组合

受控

通过 valueonChange 属性控制组件状态。

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 当前值(受控)