跳到主要内容

PinInput 验证码输入 ​

uni-appH5微信小程序App

跨端数字验证码输入,支持位数、掩码和完成事件。

何时使用 ​

短信验证码、支付密码等定长分段输入场景。

何时不使用 ​

普通文本或不定长输入用 Input。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
PinInput 验证码输入 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
modelValuestring""绑定值(v-model)
lengthnumber6位数
maskbooleanfalse密码圆点掩码(type=password)
disabledbooleanfalse禁用
sizestring:'sm' | 'md' | 'lg'"md"尺寸

Events ​

名称载荷说明
update:modelValuestring任意格输入/删除/粘贴时触发
completestring填满所有位时触发

示例 ​

4 位验证码 ​

vue
<PinInput v-model="pin" :length="4" />

掩码模式 ​

vue
<PinInput v-model="pin" :length="6" mask />

禁用 ​

vue
<PinInput v-model="pin" :length="4" disabled />

尺寸 ​

vue
<PinInput v-model="pin" size="lg" />