Skip to content

Input Number 数字输入框

使用

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

基础用法

要使用它,只需要在 <k-input-number> 元素中使用 v-model 绑定变量即可,变量的初始值即为默认值。

TIP

当输入无效的字符串到输入框时,由于错误,输入值将把 NaN 导入到上层

禁用状态

disabled 属性接受一个 Boolean,设置为 true 即可禁用整个组件。如果你只需要控制数值在某一范围内,可以设置 min 属性和 max 属性, 默认最小值为 0

步进

允许定义递增递减的步进控制

设置 step 属性可以控制步长。

严格步进

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

精度

设置 precision 属性可以控制数值精度,接收一个 Number

TIP

precision 的值必须是一个非负整数,并且不能小于 step 的小数位数。

不同的输入框尺寸

使用 size 属性额外配置尺寸,可选的尺寸大小为:largesmall

按钮位置

设置 controls-position 属性可以控制按钮位置。

自定义图标

使用 decrease-iconincrease-icon 设置自定义图标。

带前缀和后缀

使用前缀和标名后缀。

API

InputNumber Props

参数名描述类型默认值
model-value/v-model绑定值number-
min最小值number-Infinity
max最大值numberInfinity
step计数步长number1
size输入框大小enumbase
step-strictly是否只能输入 step 的倍数booleanfalse
precision数值精度number-
disabled是否禁用booleanfalse
readonly是否只读booleanfalse
controls是否使用控制按钮boolean-
controls-position控制按钮位置enum-
only-digits 是否只能输入数字,正负号、小数点、科学计数法等都不允许输入booleanfalse

InputNumber Events

事件名描述类型
blur输入框失去焦点时触发Function
focus输入框获得焦点时触发Function
change仅当 modelValue 改变时,当输入框失去焦点或用户按Enter时触发Function

InputNumber Methods

方法名描述类型
blur使输入框失去焦点Function
focus使输入框获得焦点Function

InputNumber Slots

插槽名描述参数
decrease-icon自定义输入框按钮减少图标-
increase-icon自定义输入框按钮增加图标-