HTML转为PDF,图片导出失败的终极解决方案

2023-08-04,,

如题项目有需求将一个页面导出为pdf,然而页面中的图片却始终无法导出成功

文章目录

一、导出的方法
二、初步测试的结果
三、使用f12查找原油
四、方案一
五、方案二
六、方案三
七、完整代码
1、使用XMLHttpRequest进行图片二次下载
2、转换页面的图片
3、html2canvas执行下载
4、供外部调用的导出方法

一、导出的方法

查询了许多大佬的帖子,找到了如下导出的方法

  const PdfDownload = function(domId) {
var targetDom = $('#'+domId)
// 把需要导出的pdf内容clone一份,这样对它进行转换、微调等操作时才不会影响原来界面
var copyDom = targetDom.clone()
// 新的div宽高跟原来一样,高度设置成自适应,这样才能完整显示节点中的所有内容(比如说表格滚动条中的内容)
copyDom.width(targetDom.width() + 'px')
copyDom.height(targetDom.height()+200 + 'px') $('body').append(copyDom)// ps:这里一定要先把copyDom append到body下,然后再进行后续的glyphicons2canvas处理,不然会导致图标为空 // svg2canvas(copyDom)
// loadImg(copyDom)
html2canvas(copyDom, {
onrendered: function(canvas) {
var imgData = canvas.toDataURL('image/jpeg')
var img = new Image()
img.src = imgData
// 根据图片的尺寸设置pdf的规格,要在图片加载成功时执行,之所以要*0.225是因为比例问题
img.onload = function() {
// 此处需要注意,pdf横置和竖置两个属性,需要根据宽高的比例来调整,不然会出现显示不完全的问题
if (this.width > this.height) {
var doc = new jsPDF('l', 'mm', [this.width * 0.225, this.height * 0.225])
} else {
var doc = new jsPDF('p', 'mm', [this.width * 0.225, this.height * 0.225])
}
doc.addImage(imgData, 'jpeg', 0, 0, this.width * 0.225, this.height * 0.225)
// 根据下载保存成不同的文件名
doc.save('pdf_' + new Date().getTime() + '.pdf')
}
// 删除复制出来的div
copyDom.remove()
},
background: '#FFF',
// 这里给生成的图片默认背景,不然的话,如果你的html根节点没设置背景的话,会用黑色填充。
allowTaint: true // 避免一些不识别的图片干扰,默认为false,遇到不识别的图片干扰则会停止处理html2canvas
})
}

二、初步测试的结果

有了上面的方法当然迫不及待的进行测试-- 测试导出页面如下

导出成功结果如下

这一测试发现并没有得到自己期望的结果,页面大致导出成功了,可是页面原本的头像图片怎么就没导出来呢?



三、使用f12查找原油

打开浏览器使用另一个用户进行测试发现… 该用户没有上传头像,我默认加载了一张本地的图片作为用户默认头像

而加载为默认图片的页面使用jsPdf将其进行导出,这个头像图片就可以成功被下载下来

于是做出如下推测…

经过这一测试初步断定是js 中同源策略所引起的跨域请求图片,所导致的jsPdf读取页面中图片失败的问题

四、方案一

到目前,问题虽然初步已锁定,但是还没有切实可行的解决方案,这咋办?

首先想到:就是把图片从服务器下载到本地

于是想到了使用nodeJS http+fs 从服务器将文件下载,然后将其写入到本地文件夹中

如参考 https://www.jianshu.com/p/28e3de79fd49

