1.1.14 • Published 6 months ago

rs-puzzle v1.1.14

Weekly downloads
-
License
ISC
Repository
github
Last release
6 months ago

二改于vue-puzzle-vcode

vue-puzzle-vcode npm npm downloads

DEMO: https://isluo.com/work/vue-puzzle-vcode/

img

Vue3.x的使用文档在这

以下为Vue2.x使用文档

安装

  yarn add rs-puzzle@latest

使用

import rsPuzzle from "rs-puzzle";

<rs-puzzle :show="isShow" @success="onSuccess" @close="onClose" />

IE

我没加babel-polyfill,所以在 IE 里会报错:SCRIPT1002: 语法错误(IE 不支持箭头 函数) 需要兼容 IE 的朋友,请直接复制src/app.vuesrc/assets这两个东西 到自己的项目里,给app.vue随便改个名字,就是个普通 vue 组件,直接用即可。 src/assets里是一张小图片,app.vue中有引用,注意自己匹配一下引用路径

最简单例子

<template>
  <div>
    <rs-puzzle :show="isShow" @success="onSuccess" @close="onClose" />
    <button @click="submit">开始验证</button>
  </div>
</template>

<script>
import rsPuzzle from "rs-puzzle";
export default {
  data() {
    return {
      isShow: false,
    };
  },
  components: {
    rsPuzzle,
  },
  methods: {
    submit() {
      this.isShow = true;
    },

    onSuccess(msg) {
      this.isShow = false; // 通过验证后,需要手动关闭模态框
    },

    onClose() {
      this.isShow = false;
    },
  },
};
</script>

参数

字段类型默认值说明
showBooleanfalse是否显示验证码弹框
canvasWidthNumber310主图区域的宽度,单位 px
canvasHeightNumber160主图区域的高度,单位 px
puzzleScaleNumber1拼图块(小的拼图)的大小比例,0.2 ~ 2 ,数字越大,拼图越大
sliderSizeNumber50左下角用户拖动的那个滑块的尺寸,单位 px
rangeNumber10判断成功的误差范围,单位 px, 滑动的距离和拼图的距离小于等于此值时,会判定重合
imgsArraynull自定义图片,见下方例子
successTextString"验证通过!"验证成功时的提示文字
failTextString"验证失败,请重试"验证失败时的提示文字
sliderTextString"拖动滑块完成拼图"下方滑动条里的文字
headerTextString"请完成安全验证"上方弹窗标题
topString"40%"弹窗距离上方定位 支持 n+"%", n+"px"
leftString"50%"弹窗距离左边定位 支持 n+"%", n+"px"
translateXString"-50%"弹窗偏移 支持 n+"%", n+"px"
translateYString"-50%"弹窗弹窗偏移 支持 n+"%", n+"px"

事件

事件名返回值说明
success偏差值验证通过时会触发,返回值是用户移动的距离跟目标距离的偏差值 px
fail偏差值验证失败时会触发,返回值同上
closenull用户点击遮罩层的回调

自定义图片

<template>
  <rs-puzzle :imgs="[Img1, Img2]" />
</template>

<script>
import Img1 from "~/assets/img1.png";
import Img2 from "~/assets/img2.png";

export default {
  data() {
    return {
      Img1,
      Img2,
    };
  },
};
</script>
  • 也可以是网络图片完整 URL 路径,但注意图片跨域问题,因为 canvas api 无法对跨域的图片进行操作

说明

  • 当不传递 imgs 字段或图片加载出错时,会自动生成随机图片
  • 模态框的显示和隐藏完全由父级控制,所以用户通过验证后,需要手动隐藏模态框

更新日志

2022/12/01 - 1.1.10

  • 修复:修复了一个在判定过程中关闭模态框导致reset失效的问题

2021/10/18 - 1.1.9

  • 修复:修复了在判定状态还未刷新时关闭模态框,重新打开不刷新的问题

2021/10/13 - 1.1.8

  • 修复:解决了一个在safari中无法显示拼图块的问题(safari drawImage看起来像是异步操作)

2021/10/12 - 1.1.7

  • 修复:重复加载图片的问题
  • 修复:png图片的透明部分现在会用白色填充
  • 更新:初始化时不再自动加载图片,直到show出来时再加载
  • 更新:去掉了无用的id属性
1.1.14

6 months ago

1.1.13

6 months ago

1.1.12

6 months ago

1.1.11

6 months ago

1.1.10

6 months ago