跳到主要内容

ClickCaptcha 点选验证码 ​

WebH5

点选验证码。Canvas 随机散布一组字符,提示「依次点击」目标字符,按顺序点中全部通过(成功事件 + v-model 置 true),点错则刷新重试。受控:父组件把 v-model 改回 false 时清空点选进度,可用于表单重置。

何时使用 ​

需要更强人机校验、且希望交互成本较低的登录/表单场景。

何时不使用 ​

对点选交互不友好的人群(如部分移动端)或有严格无障碍要求时,用滑块或图形验证码。

Props ​

名称类型默认值说明
modelValuebooleanfalse是否已通过,支持 v-model;父组件重置为 false 时清空进度
countnumber3需要依次点选的字符数量
widthnumber300画布宽度(px)
heightnumber160画布高度(px)
disabledbooleanfalse禁用
darkbooleanfalse深色模式(字符反色、深色画布)

Events ​

名称载荷说明
update:modelValueboolean校验结果变化时触发
successvoid依次点中全部目标字符时触发
failvoid点错字符时触发

示例 ​

基础用法 ​

示例加载中…

放进表单 + 通过回显 ​

示例加载中…

表单重置:父组件改回 false ​

示例加载中…

暗色主题 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 ClickCaptcha 文档(含手机预览)。