如何在jsPDF 1.2.61+jQuery1.12.4环境下生成可自动分页、采用Arial字体的正确表格PDF
针对jsPDF 1.2.61+jQuery 1.12.4版本的表格PDF导出实现方案
首先明确当前遇到的两个核心问题的根因:
- 1.2.61版本jsPDF的内置
fromHTML方法没有自动分页逻辑,HTML内容超过单页边界时会直接被裁切,不会自动新增页面 - 该版本的
fromHTML默认硬编码使用Times New Roman字体,且不会主动解析外部CSS的字体设置,只识别元素的内联样式,所以常规设置字体的方式不会生效
一、Arial字体适配方法
- 初始化PDF实例时先全局指定默认字体:调用
doc.setFont('arial'),这个版本的jsPDF内置字体库已经自带Arial支持,不需要额外嵌入字体文件 - 给待导出的表格、单元格元素直接写内联字体样式,不要依赖外部CSS文件,旧版
fromHTML不会读取外部样式表的规则
比如通过jQuery给元素设置:$('#tablePDF').css({ 'font-family': 'Arial', 'border-collapse': 'collapse', 'width': '100%' }); $('#tablePDF td').css({ 'font-family': 'Arial', 'padding': '8px', 'border': '1px solid #333' });
二、自动分页实现
因为没有内置分页能力,需要手动拆分表格行,按单页可容纳的高度分批次渲染,具体逻辑:
- 先计算A4纸张的可用渲染高度:A4纸在pt单位下总高度为842pt,按设置的20pt上下边距计算,单页最多可容纳的内容高度为
842 - 20*2 = 802pt - 逐行累计表格内容高度,累计高度达到单页阈值时,先把当前批次的表格内容通过
fromHTML渲染到当前页,再调用doc.addPage()新建下一页,继续渲染剩余内容 - 为了让高度计算更精准,可以在页面加一个宽度和PDF渲染宽度一致的隐藏容器,把克隆的表格放进去逐行读取实际高度,避免纯估算导致的内容溢出。
修正后的完整代码
<!-- 页面隐藏容器,用来计算表格实际渲染高度 --> <div id="hidden-container" style="position:absolute;left:-9999px;top:-9999px;width:500px;"></div> <table id="tablePDF"> <tr><td>Value1a</td><td>Value2b</td><td>Value3c</td></tr> <!-- 可自行添加更多测试行验证分页效果 --> </table> <button id="downloadPDF" onclick="generatePDF()">DOWNLOAD PDF</button> <script> function generatePDF() { const doc = new jsPDF('p', 'pt', 'a4'); // 全局设置默认字体为Arial doc.setFont('arial'); doc.setFontSize(12); // 页面参数配置 const pageHeight = doc.internal.pageSize.height; const marginTop = 20, marginBottom = 20; const maxContentHeight = pageHeight - marginTop - marginBottom; let currentY = marginTop; // 处理表格基础样式 const $table = $('#tablePDF'); $table.css({ 'font-family': 'Arial', 'border-collapse': 'collapse', 'width': '100%' }); $table.find('td').css({ 'font-family': 'Arial', 'padding': '8px', 'border': '1px solid #333' }); // 把表格克隆到隐藏容器,逐行计算实际渲染高度 const $hiddenBox = $('#hidden-container'); $hiddenBox.empty().append($table.clone()); const allRows = $hiddenBox.find('tr').toArray(); // 分页拆分渲染 let rowBatch = []; let currentBatchHeight = 0; const tableWidth = 500; allRows.forEach((rowEl) => { const rowHeight = rowEl.offsetHeight; // 当前批次加上这一行就超出单页高度时,先渲染当前批次 if (currentBatchHeight + rowHeight > maxContentHeight) { const batchHtml = $('<table>').css({ 'font-family': 'Arial', 'border-collapse': 'collapse', 'width': '100%' }).append(rowBatch).html(); doc.fromHTML(batchHtml, marginTop, currentY, {'width': tableWidth}); // 新建下一页 doc.addPage(); currentY = marginTop; // 重置当前批次缓存 rowBatch = []; currentBatchHeight = 0; } rowBatch.push(rowEl); currentBatchHeight += rowHeight; }); // 渲染最后剩余的未输出内容 if (rowBatch.length > 0) { const batchHtml = $('<table>').css({ 'font-family': 'Arial', 'border-collapse': 'collapse', 'width': '100%' }).append(rowBatch).html(); doc.fromHTML(batchHtml, marginTop, currentY, {'width': tableWidth}); } doc.save('Test.pdf'); } </script>
注意事项
- 如果设置了字体还是渲染成Times New Roman,要确保传给
fromHTML的HTML字符串里完整包含了带内联样式的table标签,不要只传单元格内容,不然样式会被重置 - 逐行计算高度的时候,要保证隐藏容器的宽度和PDF里设置的渲染宽度(代码里为500pt)完全一致,不然算出来的行高和实际PDF渲染的行高会有偏差,导致分页错位
- 这个实现完全基于当前使用的jsPDF 1.2.61和jQuery 1.12.4版本,不需要引入额外的第三方插件,不会产生版本兼容问题
内容的提问来源于stack exchange,提问作者Jackom
相关产品推荐
相关产品推荐

