Vue3实现手写签名之Vue3-signature的快速应用实例

 更新时间:2026年04月09日 11:19:53   作者:用户3905133219288  
签名组件在许多应用场景中都非常有用,比如在线合同签署、电子表格签名等,这篇文章主要介绍了Vue3实现手写签名之Vue3-signature的快速应用的相关资料,需要的朋友可以参考下

前言

在公务办理、电子合同、在线审批等场景中,手写签名的电子化需求越来越常见。基于 Vue3 开发的 vue3-signature 组件,能快速帮我们实现浏览器端的手写签名功能,无需复杂的 canvas 原生开发,今天就带大家从零掌握这个实用组件的使用。

一、什么是 vue3-signature?

vue3-signature是专门适配 Vue3 生态的手写签名组件,底层基于 canvas 实现,支持鼠标、触摸(移动端)手写,提供了签名保存、清空、回退、更换颜色 / 粗细等核心功能,体积轻量、API 简洁,完美兼容 Vue3 的组合式 API 和语法,是 Vue3 项目实现电子签名的首选方案。

二、快速上手:5 分钟集成到 Vue3 项目

1. 安装依赖

首先在 Vue3 项目中安装组件(支持 npm/yarn/pnpm):

npmnpm install vue3-signature --save# yarnyarn add vue3-signature# pnpmpnpm add vue3-signature

2. 基础使用示例

在 Vue3 单文件组件中引入并使用,这是最核心的基础用法:

<template>  <div class="signature-container">    <!-- 签名画布核心组件 -->    <Vue3Signature      ref="signatureRef"      :width="500"      :height="300"      :pen-color="#000000"      :pen-width="3"      :disabled="false"      class="signature-canvas"    />
    <!-- 操作按钮组 -->    <div class="signature-btns">      <button @click="clearSignature">清空签名</button>      <button @click="saveSignature">保存签名</button>      <button @click="undoSignature">撤销一步</button>    </div>  </div></template><script setup>import { ref } from 'vue'import Vue3Signature from 'vue3-signature'// 获取组件实例const signatureRef = ref(null)// 清空签名const clearSignature = () => {  signatureRef.value.clear()}// 撤销上一步书写const undoSignature = () => {  // 先判断是否有可撤销的步骤  if (signatureRef.value.canUndo()) {    signatureRef.value.undo()  } else {    alert('已无可撤销的步骤!')  }}// 保存签名(支持Base64/Blob格式)const saveSignature = () => {  // 获取Base64格式的签名图片  const base64 = signatureRef.value.getDataUrl('image/png', 1.0)  // 也可获取Blob格式(适合上传)  // const blob = signatureRef.value.getBlob('image/png', 1.0)
  console.log('签名Base64:', base64)  // 可将base64/blob上传到后端,或展示在页面上}</script><style scoped>.signature-container {  width: 500px;  margin: 20px auto;}.signature-canvas {  border: 1px solid #e5e5e5;  border-radius: 4px;}.signature-btns {  margin-top: 15px;  display: flex;  gap: 10px;}.signature-btns button {  padding: 6px 12px;  background: #409eff;  color: #fff;  border: none;  border-radius: 4px;  cursor: pointer;}.signature-btns button:hover {  background: #66b1ff;}</style>

下面是签名的效果展示:

三、核心配置与常用 API

1. 核心属性(Props)

属性名类型默认值说明
widthNumber400画布宽度(px)
heightNumber200画布高度(px)
penColorString#000000画笔颜色(支持十六进制)
penWidthNumber2画笔粗细(px)
disabledBooleanfalse是否禁用签名
backgroundColorString#ffffff画布背景色

2. 常用方法(通过 ref 调用)

方法名参数说明功能
clear()清空整个签名画布
undo()撤销上一步书写
canUndo()判断是否可撤销(返回布尔值)
getDataUrl(type, quality)type:图片格式(如 image/png);quality:清晰度(0-1)获取签名的 Base64 编码
getBlob(type, quality)同 getDataUrl获取签名的 Blob 对象(适合上传)

四、实战优化:解决常见问题

1. 适配移动端

vue3-signature天然支持触摸事件,只需保证画布宽度适配移动端:

<Vue3Signature  :width="document.documentElement.clientWidth - 40"  :height="200"  ref="signatureRef"/>

