Layui表格导出功能如何支持导出带有复杂样式的HTML内容

小浩大大_2274

小浩大大_2274

2026-05-03

228人浏览

原创

Layui的table.export()不支持导出复杂HTML样式,因其底层采用CSV/简易Excel逻辑,仅处理纯文本;需改用table2excel.js(读取DOM结构保留内联样式)或xlsx.js(手动映射样式)实现。

layui.table.export() 无法导出复杂样式 HTML 内容

直接调用 table.export() 导出时,所有单元格内容会被当作纯文本处理:<span class="layui-badge">已审核</span> 变成“已审核”,<img src="..."> 消失, style="max-width:90%" 全部失效。这不是 bug,是设计使然——该方法底层走的是 csv 或简易 excel 生成逻辑,不解析 dom 结构。

真实业务中需要导出的“样式”,通常指以下几类:

  • 带颜色/背景色的 badge、tag 类元素
  • 图标(<i class="layui-icon"></i>)或 avatar 图片
  • 条件渲染的 HTML 片段(如状态红绿灯、进度条 <div class="layui-progress">...</div>)
  • 内联样式或 class 控制的字体大小、对齐、换行等

用 table2excel.js 导出含样式 HTML 的表格

table2excel.js 是目前最轻量、兼容性最好(IE10+)、且能原样保留 colspan/rowspan 和内联样式的方案。它不依赖 layui 实例,只读取目标 <table> 的 DOM 结构并转为 Excel。 <p>实操要点:</p> <ul> <li>确保你要导出的表格是**静态 HTML 构建的**(即没走 <code>table.render()),或在导出前先用 layui.table.cache 拼出完整 HTML 表格再插入临时容器

  • 引入 table2excel.js 后,直接 new 实例:const t2e = new Table2Excel(); t2e.export(document.getElementById('myTable'), 'report');
  • 注意:它会把 style 属性和部分 class(如 layui-badge-success 对应的 background-color)映射为 Excel 单元格样式,但不支持 CSS 伪类、flex 布局、transform 等
  • 若表格含 <input>、<select></select> 等表单控件,需提前用其 value 替换 innerHTML,否则导出为空
  • 导出前手动清理/转换 HTML 内容

    很多“样式”其实是语义化需求,比如红字表示异常、图标表示类型。与其强求 Excel 渲染 HTML,不如在导出前做一层语义映射:

    Wechat HTML Publisher
    Wechat HTML Publisher

    直接上传HTML富文本到微信公众号草稿箱。支持完整的HTML格式,无需Markdown转换。

    下载
    • 将 <span class="text-danger">逾期</span> → 替换为纯文本“逾期”,再通过 Excel 样式规则(如条件格式)着色(适用于后端导出或 xlsx.js)
    • 将 <i class="layui-icon"></i> → 替换为 Unicode 字符 ✅ 或文字“通过”
    • 对含 colspan/rowspan 的表头,必须确保导出源表格是手写 DOM,table.render() 动态生成的表格里这些属性会被忽略
    • 如果用了 laytpl 渲染单元格,导出前需先执行 laytpl(tpl).render(data) 得到最终 HTML 字符串,再塞进临时 <table> <h3>用 xlsx.js + 自定义 sheet 处理样式边界</h3> <p>当必须控制字体、边框、列宽、甚至单元格合并时,<code>xlsx.js 是更可控的选择,但它不自动识别 HTML 样式,需要你手动提取:

      • 遍历表格行,用 cell.style.color、cell.getAttribute('class') 判断语义,再映射为 { font: { color: { rgb: "FF0000" } } } 这类配置
      • colspan 和 rowspan 需转为 ws['!merges'] = [{s: {r:0,c:0}, e: {r:2,c:0}}] 格式
      • 避免直接用 XLSX.utils.table_to_sheet() —— 它会丢弃所有样式,必须用 js_to_sheet() + 手动设置 ws[cellRef].s(cell style)
      • 中文导出乱码?确保 writeFile() 时传入 { type: 'binary', bookType: 'xlsx' },不要用 type: 'array' 或漏掉 bookType

      真正麻烦的不是“怎么导出”,而是“哪些样式值得导出”。Excel 本质是二维数据容器,强行塞进前端 UI 细节,后期维护和用户预期都会错位。优先用语义字段替代视觉样式,导出才不容易翻车。

    前端入门到VUE实战笔记:立即使用
    在学习笔记中,你将探索 前端 的入门与实战技巧!

    相关文章

    HTML速学教程(入门课程)
    HTML速学教程(入门课程)

    HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

    下载

    相关标签:

    layui html

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

    相关专题

    更多
    python是前端还是后端
    python是前端还是后端

    Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

    2023.08.11

    2463

    5

    前端如何实现即时通讯
    前端如何实现即时通讯

    实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

    2023.10.09

    5283

    6

    前端和后端的区别
    前端和后端的区别

    前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

    2024.03.19

    6330

    13

    php和前端的关联介绍
    php和前端的关联介绍

    php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

    2024.03.22

    5918

    10

    前端外包工作内容有哪些
    前端外包工作内容有哪些

    前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

    2024.05.22

    843

    5

    html版权符号
    html版权符号

    html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

    2023.06.14

    6055

    7

    html在线编辑器
    html在线编辑器

    html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

    2023.06.21

    3412

    4

    html网页制作
    html网页制作

    html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

    2023.07.31

    3090

    5

    html空格
    html空格

    html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

    2023.08.01

    3099

    5

    热门下载

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

    精品课程

    更多
    相关推荐
    /
    热门推荐
    /
    最新课程
    ThinkPHP配置开发与CMS后台实战
    ThinkPHP配置开发与CMS后台实战

    共87课时 | 12.9万人学习

    第二十三期_综合实战
    第二十三期_综合实战

    共89课时 | 11.1万人学习

    Layui 快速入门精讲
    Layui 快速入门精讲

    共5课时 | 1.6万人学习