项目需求:需要把当前整个页面的数据生成为一个图片,可以让用户长按图片保存到本地手机
在网上查到生成图片的有一个插件,叫做 html2canvas 可以把你想要转变的元素变为图片,开始很顺利,但是生成后的图片,和实际的页面不符合,图片不清晰,模糊的情况,网上大部分的解决方案是通过把 canvas 容器扩大,再将和成的图片进行缩放。这一种可以达到效果,就是麻烦,还有一个方法直接就可以解决,推荐大家使用第二种方法
// 本地的 html2canvas 版本为 "^0.5.0-beta4",
import html2canvas from 'html2canvas';
DPR() { // 获取设备dpi
if (window.devicePixelRatio && window.devicePixelRatio > 1) {
return window.devicePixelRatio;
}
return 1;
},
drawCanvas() {
setTimeout(() => {
// 获取想要转换的 DOM 节点
const dom = document.querySelector('.report');
const box = window.getComputedStyle(dom);
// DOM 节点计算后宽高
const width = parseInt(box.width, 10);
const height = parseInt(box.height, 10);
// 获取像素比
const scaleBy = this.DPR();
// 创建自定义 canvas 元素
const canvas = document.createElement('canvas');
// 设定 canvas 元素属性宽高为 DOM 节点宽高 * 像素比
canvas.width = width * scaleBy;
canvas.height = height * scaleBy;
// 设定 canvas css宽高为 DOM 节点宽高
canvas.style.width = `${width}px`;
canvas.style.height = `${height}px`;
// 获取画笔
const context = canvas.getContext('2d');
// 将所有绘制内容放大像素比倍
context.scale(scaleBy, scaleBy);
// 将自定义 canvas 作为配置项传入,开始绘制
html2canvas(dom, {canvas, background: '#ffffff'}).then((imgDom) => {
let url= imgDom.toDataURL();
console.log(url) // 此时的url是图片的base64格式,可直接赋值到img的src上
})
}, 2000);
},
作者在 html2canvas 的源码中添加了两个参数,分别为 scale 和 dpi,scale 是比例,辣么 dpi 是个什么玩意儿,以下是百度百科对 dpi 的定义:
- DPI 是指每英寸的像素,也就是扫描精度。DPI 越低,扫描的清晰度越低,由于受网络传输速度的影响,web 上使用的图片都是 72dpi,但是冲洗照片不能使用这个参数,必须是 300dpi 或者更高 350dpi。例如要冲洗 46 英寸的照片,扫描精度必须是 300dpi,那么文件尺寸应该是(4300)(6300)=1200 像素*1800 像素。 只要增大 dpi 或者 scale 肯定能使同样宽高的图像变得清晰,那么模糊的问题也就不存在了。
参数名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
scale | number | 1 | 按比例增加分辨率 (2=双倍). |
dpi | number | 96 | 将分辨率提高到特定的 DPI(每英寸点数) |
import "@/assets/js/html2canvas.js"; // 引入刚刚自己下载的js文件
// 调用的方法
html2canvas(document.querySelector(".report"), {
// 以下字段可选
width: 490, // canvas宽度
height: 240, // canvas高度
x: 0, // x坐标
y: 0, // y坐标
foreignObjectRendering: true, // 是否在浏览器支持的情况下使用ForeignObject渲染
useCORS: true, // 是否尝试使用CORS从服务器加载图像
async: false, // 是否异步解析和呈现元素
// 以下字段必填
background: "#ffffff", // 一定要添加背景颜色,否则出来的图片,背景全部都是透明的
dpi: 300, // 处理模糊问题
onrendered: function (canvas) {
// https://developer.mozilla.org/zh-CN/docs/Web/API/HTMLCanvasElement/toDataURL
// let url = canvas.toDataURL('image/png', 1.0)
let url = canvas.toDataURL();
console.log(url);
},
});
- 有一些 css 样式没有办法直接识别,比如新增的 css,渐变,或者是 border-radius: 50%; 是没有效果的,必须要写成固定的数值才可以,正确写法:border-radius: 50px
- 如果你项目的背景色默认是白色的,你自己也没有给项目添加颜色,生成后的图片就是带透明效果,所以要给 html 添加一个白色背景颜色
- 第一种方法不需要自己单独下载 js 到本地项目中,第二种方法需要单独下载 js 文件
- 都看到这里麻烦给点个小赞,在 github 上点个 star,附带支持 dpi 修改清晰度 html2canvas 的源码👉 https://github.com/li1164267803/xiwen-html2canvas/tree/master/dist
- Blog:https://blog.csdn.net/weixin_44309374/article/details/106924138