Skip to content

InputNumber 数字输入框

仅允许输入标准的数字值,可定义范围

TIP

InputNumber 组件对应 GvInputNumber。支持v-model双向数据绑定,下方示例可直接交互,点击「显示代码」查看源码。

基础用法

使用 v-model 绑定变量即可,变量的初始值即为默认值。

禁用状态

通过 disabled 属性禁用输入框。

步进​

允许定义递增递减的步进控制, 设置 step 属性可以控制步长。

严格步进​

step-strictly属性接受一个Boolean。 如果这个属性被设置为 true,则只能输入步进的倍数。

精度

通过 precision 属性可以设置输入框的精度,可选值为 012

不同的输入框尺寸

通过 size 属性可以设置输入框的尺寸,可选值为 smalldefaultlarge

按钮位置

通过 position 属性可以设置输入框的按钮位置,可选值为 ``、right

范围

通过 minmax 属性可以设置输入框的范围。

API

Attributes

属性名说明类型默认值
model-value / v-model绑定值string / number
name设置input的name属性string
placeholder占位文本string
disabled是否禁用booleanfalse
visible设置是否可见booleanfalse
size输入框尺寸'large' / 'default' / 'small'default
min设置input的value最小值number
max设置input的value最大值number
step设置input的步长number1
stepStrictly设置是否只能输入 step 的倍数booleanfalse
precision设置数值精度number0
position设置按钮位置``/'right'``
biz-type业务属性:tableedit-表格输入框stringtableedit
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;
}