欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

解决html导出pdf中文乱码问题的正确姿势

程序员文章站 2022-07-02 12:22:56
简介 本文使用jspdf 1.5.3版。GitHub地址: "https://github.com/MrRio/jsPDF" jspdf是歪果仁开发的,因此在一开始就没想过支持非英文以外的文字,这就导致了非英文的文本都是乱码。 因此就有其他大佬给增加了其他解决方案,到了1.5版本也正式加入了非英文支 ......

简介

本文使用jspdf 1.5.3版。github地址:https://github.com/mrrio/jspdf

jspdf是歪果仁开发的,因此在一开始就没想过支持非英文以外的文字,这就导致了非英文的文本都是乱码。

因此就有其他大佬给增加了其他解决方案,到了1.5版本也正式加入了非英文支持的解决方案。

解决的思路大致是,给jspdf加载其他字体库,使其能够正常输出中文。

打包字体文件

在开始的第一步我们需要从github下载源代码,因为我们需要使用其中附带的工具fontconverter

下载好后我们进入fontconverter文件夹可以看到以下目录。

解决html导出pdf中文乱码问题的正确姿势

直接使用浏览器打开fontconverter.html文件,可以看到如下界面

解决html导出pdf中文乱码问题的正确姿势

点击选择"*.ttf"字体文件,然后点击生成,会得到一个js文件。这个文件就是把字体文件通过base64编码转换成字符串存储到js文件中。该文件在后续步骤中使用。

生成的js文件结构大概如下:

解决html导出pdf中文乱码问题的正确姿势

重点注意

  1. 字体文件仅支持ttf格式的文件,并且区分字体的粗细,如果html包含多种粗细的文本,必须加载多个字体
  2. fontname 字段必须设置为小写(存在bug的原因)
  3. 善意的提醒:不要使用商用授权字体,除非你有授权,商用授权字体如:微软雅黑

思源字体下载:https://pan.baidu.com/s/14yae8x_zz0wmy19npgrwrg

注意:此下载仅为博主随意找的一个网盘打包连接,建议大家到官网地址下载。

编写测试代码

在全面应用之前需要做一些测试,避免不必要的弯路。测试代码如下

<script src="https://html2canvas.hertzen.com/dist/html2canvas.js"></script>
    <script src='../../dist/jspdf.debug.js'></script>
    <script src="../../dist/sourcehansanscn-normal-normal.js"></script>
<script>
    var doc = new jspdf({ orientation: 'p', format: 'a4' });
        doc.setfont('sourcehansanscn-normal', 'normal');
        doc.setfontsize(20);
        doc.html('<div style="font-faimly:sourcehansanscn-normal;">chinese: 中文</div>', {
            callback: function (newdoc) {
                newdoc.save('chinese-html.pdf')
            }
        });

        doc.text("中文欢迎您", 1, 30);
        doc.save('chinese-pdf.pdf')
</script>

因为html转pdf依赖html2canvas.js因此需要先加载此文件,github地址:

此处代码导出了2个pdf文件,设置了中文字体后,一个是直接使用jspdf的api直接绘制pdf,另外一个则是使用html输出pdf文件。

重点注意:导出html需要在导出的html中对中文文本直接指定font-faimly,否者html导出的pdf仍会中文乱码

html转pdf代码

如果以上测试代码通过了,就可以编写正式的导出代码。

html方法定义:

html(htmlelement|string,callback)

参数:

  • 第一个参数可以传递html的节点或html的代码字符串
  • 第二个参数是html转pdf完成后的回调,回调会传递pdf实例对象的参数

范例代码如下:

<script src="https://html2canvas.hertzen.com/dist/html2canvas.js"></script>
    <script src='../../dist/jspdf.debug.js'></script>
    <script src="../../dist/sourcehansanscn-normal-normal.js"></script>
<script>
    var doc = new jspdf({ orientation: 'p', format: 'a4' });
        doc.setfont('sourcehansanscn-normal', 'normal');
        doc.setfontsize(20);
        doc.html(document.body, {
            callback: function (newdoc) {
                newdoc.save('chinese-html.pdf')
            }
        });
</script>

html到导出pdf的页面设计注意事项:

  1. 首先通过全局设置font-faimly为中文字体
  2. 尝试导出后逐一检查仍为乱码元素的font-faimly是否是已加载的中文字体
  3. 字体跟粗细有关,如果存在加粗的文本,则需要加载对应加粗的字体。
  4. 因为直接通过js打包的字体文件非常的大,因此不宜过多过大,否则可能导致页面加载慢和js内存不足。