跳到主要内容

PinInput 验证码输入 ​

WebH5

验证码/密码分段输入。每格一个输入框,输入自动跳格、退格回退、粘贴自动拆分,填满触发 complete。

何时使用 ​

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

何时不使用 ​

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

Props ​

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

Events ​

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

示例 ​

短信验证码 ​

示例加载中…

4 位支付密码(掩码) ​

示例加载中…

完成回调 + 输入进度 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 PinInput 文档(含手机预览)。