Vue使用sign-canvas实现在线手写签名

Vue组件:sign-canvas手写签名板实现与功能更新
本文介绍了基于Vue的sign-canvas组件,它是一个适用于PC和移动端的通用手写签名板。内容包括版本v1.1.4和v1.1.3的功能更新,如全屏模式和高倍屏适配,并提供了安装、使用示例及完整的Vue代码。通过sign-canvas,可以实现签名、清除、保存和下载签名图片等功能。

效果图:

09630c977d7e4682b2402b4be10b0a3f.png

efc460cb12214708a61f507c87574293.png

sign-canvas 一个基于 canvas 开发,封装于 Vue 组件的通用手写签名板(电子签名板),支持 pc 端和移动端。

 更新日志

v1.1.4 功能更新:增加全屏手写方案,可以通过 options.isFullScreen,和 options.isFullCover 属性控制,全屏模式下 canvasWidth 和 canvasHeight 属性设置无效,感谢网友 AFelicity”的建议与反馈。

v1.1.3 功能更新:增加高倍屏下,绘制会模糊的适配方案,可以通过 options.isDpr 属性进行开启或者关闭,感谢网友“Wong-Harry”的建议与反馈。

安装

npm install --save sign-canvas

全局方式

main.js:

import SignCanvas from "sign-canvas";

Vue.use(SignCanvas);

局部方式

//局部注册 模板中引入


import SignCanvas from "sign-canvas";

components: {
    SignCanvas;
}

53e825ac812045ecbad4cbdbb27e3d0f.png

de8da9ce667d4267be01c700044554d7.png

9a6ca8eb75ee40a3987619fd25311868.png  

 完整代码: 

<template>
  <div class="sign">
    <sign-canvas
      class="sign-canvas"
      ref="SignCanvas"
      :options="options"
      v-model="value"
    />
    <div class="btnList" ref="btnList">
      <van-button type="danger" v-throttle size="small" @click="clearSignImg">清空</van-button>
      <van-button type="primary" v-throttle size="small" class="ml30 mr30" @click="saveSignImg">保存</van-button>
      <van-button type="primary" v-throttle size="small" @click="back">返回</van-button>
    </div>
  </div>
</template>

<script>
//接口引入
import { signShipmentsContract } from "../../api/userMG";
export default {
  name: "signDialog",
  //props: {
    //组件传递的值
    //visible: {
      //type: Boolean,
      //default: false,
    //},
    //图片信息Base64
    //src: {
      //type: String,
      //default: null,
    //},
  //},
  data() {
    return {
      value: null,
      //配置
      options: {
        lastWriteSpeed: 1, //书写速度 [Number] 可选
        lastWriteWidth: 2, //下笔的宽度 [Number] 可选
        lineCap: "round", //线条的边缘类型 [butt]平直的边缘 [round]圆形线帽 [square]	正方形线帽
        lineJoin: "round", //线条交汇时边角的类型  [bevel]创建斜角 [round]创建圆角 [miter]创建尖角。
        canvasWidth: "750", //canvas宽高 [Number] 可选
        canvasHeight: "500", //高度  [Number] 可选
        isShowBorder: false, //是否显示边框 [可选]
        bgColor: "#fcc", //背景色 [String] 可选
        borderWidth: 1, // 网格线宽度  [Number] 可选
        borderColor: "#ff787f", //网格颜色  [String] 可选
        writeWidth: 5, //基础轨迹宽度  [Number] 可选
        maxWriteWidth: 30, // 写字模式最大线宽  [Number] 可选
        minWriteWidth: 5, // 写字模式最小线宽  [Number] 可选
        writeColor: "#101010", // 轨迹颜色  [String] 可选
        isSign: true, //签名模式 [Boolean] 默认为非签名模式,有线框, 当设置为true的时候没有任何线框
        imgType: "png", //下载的图片格式  [String] 可选为 jpeg  canvas本是透明背景的
      },
    };
  },
  created() {

  },
  mounted() {
    let windowHeight = document.documentElement.clientHeight;
    let btnList = this.$refs.btnList.offsetHeight;
    let windowWidth = document.documentElement.clientWidth;
    this.options.canvasWidth = windowWidth;
    this.options.canvasHeight = windowHeight - btnList;
    // console.log(this.$refs.SignCanvas.saveAsImg(),"this.$refs.SignCanvas.saveAsImg()")

  },
  methods: {
    //清除画板
    clearSignImg() {
      this.$refs.SignCanvas.canvasClear();
    },
    // 保存图片
    saveSignImg() {
      console.log(this.value, "value");
      if (this.value == null) {
        this.$toast.fail("请先签名");
      } else {
        this.$dialog
          .confirm({
            title: "签名确认",
            message: "请先确认签名是否正确,一旦签名成功,无法撤销",
          })
          .then(() => {
            console.log(1);
            const img = this.$refs.SignCanvas.saveAsImg();
            this.signShipmentsContractFun(img);
          })
          .catch(() => {
            console.log(2);
            this.$toast.fail({
              message: "签名取消,请重新签名",
              onClose: () => {
                this.$refs.SignCanvas.canvasClear();
              },
            });
          });
      }
    },
    //下载图片/
    // downloadSignImg() {
    //   this.$refs.SignCanvas.downloadSignImg();
    // },
    back() {
      this.$router.back(-1);
    },
    // 签名
    signShipmentsContractFun(img) {
      let params = {
        contractId: this.$route.query.contractId,
        carrierContractPicture: img,
        contractInfoDto: JSON.parse(this.$route.query.contractList),
      };
      signShipmentsContract(params)
        .then((res) => {
          console.log(res, "签名");
          if (res.code == 200) {
            this.$toast.success({
              message: "保存成功",
              onClose: () => {
                this.$router.back(-1);
              },
            });
          } else {
            this.$toast.fail(res.msg);
          }
        })
        .catch((error) => {});
    },
  },
};
</script>

