ClickCaptcha 点选验证码
uni-appH5微信小程序App
uni-app 跨端点选验证码。面板内随机分布汉字,按提示顺序点击目标字符完成校验;点错重置并重新生成。使用绝对定位 <text> 实现,H5 / 小程序 / App 均可用。
何时使用
登录、发帖等需要较强人机校验且希望体验比滑块更轻的场景。
何时不使用
对无障碍有严格要求、或需要完全无交互的静默校验时,改用行为式/服务端校验。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
count | number | 3 | 需要点选的字符数量 |
width | number | 300 | 面板宽度(px);容器更窄时自动收缩为容器宽度 |
height | number | 160 | 面板高度(px) |
disabled | boolean | false | 禁用 |
dark | boolean | false | 深色模式(适配深色背景) |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | boolean | 校验结果变化时触发 |
success | void | 按顺序全部点中时触发 |
fail | void | 点错字符、重置面板时触发 |
示例
基础用法
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>