跳到主要内容

ImageCaptcha 图形验证码 ​

WebH5

图形验证码。Canvas 绘制带干扰线与干扰点的随机字符(已剔除易混淆的 0/O、1/I/L),点击图片或刷新按钮重新生成,通过 update:code 暴露当前验证码供父级校验用户输入。

何时使用 ​

登录、注册等需要简单人机校验的场景,常与输入框并排使用。

何时不使用 ​

需要更强的防机器校验时用 SliderCaptcha(滑块)或 ClickCaptcha(点选);需要短信验证时用独立的验证码输入组件。

Props ​

名称类型默认值说明
lengthnumber4验证码字符数量
widthnumber120画布宽度(px)
heightnumber40画布高度(px)
disabledbooleanfalse禁用(不响应刷新)
darkbooleanfalse深色模式(适配深色背景,字符/干扰反色)

Events ​

名称载荷说明
update:codestring每次生成后触发,携带当前验证码(配合 v-model:code 使用)
refreshvoid点击图片或刷新按钮时触发

示例 ​

基础用法 ​

示例加载中…

6 位验证码 + 刷新次数 ​

示例加载中…

禁用态 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

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