InputOtp 一次性密码输入框 beta

用于输入一次性密码

基础用法

Value: 123

自定义长度

输入字段长度可以通过设置length属性来自定义。

展示类型

有三种类型可用:outlined (默认)、filled underlined

Outlined (Default)

Filled

Underlined

调整尺寸

有三个尺寸可用:largedefaultsmall

Large

Default

Small

禁用 & 只读

支持禁用和只读状态。

Disabled

Readonly

密码模式

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

Value: 123

分隔符

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

/////

自定义验证

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

Numbers only

Letters only

应用开发接口(API)

属性

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

Events

方法名说明类型
update:modelValue值更新时触发Function
change当输入框失去焦点后且值发生变化时触发Function
finish当所有字段都已填写时触发Function
focus输入框获得焦点时触发Function
blur输入框失去焦点时触发Function

插槽

方法名详情事件参数
separatorOTP 字段之间的分隔符object

对外暴露的方法

名称详情类型
inputRefsHTML 输入框元素数组object
focus聚焦OTP输入字段Function
blur失焦OTP输入字段Function

源代码

组件样式文档

贡献者