InputOtp OTP 输入框 beta

用于输入一次性密码 (OTP)。

基础用法

值:123

自定义长度

可以通过设置 length 属性来调节输入框的长度。

类型

有三种类型可选:outlined(默认)、filledunderlined

外边框 (默认)

填充

下划线

尺寸

有三种尺寸可选:largedefaultsmall

默认值

禁用与只读

支持禁用和只读状态。

禁用状态

只读

掩码

使用 mask 属性来隐藏输入字符。

值:123

分隔符

自定义 OTP 字段之间的分隔符。

/////

自定义校验

设置 validator 属性来校验输入字符,并使用 inputmode 指定键盘类型。

仅限数字

仅限字母

API

属性

名称描述类型默认值
model-value / v-modelOTP 字段的值。由于数字不能有前导零,modelValue 仅在初始化期间允许为数字类型。string / numberundefined
lengthOTP 字段的长度number6
validator自定义校验函数Function() => true
inputmode原生 inputmode 属性string
typeOTP 字段的类型枚举'outlined'
sizeOTP 字段的尺寸枚举'default'
mask是否启用密码模式boolean
disabled是否禁用 OTP 字段booleanundefined
separatorOTP 字段之间的分隔符string / VNode / Function
validate-event是否触发表单校验booleantrue
只读与原生 input 的 readonly 属性相同booleanfalse
id原生 id 属性string
aria-label 无障碍原生 aria-label 属性string

事件

名称描述类型
update:modelValue当值更新时触发Function
change在输入框失去焦点后,当值发生改变时触发Function
finish当所有字段都填满时触发Function
focus当输入框获得焦点时触发Function
blur当输入框失去焦点时触发Function

插槽

名称描述类型
separatorOTP 字段之间的分隔符object

暴露

名称描述类型
inputRefsHTML input 元素数组object
focus使 OTP 输入框获得焦点Function
blur使获得焦点的 OTP 输入框失去焦点Function

来源

组件样式文档

贡献者