验证码输入 InputOtp beta

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

基础用法

Value: 123

自定义长度

通过 length 属性自定义输入框数量。

类型

提供 outlined(默认)、filledunderlined 三种类型。

Outlined (Default)

Filled

Underlined

尺寸

提供 largedefaultsmall 三种尺寸。

Large

Default

Small

禁用与只读

支持禁用与只读状态。

Disabled

Readonly

掩码

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

Value: 123

分隔符

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

/////

自定义校验

通过 validator 校验输入字符,使用 inputmode 指定键盘类型。

Numbers only

Letters only

API

Attributes

属性名说明类型默认值
model-value / v-modelOTP 值。数字不能有前导零,因此 modelValue 仅在初始化时允许为 number。string / numberundefined
lengthOTP 字段数量number6
validator自定义校验函数Function() => true
inputmode原生 inputmode 属性string
typeOTP 字段类型enum'outlined'
sizeOTP 字段尺寸enum'default'
mask是否启用密码模式boolean
disabled是否禁用booleanundefined
separator字段间分隔符string / VNode / Function
validate-event是否触发表单校验booleantrue
readonly同原生 input 的 readonlybooleanfalse
id原生 id 属性string
aria-label a11y原生 aria-label 属性string

Events

事件名说明类型
update:modelValue值更新时触发Function
change失焦后值变化时触发Function
finish全部字段填写完成时触发Function
focus聚焦时触发Function
blur失焦时触发Function

Slots

插槽名说明类型
separator字段间分隔符object

Exposes

名称说明类型
inputRefsHTML input 元素数组object
focus聚焦指定 OTP 输入框Function
blur失焦当前 OTP 输入框Function