var http = require(''http'),fs = require('fs');
http.get(path,function(req,res){ //path为网络图片地址
var imgData = '';
req.setEncoding('binary');
req.on('data',function(chunk){
imgData += chunk
})
req.on('end',function(){
fs.writeFile(path,imgData,'binary',function(err){ //path为本地路径例如public/logo.png
if(err){console.log('保存出错!')}else{
console.log('保存成功!')
}
})
})
})

再重新 为节点添加一个img 标签,将其url指定为刚才下载的文件地址,在pdf 下载完成后再使用

如下方法将其删除掉 参考 https://blog.csdn.net/dongmelon/article/details/102456717

var fs = require('fs')
/**
*
* @param {*} path 必传参数可以是文件夹可以是文件
* @param {*} reservePath 保存path目录 path值与reservePath值一样就保存
*/
function delFile(path, reservePath) {
if (fs.existsSync(path)) {
if (fs.statSync(path).isDirectory()) {
let files = fs.readdirSync(path);
files.forEach((file, index) => {
let currentPath = path + "/" + file;
if (fs.statSync(currentPath).isDirectory()) {
delFile(currentPath, reservePath);
} else {
fs.unlinkSync(currentPath);
}
});
if (path != reservePath) {
fs.rmdirSync(path);
}
} else {
fs.unlinkSync(path);
}
} }

后来经测试,很显然这个想法很幼稚(浏览器如何使用nodeJS?), 最终测试这种方法是不可行的!

五、方案二

使用canvas 根据图片url重新将图片绘制然后进行下载

参考https://www.jb51.net/article/128554.htm

/**
*
* 查询目标容器中images
* 使用nodejs进行图片下载到本地
* 增加一个image 使用本地src
* @param targetElem {Element object}
*/
function loadImg(targetElem){ var svgElem = targetElem.find('img')
svgElem.each(function(index, node) {
var parentNode = node.parentNode
//通过构造函数来创建的 img 实例,在赋予 src 值后就会立刻下载图片,相比 createElement() 创建 <img> 省去了 append(),也就避免了文档冗余和污染
var Img = new Image(),
dataURL='';
Img.src=url;
Img.onload=function(){ //要先确保图片完整获取到,这是个异步事件
var canvas = document.createElement("canvas"), //创建canvas元素
width=Img.width, //确保canvas的尺寸和图片一样
height=Img.height;
canvas.width=width;
canvas.height=height;
canvas.getContext("2d").drawImage(Img,0,0,width,height); //将图片绘制到canvas中
dataURL=canvas.toDataURL('image/jpeg'); //转换图片为dataURL
}; parentNode.appendChild(canvas)
})
}

后来又遇到了Uncaught SecurityError: Failed to execute 'toDataURL' on 'HTMLCanvasElement': Tainted canvases may not be exported.

根据资料https://blog.csdn.net/u013040887/article/details/78986598 在方法中新增node.setAttribute('crossOrigin', 'anonymous'); 遗憾的是最后并未成功解决问题,依然需要重新寻找新的解决方案…

六、方案三

然后想到了使用XMLHttpRequest先把图片下载回来再重新为img 赋值

于是 增加如下方法使用 xmlHttpRequest进行图片下载

function downloadByXmlhttprequest(imgDom,cb){

  var xhr = new XMLHttpRequest()

    xhr.onreadystatechange = function () {
var blob
if(xhr.readyState === 4){ // 使用URL.createObjectURL将Blob对象转换为可访问的url地址
var src = URL.createObjectURL(xhr.response)
console.log(src)
imgDom.src = src
cb(src)
}
} xhr.open('GET',imgDom.src, true)
// 设置响应数据格式为Blob对象
xhr.responseType = 'blob' // 设置请求头
xhr.setRequestHeader('X-Requested-With', 'OpenAPIRequest') xhr.send()
}

参考https://blog.csdn.net/weixin_34384915/article/details/91756646

但是其中又遇到了请求未携带cookie而失败问题

后来参照 https://blog.csdn.net/u011674895/article/details/83932461解决token失效问题

在方法中添加如下代码

xhr.withCredentials = true;

最终经过如下多次测试,终于成功了

七、完整代码

最后完成这些操作的完整代码(这里我是写了一个外部js)如下

1、使用XMLHttpRequest进行图片二次下载
/**
* 使用XMLHttpRequest进行图片二次下载
* @param imgDom {Objec} target object
* @param cb{Object}success callback
*/
function downloadByXmlhttprequest(imgDom,cb){ var xhr = new XMLHttpRequest() xhr.onreadystatechange = function () {
if(xhr.readyState === 4){ // 使用URL.createObjectURL将Blob对象转换为可访问的url地址
var src = URL.createObjectURL(xhr.response)
imgDom.src = src
cb(src)
}
} xhr.open('GET',imgDom.src, true)
xhr.withCredentials = true;
// 设置响应数据格式为Blob对象
xhr.responseType = 'blob' // 设置请求头
xhr.setRequestHeader('X-Requested-With', 'OpenAPIRequest') xhr.send()
}
2、转换页面的图片
function imgConvert(targetElem,cb){
var svgElem = targetElem.find('img')
svgElem.each(function(index, node) {
var parentNode = node.parentNode
downloadByXmlhttprequest(node,cb)
}) }
3、html2canvas执行下载
function executeDown(copyDom){
html2canvas(copyDom, {
onrendered: function(canvas) {
var imgData = canvas.toDataURL('image/jpeg')
var img = new Image()
img.src = imgData
// 根据图片的尺寸设置pdf的规格,要在图片加载成功时执行,之所以要*0.225是因为比例问题
img.onload = function() {
// 此处需要注意,pdf横置和竖置两个属性,需要根据宽高的比例来调整,不然会出现显示不完全的问题
if (this.width > this.height) {
var doc = new jsPDF('l', 'mm', [this.width * 0.225, this.height * 0.225])
} else {
var doc = new jsPDF('p', 'mm', [this.width * 0.225, this.height * 0.225])
}
doc.addImage(imgData, 'jpeg', 0, 0, this.width * 0.225, this.height * 0.225)
// 根据下载保存成不同的文件名
doc.save('pdf_' + new Date().getTime() + '.pdf')
}
// 删除复制出来的div
copyDom.remove()
},
background: '#FFF',
// 这里给生成的图片默认背景,不然的话,如果你的html根节点没设置背景的话,会用黑色填充。
allowTaint: true // 避免一些不识别的图片干扰,默认为false,遇到不识别的图片干扰则会停止处理html2canvas
})
}
4、供外部调用的导出方法
const PdfDownload = function(domId) {
var targetDom = $('#'+domId)
// 把需要导出的pdf内容clone一份,这样对它进行转换、微调等操作时才不会影响原来界面
var copyDom = targetDom.clone()
// 新的div宽高跟原来一样,高度设置成自适应,这样才能完整显示节点中的所有内容(比如说表格滚动条中的内容)
copyDom.width(targetDom.width() + 'px')
copyDom.height(targetDom.height()+200 + 'px') $('body').append(copyDom)// ps:这里一定要先把copyDom append到body下,然后再进行后续的glyphicons2canvas处理,不然会导致图标为空 // svg2canvas(copyDom)
// loadImg(copyDom)
imgConvert(copyDom,function(res){
executeDown(copyDom)
}) } export { PdfDownload }

最后这里使用到的 html2canvas-0.4.1 , jquery-2.1.4.min , jspdf.min 如下

插件网盘https://pan.baidu.com/s/1MMNOjmU8H3ebmWdB5nBzqw 提取码 jg7q

HTML转为PDF,图片导出失败的终极解决方案的相关教程结束。

《HTML转为PDF,图片导出失败的终极解决方案.doc》

下载本文的Word格式文档,以方便收藏与打印。