讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在 DataTables 导出 PDF 时为前六列后插入换行以避免内容溢出

陌芳君_4466

陌芳君_4466

发布时间:2026-01-27 15:11:20

|

338人浏览过

|

来源于php中文网

原创

如何在 DataTables 导出 PDF 时为前六列后插入换行以避免内容溢出

本文介绍通过自定义 pdf 导出逻辑,在 datatables 的 `pdfhtml5` 按钮中实现「在第 6 列后强制换行」的效果,解决宽表导出时内容横向溢出的问题,核心方法是利用 pdfmake 的 `customized` 钩子动态拆分行结构。

DataTable 默认的 pdfHtml5 导出会将整行渲染为 PDF 表格的一行(table.body[i]),当列数过多(如 12 列)且内容较宽时,极易超出 LEGAL 纸张宽度导致截断或压缩失真。单纯用 @media print { .d-none { display: none } } 仅影响浏览器打印预览,对 pdfHtml5 导出完全无效——因为该按钮底层使用 pdfMake 库直接生成 PDF,不依赖 CSS 打印样式。

✅ 正确解法:使用 customize 回调函数,接管 PDF 文档结构生成过程,在每行数据中将前 6 列与后 6 列拆分为两个独立表格行(或嵌套表格),从而实现视觉上的“换行”效果。

以下是完整可运行的配置示例(适配你当前的 DataTable 初始化代码):

Excel XLSX Formula Cleanup
Excel XLSX Formula Cleanup

诊断并修复涉及公式、命名范围、Power Query 刷新、数据透视表、VBA/宏保存等问题的 Microsoft Excel XLSX 工作簿

下载
$('#savedTable').DataTable({
    language: {
        url: '//cdn.datatables.net/plug-ins/1.13.5/i18n/tr.json',
    },
    responsive: true,
    dom: 'Bfrtip',
    buttons: [
        {
            extend: 'excelHtml5',
            text: '<i class="fa fa-file-excel-o mr-2"></i> EXCEL'
        },
        {
            extend: 'pdfHtml5',
            orientation: 'landscape',
            pageSize: 'LEGAL',
            text: '<i class="fa fa-file-pdf-o mr-2"></i>PDF',
            customize: function (doc) {
                // 获取原始表格 body 数据(已按 DataTable 当前状态过滤/排序)
                const originalBody = doc.content[1].table.body;

                // 重建 table.body:每行拆为两行(前6列 + 后6列)
                const newBody = [];
                for (let i = 0; i < originalBody.length; i++) {
                    const row = originalBody[i];
                    if (row.length >= 12) {
                        // 第一行:前6列(保留原样式,如字体、边框)
                        const topRow = row.slice(0, 6);
                        // 第二行:后6列,顶部无上边框,底部无下边框(视觉连贯)
                        const bottomRow = row.slice(6, 12).map(cell => ({
                            ...cell,
                            margin: [0, -4, 0, 0], // 微调垂直间距
                            border: [true, false, true, true] // 左、右、下有边框,上无
                        }));

                        newBody.push(topRow);
                        newBody.push(bottomRow);
                    } else {
                        newBody.push(row); // 列数不足12则保持原样
                    }
                }

                // 替换原表格 body
                doc.content[1].table.body = newBody;

                // 可选:调整列宽以适配 12→6 列布局(单位:user unit)
                doc.content[1].table.widths = Array(6).fill('*'); // 均分6列宽度
            }
        },
        {
            extend: 'colvis',
            text: '<i class="fa fa-eye mr-2"></i> Sütunlar'
        }
    ],
    searching: true,
    select: true,
});

? 关键说明与注意事项:

  • customize 函数在 PDF 文档对象 doc 生成后、导出前执行,可安全修改其任意属性;
  • doc.content[1] 通常对应主表格(索引 0 是标题,1 是表格),但建议先 console.log(doc) 确认结构;
  • 若需更精细控制(如合并单元格、添加分页符、插入空行),可在 newBody 中插入 { text: '', style: 'blankRow' } 或 '\n' 占位;
  • pdfMake 的 border 属性为 [left, top, right, bottom] 布尔数组,用于模拟“跨行连续边框”;
  • 务必测试中文显示:确保已正确引入 vfs_fonts.js,且 PDF 字体支持 UTF-8(如使用 Roboto 或自定义中文字体);
  • 替代方案(轻量级):若仅需快速缓解,可改用 pageLength: 10 + scrollX: true 配合横向滚动,避免导出超宽表。

通过上述 customize 重构,导出的 PDF 将以“双行结构”呈现每条记录,彻底解决第 6 列后内容溢出问题,同时保持专业排版与可读性。

热门AI工具

更多
立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

3080

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

269

2026.02.03

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

4556

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1375

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1798

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

10123

2023.08.17

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

1000

2023.09.01

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2844

2023.09.04

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

20

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.5万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 6.1万人学习

CSS教程
CSS教程

共754课时 | 99万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn