PinInput 验证码输入
WebH5
验证码/密码分段输入。每格一个输入框,输入自动跳格、退格回退、粘贴自动拆分,填满触发 complete。
何时使用
短信验证码、支付密码等定长分段输入场景。
何时不使用
普通文本或不定长输入用 Input。
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 位支付密码(掩码)
示例加载中…
完成回调 + 输入进度
示例加载中…
Playground
加载中…
md
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 PinInput 文档(含手机预览)。