跳到主要内容

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 ​

名称类型默认值说明
widthnumber300组件宽度(px);容器更窄时自动收缩为容器宽度
modelValuebooleanfalse是否已通过,配合 v-model 使用
disabledbooleanfalse禁用
darkbooleanfalse深色模式(适配深色背景)
tipstring"拖动滑块完成验证"未通过时的提示文案(uni-app 包无 locale 模块,文案通过 props 传入)
successTextstring"验证通过"通过后的文案

Events ​

名称载荷说明
update:modelValueboolean校验结果变化时触发
successvoid拼图对齐通过时触发
failvoid拼图未对齐、回弹重试时触发

示例 ​

基础用法 ​

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>