ImageCaptcha 图片验证码
uni-appH5微信小程序App
uni-app 跨端图片验证码。使用 <canvas type="2d"> 生成含干扰线/干扰点的字符图片,点击画布或刷新按钮重新生成;通过 update:code 同步当前验证码供父级校验。
何时使用
登录、注册等需要图形验证码且希望完全前端生成的场景。
何时不使用
需要服务端下发加密验证码或短信/邮箱二次校验时。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
length | number | 4 | 验证码字符数量 |
width | number | 120 | 画布宽度(px) |
height | number | 40 | 画布高度(px) |
disabled | boolean | false | 禁用(不响应刷新) |
dark | boolean | false | 深色模式(适配深色登录页背景) |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:code | string | 每次生成后触发,携带当前验证码(父级据此校验用户输入) |
refresh | void | 点击画布或刷新按钮重新生成时触发 |
示例
搭配输入框
vue
<view class="row">
<Input v-model="code" placeholder="输入验证码" style="flex:1" />
<ImageCaptcha v-model:code="capCode" />
</view>
<text class="demo-desc">{{ code ? (code.toUpperCase() === capCode ? '校验通过' : '校验失败,点击验证码可刷新') : '输入图片中的字符自动校验' }}</text>深色模式
vue
<view style="background:#1f2329;padding:12px;border-radius:10px">
<ImageCaptcha v-model:code="capCode2" dark />
</view>
<text class="demo-desc">当前验证码:{{ capCode2 }}</text>更大尺寸
vue
<ImageCaptcha v-model:code="capCode3" :width="160" :height="56" />
<text class="demo-desc">当前验证码:{{ capCode3 }}</text>