跳到主要内容

ClickCaptcha 点选验证码 ​

uni-appH5微信小程序App

uni-app 跨端点选验证码。面板内随机分布汉字,按提示顺序点击目标字符完成校验;点错重置并重新生成。使用绝对定位 <text> 实现,H5 / 小程序 / App 均可用。

何时使用 ​

登录、发帖等需要较强人机校验且希望体验比滑块更轻的场景。

何时不使用 ​

对无障碍有严格要求、或需要完全无交互的静默校验时,改用行为式/服务端校验。

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

9:41
ClickCaptcha 点选验证码 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
countnumber3需要点选的字符数量
widthnumber300面板宽度(px);容器更窄时自动收缩为容器宽度
heightnumber160面板高度(px)
disabledbooleanfalse禁用
darkbooleanfalse深色模式(适配深色背景)

Events ​

名称载荷说明
update:modelValueboolean校验结果变化时触发
successvoid按顺序全部点中时触发
failvoid点错字符、重置面板时触发

示例 ​

基础用法 ​

vue
<ClickCaptcha v-model="capOk" />
<text class="demo-desc">验证状态:{{ capOk ? '已通过' : '未通过,按提示顺序点击' }}</text>

深色模式 ​

vue
<view style="background:#1f2329;padding:12px;border-radius:10px">
  <ClickCaptcha v-model="capOk2" dark />
</view>
<text class="demo-desc">验证状态:{{ capOk2 ? '已通过' : '未通过,按提示顺序点击' }}</text>

自定义点数 ​

vue
<ClickCaptcha v-model="capOk3" :count="5" />
<text class="demo-desc">验证状态:{{ capOk3 ? '已通过' : '未通过,按提示顺序点击' }}</text>