纯js实现html转pdf

项目开发中遇到了一个变态需求，需要把一整个页面导出为pdf格式，而且要保留页面上的所有的表格、svg图片和样式。

简而言之，就是希望像截图一样，把整个页面截下来，然后保存成pdf。

咋不上天呢……

查了一下，能够实现html转pdf的方法还是挺多的，大概有以下几种：

1、大部分浏览器就有这个功能。然而我们客户要的可不是这个，人家要的是能够在系统中主动触发的导出为pdf功能，所以这种方案pass。

2、利用第三方工具。我找到了一种利用wkhtmltopdf这种工具来导出的方案，自己在我们的项目中试了一下，效果不好，而且对svg图片的支持也不行。pass。

3、还有一种是利用iText类后台生成java文件。但因为需要导出的这个页面是动态页面，而且直接把页面传给后台会丢失大量样式，所以还是pass。

最后没什么好的办法，只能退而求其次，想着要不先把html页面转成图片，再把图片导出为pdf。因为要支持用户导出下载，而且要保留样式，所以最好是纯js前端实现。

html转canvas的话，就用html2canvas这个js，这个网上介绍比较多了，这里就不废话了。

比较麻烦的是svg图片，直接用html2canvas无法把svg标签的内容转成canvas，最后查了一圈资料后，锁定了canvg这个js。canvg是谷歌的一个插件，可以将svg标签内容转成canvas。具体到我们的项目，还有一个难点，就是如何把glyphicons这种字体图标也转成canvas，因为在不同浏览器下对这种字体图标的支持是完全不一样的。最后找到的方法是用char code来替换这些字体图标，重新绘制成canvas。由canvas生成图片不用废话。由图片生成pdf用jsPDF实现。 折腾了大半天，总算把整个流程打通了，接下来一步一步贴上代码。

第一步：把对应dom节点里所有的svg元素替换成canvas

 svg2canvas: function(targetElem) {
   var svgElem = targetElem.find('svg');
   svgElem.each(function(index, node) {
     var parentNode = node.parentNode;
     //由于现在的IE不支持直接对svg标签node取内容，所以需要在当前标签外面套一层div，通过外层div的innerHTML属性来获取
     var tempNode = document.createElement('div');
     tempNode.appendChild(node);
     var svg = tempNode.innerHTML;
     var canvas = document.createElement('canvas');
     //转换
     canvg(canvas, svg);
     parentNode.appendChild(canvas);
   });
 }

第二步：把glyphicons字体转成canvas。如果项目中没有用到glyphicons字体图标，可忽略这一步

 glyphicons2canvas: function(targetElem, fontClassName, fontFamilyName) {
   var iconElems = targetElem.find('.' + fontClassName);
   iconElems.each(function(index, inconNode) {
     var fontSize = $(inconNode).css("font-size");
     var iconColor = $(inconNode).css("color");
     var styleContent = $(inconNode).attr('style');
     //去掉"px"
     fontSize = fontSize.replace("px", "");
     var charCode = getCharCodeByGlyphiconsName(iconName);
     var myCanvas = document.createElement('canvas');
     //把canva宽高各增加2是为了显示图标完整
     myCanvas.width = parseInt(fontSize) + 2;
     myCanvas.height = parseInt(fontSize) + 2;
     myCanvas.style = styleContent;
     var ctx = myCanvas.getContext('2d');
     //设置绘图内容的颜色
     ctx.fillStyle = iconColor;
     //设置绘图的字体大小以及font-family的名字
     ctx.font = fontSize + 'px ' + fontFamilyName;
     ctx.fillText(String.fromCharCode(charCode), 1, parseInt(fontSize) + 1);
     $(inconNode).replaceWith(myCanvas);
   });
 }
 //根据glyphicons/glyphicon图标的类名获取到对应的char code
 getCharCodeByGlyphiconsName: function(iconName) {
   switch (iconName) {
   case("glyphicons-resize-full"):
     return "0xE216";
   case ("glyphicons-chevron-left"):
     return "0xE225";
   default:
     return "";
   }
 }

第三步：html转canvas转图片再转pdf

 html2canvas($("#myExportArea"), {
   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('report_pdf_' + new Date().getTime() + '.pdf');
     }
   },
   background: "#fff",
   //这里给生成的图片默认背景，不然的话，如果你的html根节点没设置背景的话，会用黑色填充。
   allowTaint: true //避免一些不识别的图片干扰，默认为false，遇到不识别的图片干扰则会停止处理html2canvas
 });

虽然最后勉强完成了客户的要求，但是生成的pdf效果明显不如正常截图来的清晰……水平所限，暂时只能想到这种方法，如果大家有更好的办法，欢迎指点。

一个简单的demo：https://github.com/SuperNaturalGit/HtmlToPdf

使用方法：

使用Git克隆项目到本地：git clone https://github.com/SuperNaturalGit/HtmlToPdf.git

使用chrome浏览器打开index.html即可。其他浏览器的兼容性没测试。

如果不用git，直接把几个文件全部copy到本地，只要相对路径没问题，也可以运行的。

ps:评论里冷秋月同学对导出流程做了改良，可以解决闪烁以及背景的问题，大家可以参考。