<style lang="scss" scoped>
.btnList {
  position: fixed;
  bottom: 0;
  left: 0;
  width: 100%;
  padding: 30px 0;
  display: flex;
  justify-content: center;
}
.sign-canvas {
  display: block;
  margin: 0 auto;
  background: #F1F1F1 !important;
  border-radius: 8px;
}
</style>

发文不易,点赞、收藏、评论、关注一下呗! 

`sign-canvas` 是一个用于实现签名功能的轻量级前端组件,常用于 Vue 项目中。它基于 HTML5 的 Canvas 技术,允许用户在网页上进行手写签名,并提供了多种 API 方法来控制签名行为和获取签名数据。 ### 基本使用方法 #### 安装 首先需要安装 `vue-sign-canvas` 包。可以通过 npm 或 yarn 进行安装: ```bash npm install vue-sign-canvas ``` 或 ```bash yarn add vue-sign-canvas ``` #### 引入组件 在 Vue 组件中引入并注册 `VueSignCanvas`: ```javascript import Vue from 'vue'; import VueSignCanvas from 'vue-sign-canvas'; Vue.use(VueSignCanvas); ``` #### 模板中使用 在模板中使用 `<vue-sign-canvas>` 标签,并通过 `ref` 获取实例以调用其方法: ```vue <template> <div> <vue-sign-canvas ref="signature" /> <button @click="clearSignature">清空签名</button> <button @click="getSignatureImage">获取签名图片</button> </div> </template> ``` #### 调用方法 在 Vue 组件的方法中,可以通过 `this.$refs.signature` 来访问 `sign-canvas` 实例,并调用其提供的 API 方法。 ##### 清空签名区 调用 `clear()` 方法可以清空画布上的签名内容: ```javascript methods: { clearSignature() { this.$refs.signature.clear(); } } ``` ##### 获取签名图片 调用 `toDataURL()` 方法可以将当前签名区域的内容转换为 Data URL 格式的数据,通常用于上传或显示图像: ```javascript methods: { getSignatureImage() { this.$refs.signature.toDataURL().then(dataUrl => { // 使用 dataUrl 处理签名图像 console.log('签名图片的 Data URL:', dataUrl); }); } } ``` ### 高级配置 `sign-canvas` 提供了丰富的配置选项,例如设置画布大小、笔触颜色、线条宽度等。这些配置可以通过 props 传递给组件: ```vue <vue-sign-canvas ref="signature" :width="800" :height="400" :pen-color="'#FF0000'" :line-width="2" /> ``` - `width`: 设置画布的宽度。 - `height`: 设置画布的高度。 - `pen-color`: 设置签名笔的颜色。 - `line-width`: 设置签名线条的宽度。 ### 应用场景 `sign-canvas` 可广泛应用于以下场景: - **电子合同签署**:用户可以在网页上直接签署电子合同,生成 PDF 或图片格式保存。 - **表单验证**:作为身份验证的一部分,要求用户输入手写签名- **在线支付确认**:在支付流程中加入签名步骤,增强安全性。 - **医疗记录**:患者可以在医生建议书上签字,便于归档和管理。 通过上述方式,可以轻松集成 `sign-canvas` 到 Vue 项目中,并利用其强大的 API 和配置选项满足不同业务需求 [^1]。 ---
评论 6
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

船长在船上

您的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值