跳到主要内容

ImageCaptcha 图片验证码 ​

uni-appH5微信小程序App

uni-app 跨端图片验证码。使用 <canvas type="2d"> 生成含干扰线/干扰点的字符图片,点击画布或刷新按钮重新生成;通过 update:code 同步当前验证码供父级校验。

何时使用 ​

登录、注册等需要图形验证码且希望完全前端生成的场景。

何时不使用 ​

需要服务端下发加密验证码或短信/邮箱二次校验时。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
ImageCaptcha 图片验证码 · uni-app H5 实时运行 新窗口打开

Props ​

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

Events ​

名称载荷说明
update:codestring每次生成后触发,携带当前验证码(父级据此校验用户输入)
refreshvoid点击画布或刷新按钮重新生成时触发

示例 ​

搭配输入框 ​

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>