InputNumber 数字输入框
仅允许输入标准的数字值,可定义范围
TIP
InputNumber 组件对应 GvInputNumber。支持v-model双向数据绑定,下方示例可直接交互,点击「显示代码」查看源码。
基础用法
使用 v-model 绑定变量即可,变量的初始值即为默认值。
禁用状态
通过 disabled 属性禁用输入框。
步进
允许定义递增递减的步进控制, 设置 step 属性可以控制步长。
严格步进
step-strictly属性接受一个Boolean。 如果这个属性被设置为 true,则只能输入步进的倍数。
精度
通过 precision 属性可以设置输入框的精度,可选值为 0、1、2。
不同的输入框尺寸
通过 size 属性可以设置输入框的尺寸,可选值为 small、default、large。
按钮位置
通过 position 属性可以设置输入框的按钮位置,可选值为 ``、right。
范围
通过 min 和 max 属性可以设置输入框的范围。
API
Attributes
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | string / number | — |
| name | 设置input的name属性 | string | — |
| placeholder | 占位文本 | string | — |
| disabled | 是否禁用 | boolean | false |
| visible | 设置是否可见 | boolean | false |
| size | 输入框尺寸 | 'large' / 'default' / 'small' | default |
| min | 设置input的value最小值 | number | — |
| max | 设置input的value最大值 | number | — |
| step | 设置input的步长 | number | 1 |
| stepStrictly | 设置是否只能输入 step 的倍数 | boolean | false |
| precision | 设置数值精度 | number | 0 |
| position | 设置按钮位置 | ``/'right' | `` |
| biz-type | 业务属性:tableedit-表格输入框 | string | tableedit |
| columnProp | 当是表格编辑input时列属性值 | string | — |
Events
| 事件名 | 说明 | 类型 |
|---|---|---|
| blur | 在组件 Input 失去焦点时触发 | (event: FocusEvent) => void |
| focus | 在组件 Input 获得焦点时触发 | (event: FocusEvent) => void |
| change | 绑定值被改变时触发 | (currentValue: number | undefined, oldValue: number | undefined) => void |
| input | 输入值变化时触发 | (value: string | number) => void |
Exposes
无
类型定义
typescript
/** Input 尺寸 */
type InputSize = 'large' | 'default' | 'small';
/** GvInputNumber Props */
interface InputNumberProps {
modelValue?: string | number;
bizType?: string;
columnProp?: string;
disabled?: boolean;
max?: number;
min?: number;
name?: string;
placeholder?: string;
position?: string;
precision?: number;
size?: InputSize;
step?: number;
stepStrictly?: boolean;
visible?: boolean;
vref?: string;
}