一、 html2pdf
文档地址 https://ekoopmans.github.io/html2pdf.js/
html2canvas + jsPDF
工作流:
.from() -> .toContainer() -> .toCanvas() -> .toImg() -> .toPdf() -> .save()
实现
按照 npm 的来就行,问题不大,按自己的需求稍微改了一些属性 www.npmjs.com/package/htm…
var element = document.getElementById('element-to-print'); //获取到要导出的 dom 节点
var opt = {
filename: 'myfile.pdf',
image: { type: 'jpeg', quality: 0.98 },
html2canvas: { scale: 1, useCORS: true, logging: false},
jsPDF: { unit: 'in', format: 'a4', orientation: 'l' },
pagebreak: { mode: 'avoid-all' },
enableLinks: false,
};
// New Promise-based usage:
html2pdf().from(element).set(opt).save();
属性
filename:导出文件名
image: canvas 转成 img 的格式及质量
enableLinks: 是否允许 link 到网页,默认 true
pageBreak: 分页符位置,avoided from breaking inside all elements(避免在完整dom前断层),pdf 高度还是一致的,不足一页的会留白
<div class="html2pdf__page-break"></div>
pagebreak: { mode: 'avoid-all' }
html2canvas:
* useCORS:允许跨域
* logging: 设置成 false
* scale:值越大,越清晰,文件也会越大
jsPDF:
* Portrait(纵向)和Landscape(横向) 其他属性相同的前提下,p 比 l 的画布短一些,有截断的情况, 设置成 shortcut 后,导出没有反应
* unit:单位
* format: 格式
优化
* 添加蒙版,获取下载完成的状态,antd 好像不需要,有防抖的功能,一直点击不会触发多次请求
* 导出时,阻止页面滚动,实际不阻止滚动也会下载完整的 pdf,就是初始位置需要控制一下
* 自动换行,不截断,设置 pageBreak
坑
* 引用import html2pdf from 'html2pdf.js'; ".js"一定要加上,否则获取不到html2pdf方法, npm 有讲
* google 浏览器默认会自动阻止多次下载同一个文件,第一次做下载文件的话,记得瞄一眼地址栏
* 偶现网络崩溃(???????)
真的有人在用 html2pdf 吗?页面卡成翔了,在研究了两天无果后,换成了 html2canvas + jspdf ,流畅哭了,而且还能自定义 canvas 画布的属性,可控多了!
二、 html2canvas + jspdf
1、 分页导出 cloud.tencent.com/developer/a…
import html2canvas from 'html2canvas';
import jsPdf from 'jspdf';
let ele = document.getElementsByTagName('main')[0];
let eleW = ele.offsetWidth// 获得该容器的宽
// let eleH = ele.offsetHeight // 获得该容器的高
let eleH = ele.scrollHeight// 获得该容器的高
let eleOffsetTop = ele.offsetTop// 获得该容器到文档顶部的距离
let eleOffsetLeft = ele.offsetLeft// 获得该容器到文档最左的距离
var canvas = document.createElement("canvas")
var abs = 0
let win_in = document.documentElement.clientWidth || document.body.clientWidth
// 获得当前可视窗口的宽度(不包含滚动条)
let win_out = window.innerWidth// 获得当前窗口的宽度(包含滚动条)
if (win_out>win_in) {
// abs = (win_o - win_i)/2; // 获得滚动条长度的一半
abs = (win_out - win_in) / 2// 获得滚动条宽度的一半
}
canvas.width = eleW * 2// 将画布宽&&高放大两倍
canvas.height = eleH * 2
var context = canvas.getContext("2d")
context.scale(2, 2) // 增强图片清晰度
context.translate(-eleOffsetLeft - abs, -eleOffsetTop)
html2canvas(ele, {
dpi:300,
useCORS:true//允许canvas画布内可以跨域请求外部链接图片, 允许跨域请求。
}).then(canvas=> {
var contentWidth = canvas.width
var contentHeight = canvas.height
//一页pdf显示html页面生成的canvas高度;
// 这样写的目的在于保持宽高比例一致 pageHeight/canvas.width = a4纸高度/a4纸宽度
// 宽度和canvas.width保持一致
var pageHeight = (contentWidth / 592.28) * 841.89
//未生成pdf的html页面高度
var leftHeight = contentHeight
//页面偏移
var position = 0
//a4纸的尺寸[595.28,841.89],单位像素,html页面生成的canvas在pdf中图片的宽高
var imgWidth = 595.28
var imgHeight = (595.28 / contentWidth) * contentHeight
var pageData = canvas.toDataURL("image/jpeg", 1.0)
var pdf = new jsPdf("", "pt", "a4")
//有两个高度需要区分,一个是html页面的实际高度,和生成pdf的页面高度(841.89)
//当内容未超过pdf一页显示的范围,无需分页
if (leftHeight<pageHeight) {
//在pdf.addImage(pageData, 'JPEG', 左,上,宽度,高度)设置在pdf中显示;
pdf.addImage(pageData, "JPEG", 5, 0, imgWidth, imgHeight)
// pdf.addImage(pageData, 'JPEG', 20, 40, imgWidth, imgHeight);
} else {
// 分页
while (leftHeight>0) {
pdf.addImage(pageData, "JPEG", 5, position, imgWidth, imgHeight)
leftHeight -= pageHeight
position -= 841.89
//避免添加空白页
if (leftHeight>0) {
pdf.addPage()
}
}
}
pdf.save("my.pdf");
})
2、整页导出 pdf(最后选了整页导出的方案,希望能说服客户爸爸)
document.getElementsByClassName('ant-breadcrumb')[0].setAttribute("data-html2canvas-ignore",true);
let ele = document.getElementsByTagName('main')[0];
ele.style.padding = '25px';
html2canvas(ele, {
useCORS: true,
scale: 2 // 提升画面质量,但是会增加文件大小
}).then(function (canvas) {
/**jspdf将html转为pdf一页显示不截断,整体思路:
* 1. 获取DOM
* 2. 将DOM转换为canvas
* 3. 获取canvas的宽度、高度(稍微大一点)
* 4. 将pdf的宽高设置为canvas的宽高
* 5. 将canvas转为图片
* 6. 实例化jspdf,将内容图片放在pdf中(因为内容宽高和pdf宽高一样,就只需要一页,也防止内容截断问题)
*/
// 得到canvas画布的单位是px 像素单位
var contentWidth = canvas.width
var contentHeight = canvas.height
// 将canvas转为base64图片
var pageData = canvas.toDataURL('image/jpeg', 1.0)
// 设置pdf的尺寸,pdf要使用pt单位 已知 1pt/1px = 0.75 pt = (px/scale)* 0.75
// 2为上面的scale 缩放了2倍
var pdfX = (contentWidth ) / 2 * 0.75
var pdfY = (contentHeight + 500 ) / 2 * 0.75// 500为底部留白
// 设置内容图片的尺寸,img是pt单位
var imgX = pdfX;
var imgY = (contentHeight / 2 * 0.75); //内容图片这里不需要留白的距离
// 初始化jspdf 第一个参数方向:默认''时为纵向,第二个参数设置pdf内容图片使用的长度单位为pt,第三个参数为PDF的大小,单位是pt
var PDF = new jsPdf('', 'pt', [pdfX, pdfY])
// 将内容图片添加到pdf中,因为内容宽高和pdf宽高一样,就只需要一页,位置就是 0,0
PDF.addImage(pageData, 'jpeg', 0, 0, imgX, imgY)
PDF.save('systemReport.pdf')
})
获取宽高的方法
var doc = new jsPDF("p", "mm", "a4");
var width = doc.internal.pageSize.width;
var height = doc.internal.pageSize.height;
文件内存小的方法(不扩大画布大小)
document.getElementsByClassName('ant-breadcrumb')[0].setAttribute("data-html2canvas-ignore",true);
let ele = document.getElementsByTagName('main')[0];
html2canvas(ele, {
useCORS: true,
scale: 1, // 图片不清晰,但是文件内存小
}).then(function (canvas) {
var contentWidth = canvas.width;
var contentHeight = canvas.height;
// var pageData = canvas.toDataURL('image/jpeg', 1.0)
var pdfX = (contentWidth ) * 0.75
var pdfY = (contentHeight + 500 ) * 0.75
var imgX = pdfX - 20; // 20 为左右边距的和
var imgY = (contentHeight * 0.75);
var PDF = new jsPDF('', 'pt', [pdfX, pdfY]);
PDF.internal.pageSize.setWidth(pdfX);
PDF.addImage(canvas, 'jpeg', 10, 10, imgX, imgY); // 10,10 设置相对于 x, y 坐标的值
PDF.save("fileName.pdf");
})