纯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:评论里冷秋月同学对导出流程做了改良，可以解决闪烁以及背景的问题，大家可以参考。