vue实践：构建高效的电子签名功能

2024-01-30 13:52
文章标签 javascript 高效 构建 实践 功能 vue frontend 电子签名

本文主要是介绍vue实践：构建高效的电子签名功能，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

前言

在现代数字化时代，电子签名成为了一种方便、高效且安全的签署文件的方式。本文将介绍电子签名的原理和实现方法，帮助你快速掌握这一重要的工具。

电子签名是什么？

电子签名是一种数字化的签名方式，用于验证和确认电子文档、合同或其他电子信息的真实性和完整性。它是传统纸质签名的数字化替代品，具有更高的效率、便捷性和安全性。大家看下面这个例子就会一目了然了。

一、手动实现一个简单的电子签名

下面的示例中，我们使用了 Canvas 元素来绘制用户的签名。当用户按下鼠标左键时，startDrawing 方法会被调用，开始绘制路径。当用户移动鼠标时，draw 方法会被调用，绘制路径。当用户释放鼠标左键时，stopDrawing 方法会被调用，停止绘制路径。点击"清除"按钮会清除 Canvas 上的内容，点击"保存"按钮会将签名保存为 Base64 编码的图片数据。

<template><div><canvas ref="canvas" @mousedown="startDrawing" @mousemove="draw" @mouseup="stopDrawing"></canvas><div><button @click="clearCanvas">清除</button><button @click="saveSignature">保存</button></div></div>
</template><script>
export default {data() {return {isDrawing: false, // 是否正在绘制context: null, // Canvas上下文};},mounted() {this.context = this.$refs.canvas.getContext("2d"); // 获取Canvas上下文this.$refs.canvas.width = 500; // 设置Canvas的宽度this.$refs.canvas.height = 300; // 设置Canvas的高},methods: {// 鼠标按下时触发startDrawing(event) {this.isDrawing = true; // 开始绘制const { offsetX, offsetY } = event; // 获取鼠标相对于Canvas的偏移量this.context.beginPath(); // 开始新的路径this.context.moveTo(offsetX, offsetY); // 将路径移动到鼠标位置},// 当鼠标在 Canvas 上移动时触发draw(event) {if (!this.isDrawing) return; // 如果没有在绘制中，则返回const { offsetX, offsetY } = event; // 获取鼠标相对于Canvas的偏移量this.context.lineTo(offsetX, offsetY); // 绘制路径this.context.stroke(); // 绘制路径的边框},// 当鼠标松开时触发，用于停止绘制签名stopDrawing() {this.isDrawing = false; // 停止绘制},// 清除clearCanvas() {this.context.clearRect(0,0,this.$refs.canvas.width,this.$refs.canvas.height); // 清除Canvas上的内容},// 保存saveSignature() {const dataURL = this.$refs.canvas.toDataURL(); // 获取签名图片的Base64编码// 在这里可以将dataURL发送到服务器保存，或者进行其他操作console.log(dataURL); // 输出签名的Base64编码到控制台},},
};
</script>
<style scoped>
canvas {border: 1px solid red;
}
</style>

实现效果
在这里插入图片描述

二、vue-esign 插件

vue-esign 是一个基于 vue.js 框架的电子签名组件库，它提供了一套现成的 UI 组件，包括签名面板、工具栏等，可以方便地在 vue.js 应用中实现电子签名功能。

2.1 安装

npm install vue-esign --save

2.2 引用

  • 全局引用

    import vueEsign from 'vue-esign'
Vue.use(vueEsign)

  • 局部引用

    import vueEsign from 'vue-esign'
components: { vueEsign }

2.3 使用

<template><div class="box"><vue-esign ref="esign" :width="300" :height="150" :isCrop="isCrop" :lineWidth="lineWidth" :lineColor="lineColor":bgColor.sync="bgColor" /><div><button @click="handleReset">清空画板</button><button @click="handleGenerate">生成图片</button></div><img :src="resultImg" alt=""></div>
</template><script>
import vueEsign from "vue-esign";
export default {components: { vueEsign },data() {return {lineWidth: 6,lineColor: "#000000",bgColor: "",resultImg: "",isCrop: false,};},mounted() {},methods: {handleReset() {this.$refs.esign.reset();},handleGenerate() {this.$refs.esign.generate({ format: "png", quality: 0.8 }).then((res) => {this.resultImg = res;}).catch((err) => {console.error(err);alert("生成图片失败：" + err.message);});},},
};
</script>
<style scoped>
.box {width: 300px;height: 150px;border: 1px solid red;
}
</style>

实现效果

在这里插入图片描述

此外，vue-esign 插件还支持画笔粗细自定义、画笔颜色自定义等等，感兴趣的同学可以看下面的属性试试。

2.4 常用的属性

属性类型默认值描述
widthNumber800画布宽度，即导出图片的宽度
heightNumber300画布高度，即导出图片的高度
lineWidthNumber4画笔粗细
lineColorString#000000画笔颜色
bgColorString空画布背景色，为空时画布背景透明，支持多种格式 ‘#ccc’，‘#E5A1A1’，‘rgb(229, 161, 161)’，‘rgba(0,0,0,.6)’，‘red’
isCropBooleanfalse是否裁剪，在画布设定尺寸基础上裁掉四周空白部分
isClearBgColorBooleantrue清空画布时(reset)是否同时清空设置的背景色(bgColor)
formatStringimage/png生成图片格式 image/jpeg(jpg格式下生成的图片透明背景会变黑色请慎用或指定背景色)、 image/webp
qualityNumber1生成图片质量；在指定图片格式为 image/jpeg 或 image/webp的情况下，可以从 0 到 1 的区间内选择图片的质量。如果超出取值范围，将会使用默认值 0.92。其他参数会被忽略。

三、vue-signature-pad 插件

vue-signature-pad 同样是一个基于 vue.js 框架的电子签名组件库，它提供了一个可定制的签名面板，可以方便地在 vue.js 应用中实现电子签名功能。

注意： 如果仍在使用 vue2 ，请安装 2.0.5 版本，对于 vue3，可以安装最新的发布版本。

3.1 安装

npm i vue-signature-pad@2.0.5

3.2 全局引用

import VueSignature from "vue-signature-pad";
Vue.use(VueSignature);

3.3 使用

<template><div class="box"><VueSignaturePad width="300px" height="150px" ref="signaturePad" /><div><button @click="save">保存</button><button @click="undo">撤销</button></div></div>
</template><script>
export default {data() {return {};},mounted() {},methods: {// 撤销操作undo() {this.$refs.signaturePad.undoSignature();},// 保存操作save() {const { isEmpty, data } = this.$refs.signaturePad.saveSignature();console.log(data);},},
};
</script>
<style scoped>
.box {width: 300px;height: 150px;border: 1px solid red;
}
</style>

实现效果

在这里插入图片描述

3.4 常用的属性

属性类型默认值描述
widthString100%画布宽度
heightString100%画布高度
optionsObject{}设置画笔的选项，包括线条颜色、宽度、透明度等
imagesArray[]设置背景图片。可以是 [‘1.png’, ‘2.png’] 或者 [{ src: ‘1.png’, x: 0, y: 0 }, { src: ‘2.png’, x: 0, y: 10 }]
customStyleObject{}设置画布的自定义样式。可以是一个CSS样式对象
scaleToDevicePixelRatioBooleantrue设置是否将画布缩放到设备像素比

3.5 常用的方法

方法参数描述
saveSignature(type, encoderOptions)(String, Number)保存当前的签名，并返回一个包含签名是否为空和签名数据的对象
undoSignature()-撤销上一步的签名操作
clearSignature()-清除当前的签名
mergeImageAndSignature(signature)Object 或者 String将指定的背景图片与当前的签名合并
addImages(images)Array添加多个背景图片
lockSignaturePad()-锁定签名画布，禁止用户进行签名操作
openSignaturePad()-解锁签名画布，允许用户进行签名操作
getPropImagesAndCacheImages()-获取图像的信息
clearCacheImages()-清除缓存的图片
fromDataURL(data, options, callback)(String, Object, Callback)从指定的DataURL加载签名数据
fromData(data)String从指定的数据加载签名数据
toData()-获取当前的签名数据
isEmpty()-检查当前的签名是否为空

完整功能代码

<template><div class="box"><!-- VueSignaturePad 组件 --><VueSignaturePad :width="width" :height="height" :options="options" :images="images" :customStyle="customStyle":scaleToDevicePixelRatio="scaleToDevicePixelRatio" ref="signaturePad" /><div><!-- 操作按钮 --><button @click="save">保存</button><button @click="undo">撤销</button><button @click="clear">清除</button><button @click="mergeImage">合并图片</button><button @click="addImages">添加图片</button><button @click="lock">锁定</button><button @click="unlock">解锁</button><button @click="getData">获取数据</button><button @click="isEmpty">是否为空</button><button @click="getPropImagesAndCacheImages">获取并缓存背景图片</button><button @click="clearCacheImages">清除缓存的背景图片</button><button @click="loadSignatureFromDataURL">从 Data URL 加载签名</button><button @click="loadSignatureFromData">从 JSON 数据加载签名</button></div></div>
</template><script>
export default {data() {return {width: "1000px",height: "500px",options: {minWidth: 2, // 画笔最小宽度maxWidth: 5, // 画笔最大宽度throttle: 16, // 画笔移动事件的时间间隔，单位为毫秒minDistance: 5, // 画笔移动的最小距离，单位为像素backgroundColor: "rgba(255, 255, 255, 0)", // 画布背景颜色penColor: "red", // 画笔颜色velocityFilterWeight: 0.7, // 画笔速度过滤器的权重onBegin: () => {}, // 开始签名时的回调函数onEnd: () => {}, // 结束签名时的回调函数},images: [],customStyle: {signatureCanvas: {border: "1px solid #ccc", // 画布边框borderRadius: "5px", // 画布圆角},signaturePad: {boxShadow: "0 0 5px rgba(0, 0, 0, 0.1)", // 画笔阴影},},scaleToDevicePixelRatio: true,};},methods: {// 保存签名save() {const { isEmpty, data } = this.$refs.signaturePad.saveSignature();console.log("签名是否为空:", isEmpty);console.log("签名数据:", data);},// 撤销签名undo() {this.$refs.signaturePad.undoSignature();},// 清除签名clear() {this.$refs.signaturePad.clearSignature();},// 合并图片和签名mergeImage() {const image = "image.jpg"; // 替换为你的背景图片路径this.$refs.signaturePad.mergeImageAndSignature(image);},// 添加图片addImages() {const images = ["image.jpg", "image.jpg"]; // 替换为你的背景图片路径数组this.$refs.signaturePad.addImages(images);},// 锁定签名画布lock() {this.$refs.signaturePad.lockSignaturePad();},// 解锁签名画布unlock() {this.$refs.signaturePad.openSignaturePad();},// 获取签名数据getData() {const data = this.$refs.signaturePad.toData();console.log("获取签名数据:", data);},// 检查签名是否为空isEmpty() {const empty = this.$refs.signaturePad.isEmpty();if (!empty) {alert("画布不为空！");} else {alert("画布为空！");}},// 获取并缓存背景图片getPropImagesAndCacheImages() {const images = ["image1.jpg", "image2.jpg"]; // 替换为你的背景图片路径数组this.$refs.signaturePad.getPropImagesAndCacheImages(images);},// 清除缓存的背景图片clearCacheImages() {this.$refs.signaturePad.clearCacheImages();},// 从 Data URL 加载签名loadSignatureFromDataURL() {const dataURL = "data:image/png;base64,iVBORw0KG..."; // 替换为你的 Data URLthis.$refs.signaturePad.fromDataURL(dataURL);},// 从 JSON 数据加载签名loadSignatureFromData() {const signatureData = {width: 500,height: 500,data: [{color: "#000",points: [{ x: 100, y: 100 },{ x: 200, y: 200 },{ x: 300, y: 300 },],},{color: "#f00",points: [{ x: 400, y: 400 },{ x: 450, y: 450 },{ x: 500, y: 500 },],},], //替换你的数据};const pointGroups = signatureData.data;this.$refs.signaturePad.fromData(pointGroups);},},
};
</script>
<style scoped>
.box {width: 1000px;height: 500px;border: 1px solid red;
}
</style>

四、vue-esign 和 vue-signature-pad 的区别？

4.1 共同点

  • 兼容 PC 和 移动端；
  • 同时支持 vue2 和 vue3;
  • 画布自适应屏幕大小变化（窗口缩放、屏幕旋转时画布无需重置，自动校正坐标）；
  • 自定义画布尺寸，画笔粗细、颜色，画布背景色。

4.2 不同点

  • vue-signature-pad 带笔压功能，可以根据笔的速度和方向来调整线条的粗细，不是固定粗细的，vue-esign 不支持此功能；
  • vue-signature-pad 的 vue2 和 vue3 依赖安装版本不同；vue-esign 都版本向下兼容，不需要区分 vue2 和 vue3;
  • vue-signature-pad 支持单步撤回，vue-esign 不支持此功能。

笔压对比效果

左边是 vue-signature-pad 插件，可以看到画笔线条不是固定粗细的，右边是 vue-esign 插件，线条是固定的粗细。
在这里插入图片描述

相关推荐

⭐ 浅谈 JSON 对象和 FormData 相互转换，打通前端与后端的通信血脉

这篇关于vue实践：构建高效的电子签名功能的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/660452。

相关文章

Spring Boot循环依赖原理、解决方案与最佳实践(全解析)

Spring Boot循环依赖原理、解决方案与最佳实践(全解析)

《SpringBoot循环依赖原理、解决方案与最佳实践(全解析)》循环依赖指两个或多个Bean相互直接或间接引用,形成闭环依赖关系,：本文主要介绍SpringBoot循环依赖原理、解决方案与最... 目录一、循环依赖的本质与危害1.1 什么是循环依赖？1.2 核心危害二、Spring的三级缓存机制2.1 三
阅读更多...
使用Python构建一个Hexo博客发布工具

使用Python构建一个Hexo博客发布工具

《使用Python构建一个Hexo博客发布工具》虽然Hexo的命令行工具非常强大,但对于日常的博客撰写和发布过程,我总觉得缺少一个直观的图形界面来简化操作,下面我们就来看看如何使用Python构建一个... 目录引言Hexo博客系统简介设计需求技术选择代码实现主框架界面设计核心功能实现1. 发布文章2. 加
阅读更多...
SpringBoot集成Milvus实现数据增删改查功能

SpringBoot集成Milvus实现数据增删改查功能

《SpringBoot集成Milvus实现数据增删改查功能》milvus支持的语言比较多,支持python,Java,Go,node等开发语言,本文主要介绍如何使用Java语言,采用springboo... 目录1、Milvus基本概念2、添加maven依赖3、配置yml文件4、创建MilvusClient
阅读更多...
JS+HTML实现在线图片水印添加工具

JS+HTML实现在线图片水印添加工具

《JS+HTML实现在线图片水印添加工具》在社交媒体和内容创作日益频繁的今天,如何保护原创内容、展示品牌身份成了一个不得不面对的问题,本文将实现一个完全基于HTML+CSS构建的现代化图片水印在线工具... 目录概述功能亮点使用方法技术解析延伸思考运行效果项目源码下载总结概述在社交媒体和内容创作日益频繁的
阅读更多...
前端CSS Grid 布局示例详解

前端CSS Grid 布局示例详解

《前端CSSGrid布局示例详解》CSSGrid是一种二维布局系统，可以同时控制行和列，相比Flex（一维布局），更适合用在整体页面布局或复杂模块结构中,：本文主要介绍前端CSSGri... 目录css Grid 布局详解（通俗易懂版）一、概述二、基础概念三、创建 Grid 容器四、定义网格行和列五、设置行
阅读更多...
使用Python开发一个带EPUB转换功能的Markdown编辑器

使用Python开发一个带EPUB转换功能的Markdown编辑器

《使用Python开发一个带EPUB转换功能的Markdown编辑器》Markdown因其简单易用和强大的格式支持,成为了写作者、开发者及内容创作者的首选格式,本文将通过Python开发一个Markd... 目录应用概览代码结构与核心组件1. 初始化与布局 (__init__)2. 工具栏 (setup_t
阅读更多...
Python 中的 with open文件操作的最佳实践

Python 中的 with open文件操作的最佳实践

《Python中的withopen文件操作的最佳实践》在Python中,withopen()提供了一个简洁而安全的方式来处理文件操作,它不仅能确保文件在操作完成后自动关闭,还能处理文件操作中的异... 目录什么是 with open()？为什么使用 with open()？使用 with open() 进行
阅读更多...
前端下载文件时如何后端返回的文件流一些常见方法

前端下载文件时如何后端返回的文件流一些常见方法

《前端下载文件时如何后端返回的文件流一些常见方法》：本文主要介绍前端下载文件时如何后端返回的文件流一些常见方法,包括使用Blob和URL.createObjectURL创建下载链接,以及处理带有C... 目录1. 使用 Blob 和 URL.createObjectURL 创建下载链接例子：使用 Blob
阅读更多...
Vuex Actions多参数传递的解决方案

Vuex Actions多参数传递的解决方案

《VuexActions多参数传递的解决方案》在Vuex中,actions的设计默认只支持单个参数传递,这有时会限制我们的使用场景,下面我将详细介绍几种处理多参数传递的解决方案,从基础到高级,... 目录一、对象封装法（推荐）二、参数解构法三、柯里化函数法四、Payload 工厂函数五、TypeScript
阅读更多...
SpringBoot实现微信小程序支付功能

SpringBoot实现微信小程序支付功能

《SpringBoot实现微信小程序支付功能》小程序支付功能已成为众多应用的核心需求之一,本文主要介绍了SpringBoot实现微信小程序支付功能,文中通过示例代码介绍的非常详细,对大家的学习或者工作... 目录一、引言二、准备工作（一）微信支付商户平台配置（二）Spring Boot项目搭建（三）配置文件
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2