SliderCaptcha 滑块验证码
uni-appH5微信小程序App
uni-app 跨端滑块验证码。拖动拼图块到随机缺口位置完成校验,对齐容差内通过(success 事件 + v-model 置 true),偏差则回弹重试。用跨端 touch 事件实现拖动,H5 / 小程序 / App 均可用。
何时使用
登录、发帖等需要较强人机校验的场景。
何时不使用
对无障碍有严格要求、或需要完全无交互的静默校验时,改用行为式/服务端校验。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
9:41
SliderCaptcha 滑块验证码 · uni-app H5 实时运行 新窗口打开
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
width | number | 300 | 组件宽度(px);容器更窄时自动收缩为容器宽度 |
modelValue | boolean | false | 是否已通过,配合 v-model 使用 |
disabled | boolean | false | 禁用 |
dark | boolean | false | 深色模式(适配深色背景) |
tip | string | "拖动滑块完成验证" | 未通过时的提示文案(uni-app 包无 locale 模块,文案通过 props 传入) |
successText | string | "验证通过" | 通过后的文案 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | boolean | 校验结果变化时触发 |
success | void | 拼图对齐通过时触发 |
fail | void | 拼图未对齐、回弹重试时触发 |
示例
基础用法
vue
<SliderCaptcha v-model="tf2" @success="onOk" />
<text class="demo-desc">验证状态:{{ tf2 ? '已通过' : '未通过' }}</text>深色模式
vue
<view style="background:#1f2329;padding:12px;border-radius:10px">
<SliderCaptcha v-model="tf3" dark />
</view>
<text class="demo-desc">验证状态:{{ tf3 ? '已通过' : '未通过' }}</text>自定义文案
vue
<SliderCaptcha v-model="tf4" tip="按住拖动完成拼图" success-text="拼图完成" />
<text class="demo-desc">验证状态:{{ tf4 ? '已通过' : '未通过' }}</text>