一、问题描述

在工作的过程中会遇到要将dom变成图片并下载的问题，刚开始使用的html2canvas进行转换的，但是我老大告诉我说，咱们做的是面向国外的网页，插件太大会导致页面加载慢的问题（国外部分地区网络没有国内这么发达），就让我用原生dom或一些比较小的插件，在原生dom下载的时候遇到了context.drawImage(element, 0, 0, width, height)这一方法传入参数要传类型HTMLCanvasElement的问题，所以要将一个HTMLElement转换成HTMLCanvasElement，但是经过一些信息的查找，我发现有个很好用且轻量化的插件，可以完美解决这一问题，所以这里给大家推荐一个轻量级的插件dom-to-image（23kb），这个插件可以不用进行类型转换，直接将dom元素转换成需要的文件格式。

二、dom-to-image的使用

2.1 dom-to-image的安装

在终端输入以下代码进行dom-to-image安装

npm install dom-to-image

2.2 dom-to-image引入

2.2.1 vue项目引入

在需要使用这个插件的页面使用以下代码进行局部引入

import domToImage from 'dom-to-image';

然后就可以通过以下代码进行图片的转换了

const palGradientGap = document.getElementById('element') const canvas = document.createElement('canvas') canvas.width = element.offsetWidth canvas.height = element.offsetHeight this.domtoimage.toPng(element).then(function (canvas) { const link = document.createElement('a') link.href = canvas link.download = 'image.png' // 下载文件的名称 link.click() })

当然也可以进行全局引入

创建一个domToImage.js文件写入以下代码

import Vue from 'vue'; import domToImage from 'dom-to-image'; const domToImagePlugin = { install(Vue) { Vue.prototype.$domToImage = domToImage; } };Vue.use(domToImagePlugin);

然后再入口文件main.js写入以下代码全局引入插件

import Vue from 'vue'import App from './App.vue' import './domToImage.js'; // 引入全局插件 Vue.config.productionTip = false new Vue({ render: h => h(App), }).$mount('#app')

三、dom-to-image相关方法

toSvg(node: Node, options?: Options): Promise<string>：将 DOM 元素转换为 SVG 图片，并返回一个 Promise 对象。

参数说明：

node：要转换为图片的 DOM 元素。options：可选参数对象，用于配置转换选项。

toPng(node: Node, options?: Options): Promise<string>：将 DOM 元素转换为 PNG 图片，并返回一个 Promise 对象。

参数说明：

node：要转换为图片的 DOM 元素。options：可选参数对象，用于配置转换选项。

toJpeg(node: Node, options?: Options): Promise<string>：将 DOM 元素转换为 JPEG 图片，并返回一个 Promise 对象。

参数说明：

node：要转换为图片的 DOM 元素。options：可选参数对象，用于配置转换选项。

toBlob(node: Node, options?: Options): Promise<Blob>：将 DOM 元素转换为 Blob 对象，并返回一个 Promise 对象。

参数说明：

node：要转换为图片的 DOM 元素。options：可选参数对象，用于配置转换选项。

toPixelData(node: Node, options?: Options): Promise<Uint8ClampedArray>：将 DOM 元素转换为像素数据，并返回一个 Promise 对象。

参数说明：

node：要转换为图片的 DOM 元素。options：可选参数对象，用于配置转换选项。

toCanvas(node: Node, options?: Options): Promise<HTMLCanvasElement>：将 DOM 元素转换为 Canvas 对象，并返回一个 Promise 对象。

参数说明：

node：要转换为图片的 DOM 元素。options：可选参数对象，用于配置转换选项。

其中，Options 参数是一个可选的配置对象，用于设置转换选项。以下是一些常用的选项：

width：输出图像的宽度，默认值为元素的实际宽度。height：输出图像的高度，默认值为元素的实际高度。style：要应用于元素的样式对象。filter：要应用于元素的 CSS 滤镜。bgcolor：输出图像的背景颜色，默认值为透明。quality：输出图像的质量，仅适用于 JPEG 格式，默认值为 0.92。