2. 校验是否签名

提交前判断用户是否完成签名,避免空签名提交:

const checkSignature = () => {  // isEmpty() 判断画布是否为空  if (signatureRef.value.isEmpty()) {    alert('请完成手写签名!')    return false  }  return true}// 保存前先校验const saveSignature = () => {  if (!checkSignature()) return  // 后续保存逻辑...}

3. 图片跨域问题

若需在签名画布中插入背景图(如合同模板),需确保图片资源支持跨域,否则会导致getDataUrl/getBlob报错,可要求后端配置跨域头,或使用同域图片。 **# 五、总结

  • vue3-signature是 Vue3 项目实现电子签名的高效组件,基于 canvas 封装,无需原生 canvas 开发,API 简洁易上手;
  • 核心流程:安装 → 引入组件 → 配置基础属性 → 通过 ref 调用方法实现清空、保存、撤销等功能;
  • 实际开发中需注意移动端适配、签名非空校验、图片跨域等细节,满足不同场景的签名需求。

组件几乎覆盖了电子签名的所有基础场景,无论是简单的表单签名,还是复杂的合同签署,都能快速落地。赶紧在你的 Vue3 项目中试试吧!更多参考地址:www.npmjs.com/package/vue…**

总结

到此这篇关于Vue3实现手写签名之Vue3-signature快速应用的文章就介绍到这了,更多相关Vue3手写签名Vue3-signature内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • vue过滤器用法实例分析

    vue过滤器用法实例分析

    这篇文章主要介绍了vue过滤器用法,结合实例形式总结分析了vue.js常见过滤器相关使用技巧与操作注意事项,需要的朋友可以参考下
    2019-03-03
  • vue-devtools 开发工具插件之支持vue3 chrome 浏览器插件

    vue-devtools 开发工具插件之支持vue3 chrome 浏览器插件

    这篇文章主要介绍了vue-devtools 开发工具插件之支持vue3 chrome 浏览器插件,用这个版本主要是为了支持vue3 推荐直接下载,文中给大家提供了下载地址,感兴趣的朋友跟随小编一起看看吧
    2022-01-01
  • vue.js element-ui tree树形控件改iview的方法

    vue.js element-ui tree树形控件改iview的方法

    这篇文章主要介绍了vue.js element-ui tree树形控件改iview的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-03-03
  • Vue+express+Socket实现聊天功能

    Vue+express+Socket实现聊天功能

    这篇文章主要为大家详细介绍了Vue+express+Socket实现聊天功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-06-06
  • vue/react单页应用后退不刷新方案

    vue/react单页应用后退不刷新方案

    本文主要介绍了vue/react单页应用后退不刷新方案,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-10-10
  • 基于Vue-Cli 打包自动生成/抽离相关配置文件的实现方法

    基于Vue-Cli 打包自动生成/抽离相关配置文件的实现方法

    基于Vue-cli 项目产品部署,涉及到的交互的地址等配置信息,每次都要重新打包才能生效,极大的降低了效率。这篇文章主要介绍了基于Vue-Cli 打包自动生成/抽离相关配置文件 ,需要的朋友可以参考下
    2018-12-12
  • vue+elementUI实现表单和图片上传及验证功能示例

    vue+elementUI实现表单和图片上传及验证功能示例

    这篇文章主要介绍了vue+elementUI实现表单和图片上传及验证功能,结合实例形式分析了vue+elementUI表单相关操作技巧,需要的朋友可以参考下
    2019-05-05
  • vue-cli随机生成port源码的方法

    vue-cli随机生成port源码的方法

    这篇文章主要介绍了vue-cli随机生成port源码的方法,文中给大家介绍了vue 随机色生成方法,需要的朋友可以参考下
    2019-09-09
  • 详解Vue与element-ui整合方式

    详解Vue与element-ui整合方式

    vue在前端技术中使用越来越多,也成为了主流框架,今天咱花点时间学习下Vue与element-ui整合方式,本文结合示例代码给大家介绍的非常详细,需要的朋友参考下吧
    2022-04-04
  • vue调用本地缓存方式(监视数据变更)

    vue调用本地缓存方式(监视数据变更)

    这篇文章主要介绍了vue调用本地缓存方式(监视数据变更),具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-04-04

最新评论