ImageCaptcha 图形验证码
WebH5
图形验证码。Canvas 绘制带干扰线与干扰点的随机字符(已剔除易混淆的 0/O、1/I/L),点击图片或刷新按钮重新生成,通过 update:code 暴露当前验证码供父级校验用户输入。
何时使用
登录、注册等需要简单人机校验的场景,常与输入框并排使用。
何时不使用
需要更强的防机器校验时用 SliderCaptcha(滑块)或 ClickCaptcha(点选);需要短信验证时用独立的验证码输入组件。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
length | number | 4 | 验证码字符数量 |
width | number | 120 | 画布宽度(px) |
height | number | 40 | 画布高度(px) |
disabled | boolean | false | 禁用(不响应刷新) |
dark | boolean | false | 深色模式(适配深色背景,字符/干扰反色) |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:code | string | 每次生成后触发,携带当前验证码(配合 v-model:code 使用) |
refresh | void | 点击图片或刷新按钮时触发 |
示例
基础用法
示例加载中…
6 位验证码 + 刷新次数
示例加载中…
禁用态
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 ImageCaptcha 文档(含手机预览)。