Skip to content

滑动拼图验证码

随机形状(方形/三角形/梯形/五边形)与随机旋转的迷惑坑位的拼图验证。

示例

javascript
import { SliderCaptcha } from '@captcha-pro/core'

const captcha = new SliderCaptcha({
  el: '#slider-captcha',
  width: 300,
  height: 170,
  precision: 5,
  showRefresh: true,
  onSuccess: () => console.log('验证通过!'),
  onFail: () => console.log('验证失败!')
})

const data = captcha.getData()
console.log('目标位置:', data.target)

选项

参数类型默认值描述
elstring | HTMLElement-容器元素或选择器
bgImagestring-背景图片 URL
sliderImagestring-滑块图片 URL
widthnumber300容器宽度
heightnumber170容器高度
sliderWidthnumber42滑块宽度
sliderHeightnumber42滑块高度
precisionnumber5验证精度(像素)
showRefreshbooleantrue显示刷新按钮
classNamestring'captcha-slider'自定义类名
verifyMode'frontend' | 'backend''frontend'验证模式
backendVerifyBackendVerifyOptions-后端验证配置
securitySecurityOptions-安全选项
onSuccess() => void-验证成功回调
onFail() => void-验证失败回调
onRefresh() => void-刷新回调

BackendVerifyOptionsSecurityOptions 详见 API 选项

实例方法

方法描述
verify(data)手动验证
reset()重置验证码状态
refresh()生成新的验证码
destroy()销毁验证码实例
getData()获取验证码数据
getSignedData()获取带签名的数据用于后端验证
getStatistics()获取验证统计
resetStatistics()重置统计数据

基于 MIT 许可发布。