PinInput 验证码输入
uni-appH5微信小程序App
跨端数字验证码输入,支持位数、掩码和完成事件。
何时使用
短信验证码、支付密码等定长分段输入场景。
何时不使用
普通文本或不定长输入用 Input。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "" | 绑定值(v-model) |
length | number | 6 | 位数 |
mask | boolean | false | 密码圆点掩码(type=password) |
disabled | boolean | false | 禁用 |
size | string:'sm' | 'md' | 'lg' | "md" | 尺寸 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 任意格输入/删除/粘贴时触发 |
complete | string | 填满所有位时触发 |
示例
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" />