You need to enable JavaScript to run this app. 如何在jsPDF 1.2.61+jQuery1.12.4环境下生成可自动分页、采用Arial字体的正确表格PDF
优惠活动
大模型
产品
解决方案
定价
更多

如何在jsPDF 1.2.61+jQuery1.12.4环境下生成可自动分页、采用Arial字体的正确表格PDF

针对jsPDF 1.2.61+jQuery 1.12.4版本的表格PDF导出实现方案

首先明确当前遇到的两个核心问题的根因:

  1. 1.2.61版本jsPDF的内置fromHTML方法没有自动分页逻辑,HTML内容超过单页边界时会直接被裁切,不会自动新增页面
  2. 该版本的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'
    });
    

二、自动分页实现

因为没有内置分页能力,需要手动拆分表格行,按单页可容纳的高度分批次渲染,具体逻辑:

  1. 先计算A4纸张的可用渲染高度:A4纸在pt单位下总高度为842pt,按设置的20pt上下边距计算,单页最多可容纳的内容高度为 842 - 20*2 = 802pt
  2. 逐行累计表格内容高度,累计高度达到单页阈值时,先把当前批次的表格内容通过fromHTML渲染到当前页,再调用doc.addPage()新建下一页,继续渲染剩余内容
  3. 为了让高度计算更精准,可以在页面加一个宽度和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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 19:15:07