前端html2canvas结合后端iText实现HTML转PDF方案
本文介绍利用前端html2canvas插件将HTML页面渲染为Canvas,并通过FormData或Base64字符串传输至Java后端,结合iText库生成PDF文件的完整流程。涵盖IE兼容性问题处理、跨域配置及后端接收转换代码示例。
需求背景与方案概述
实现导出PDF功能的需求,经过多次尝试后最终达成,过程中经历了不少曲折,且目前采用的方案仍可能存在优化空间。
前端可使用jsPDF插件直接生成PDF,操作简便,但该方案不支持IE浏览器。
前端实现:html2canvas集成与兼容处理
前端实现部分:
首先需要引入html2canvas.js库。
html2canvas(document.body, { //截图对象
//此处可配置详细参数
onrendered: function(canvas) { //渲染完成回调canvas
canvas.id = "mycanvas";
// 生成base64图片数据
var dataUrl = canvas.toDataURL('image/png'); //指定格式,也可不带参数
var formData = new FormData(); //模拟表单对象
formData.append("imgData",convertBase64UrlToBlob(dataUrl)); //写入数据
var xhr = new XMLHttpRequest(); //数据传输方法
xhr.open("POST", "../bulletin/exportPdf"); //配置传输方式及地址
xhr.send(formData);
xhr.onreadystatechange = function(){ //回调函数
if(xhr.readyState == 4){
if (xhr.status == 200) {
var back = JSON.parse(xhr.responseText);
if(back.success == true){
alertBox({content: 'Pdf导出成功!',lock: true,drag: false,ok: true});
}else{
alertBox({content: 'Pdf导出失败!',lock: true,drag: false,ok: true});
}
}
}
};
}
});
//将以base64的图片url数据转换为Blob
function convertBase64UrlToBlob(urlData){
//去掉url的头,并转换为byte
var bytes=window.atob(urlData.split(',')[1]);
//处理异常,将ascii码小于0的转换为大于0
var ab = new ArrayBuffer(bytes.length);
var ia = new Uint8Array(ab);
for (var i = 0; i < bytes.length; i++) {
ia[i] = bytes.charCodeAt(i);
}
return new Blob( [ab] , {type : 'image/png'});
}
该库的兼容性支持Firefox 3.5及以上版本、Chrome浏览器以及Opera浏览器,IE10及以上版本也可支持。
目前不支持的功能包括iframe嵌入、浏览器插件以及Flash内容。
若涉及跨域图片,需在跨域服务器的响应头中添加允许跨域请求的配置。
access-control-allow-origin: * access-control-allow-credentials: true
SVG图片目前无法直接支持,虽有相关补丁包,但本文未进行实际测试。
针对IE9浏览器,由于其不支持FormData数据格式及Blob对象,处理方式需调整为:将Canvas生成的Base64字符串去除URL前缀后,直接传递给后台服务器。
String base64 = Img.split(",")[1];
BASE64Decoder decode = new BASE64Decoder();
byte[] imgByte = decode.decodeBuffer(base64);
后端实现:iText库集成与PDF生成
后端处理部分:
需要在Java项目中导入itext jar包,官方下载地址为:https://sourceforge.net/projects/itext/。
@RequestMapping("/exportPdf")
public @ResponseBody void exportPdf(MultipartHttpServletRequest request,HttpServletResponse response)throws ServletException, IOException {
ResultData result = new ResultData(); //自定义结果格式
String filePath = "c:\\exportPdf2.pdf";
String imagePath = "c:\\exportImg2.bmp";
Document document = new Document();
try{
Map getMap = request.getFileMap();
MultipartFile mfile = (MultipartFile) getMap.get("imgData"); //获取数据
InputStream file = mfile.getInputStream();
byte[] fileByte = FileCopyUtils.copyToByteArray(file);
FileImageOutputStream imageOutput = new FileImageOutputStream(new File(imagePath));//打开输入流
imageOutput.write(fileByte, 0, fileByte.length);//生成本地图片文件
imageOutput.close();
PdfWriter.getInstance(document, new FileOutputStream(filePath)); //itextpdf文件
// document.setPageSize(PageSize.A2);
document.open();
document.add(new Paragraph("JUST TEST ..."));
Image image = Image.getInstance(imagePath); //itext-pdf-image
float heigth = image.getHeight();
float width = image.getWidth();
int percent = getPercent2(heigth, width); //按比例缩小图片
image.setAlignment(Image.MIDDLE);
image.scalePercent(percent+3);
document.add(image);
document.close();
result.setSuccess(true);
operatelogService.addOperateLogInfo(request, "导出成功:成功导出简报Pdf");
}catch (DocumentException de) {
System.err.println(de.getMessage());
}
catch (Exception e) {
e.printStackTrace();
result.setSuccess(false);
result.setErrorMessage(e.toString());
try {
operatelogService.addOperateLogError(request, "导出失败:服务器异常");
} catch (Exception e1) {
e1.printStackTrace();
}
}
response.getWriter().print(JSONObject.fromObject(result).toString());
}
private static int getPercent2(float h, float w) {
int p = 0;
float p2 = 0.0f;
p2 = 530 / w * 100;
p = Math.round(p2);
return p;
}
iText是SourceForge站点上的一个著名开源项目,主要用于Java环境中生成PDF文档的类库。
该库处理速度较快,并支持多种PDF的高级特性。
JS怎么实现页面强制刷新
2026-11-05 14:53:38
点击JS链接直接运行不下载?前端实现.js文件强制下载的三种方法
2026-11-05 12:12:23
怎么封装一个通用的JS创建元素辅助函数
2026-11-05 11:41:41
Swiper.js 怎么监听滑动结束并获取当前索引
2026-11-05 10:57:15
HTML、CSS和JS的关系:Web前端三件套怎么协作
2026-11-04 15:41:40
