Layui表格如何导出选中的特定行到Excel

风强小哥_4427

风强小哥_4427

2026-04-10

209人浏览

原创

layui table导出选中行为空的主因是未启用checkbox或事件绑定不当;getSelections()仅返回当前页勾选项,跨页需手动维护ID列表;exportFile()要求数据为二维数组且字段顺序严格对应cols,CSV导出须加UTF-8 BOM头并转义特殊字符。

layui table 导出选中行时 getSelections() 返回空数组

常见现象是点击导出按钮后 excel 里什么都没写,或者只导出全部数据——根本没走选中逻辑。原因几乎都是没开启多选支持,或没正确绑定事件。

  • table.render() 初始化时必须显式设置 checkbox: true,否则 getSelections() 永远返回空
  • 导出触发点不能放在表格外部随意绑 click,得用 table.on('toolbar(filter)', ...) 或确保在 done 回调后执行,否则 DOM 还没渲染完,勾选状态未同步
  • 注意:Layui 2.8+ 的 getSelections() 只返回当前页已勾选的行;如果开了分页且用户跨页勾选,需要自己维护一个全局选中 ID 列表

用 layui.table.exportFile() 导出前必须构造合法的 data 格式

这个方法不接受原始 JSON 数组,它内部会校验字段名是否与 cols 中的 field 对齐。传错格式直接静默失败,控制台也不报错。

  • 导出数据必须是二维数组,第一行为表头(title 字段值),后续每行为一行数据,顺序严格对应 cols[0].field、cols[1].field…
  • 别直接把 getSelections() 结果塞进去——它返回的是对象数组,得先 map 成按列顺序排列的数组,例如:[row.id, row.username, row.email]
  • 如果某列用了 templet 渲染(比如状态显示“启用/禁用”),导出时得手动映射:原数据是 status: 1,导出值应为 "启用"

导出 Excel 时中文乱码或格式错乱

Layui 内置导出本质是生成 CSV,不是真正的 Excel(.xlsx)。所有“Excel”效果都靠系统用 Excel 打开 CSV 文件模拟,所以编码和换行很关键。

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载
  • 必须用 UTF-8 BOM 头,否则 Windows 上 Excel 默认用 GBK 解码,中文全变问号。生成 CSV 字符串前加 \ufeff
  • 字段内容含逗号、换行、双引号时,必须用双引号包裹,且内部双引号要转义为两个双引号(" → ""),否则 Excel 列错位
  • 不要尝试用 exportFile() 导出带样式的 Excel——它不支持合并单元格、颜色、数字格式。真有这些需求,得换 xlsx 库在前端生成 .xlsx

替代方案:用 xlsx 库导出更可控的 Excel

当业务要求导出格式稳定、支持多 sheet、保留数字类型(比如不把 00123 变成 123)或跨页全量导出时,exportFile() 就不够用了。

  • 引入 https://cdn.jsdelivr.net/npm/xlsx@0.18.5/dist/xlsx.full.min.js,比 Layui 自带方案体积略大但可控性强
  • 用 getSelections() 获取数据后,直接喂给 XLSX.utils.json_to_sheet(),它自动处理字段顺序、空值、类型推断
  • 注意:服务端无参与的纯前端导出,数据量别超过 5 万行,否则浏览器卡死。大数据量得走后端接口生成文件流
事情说清了就结束。真正卡住人的从来不是“怎么导”,而是“为什么导出来是空的”“为什么中文是乱码”“为什么跨页选不了”——这些问题背后全是 Layui 表格状态管理的隐性约定。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

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

下载

相关标签:

layui

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

相关专题

更多
ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

2900

4

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

360

5

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.15

2733

5

ajax网站有哪些
ajax网站有哪些

使用ajax的网站有谷歌、维基百科、脸书、纽约时报、亚马逊、stackoverflow、twitter、hacker news、shopify和basecamp等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.09.24

1161

6

excel对比两列数据异同
excel对比两列数据异同

Excel作为数据的小型载体,在日常工作中经常会遇到需要核对两列数据的情况,本专题为大家提供excel对比两列数据异同相关的文章,大家可以免费体验。

2023.07.25

5321

7

excel重复项筛选标色
excel重复项筛选标色

excel的重复项筛选标色功能使我们能够快速找到和处理数据中的重复值。本专题为大家提供excel重复项筛选标色的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

3316

5

excel复制表格怎么复制出来和原来一样大
excel复制表格怎么复制出来和原来一样大

本专题为大家带来excel复制表格怎么复制出来和原来一样大相关文章,帮助大家解决问题。

2023.08.02

3100

3

excel表格斜线一分为二
excel表格斜线一分为二

在Excel表格中,我们可以使用斜线将单元格一分为二。本专题为大家带来excel表格斜线一分为二怎么弄的相关文章,希望可以帮到大家。

2023.08.02

1444

3

excel斜线表头一分为二
excel斜线表头一分为二

excel斜线表头一分为二的方法有使用合并单元格功能方法、使用文本框功能方法、使用自定义格式方法。本专题为大家提供excel斜线表头一分为二相关的各种文章、以及下载和课程。

2023.08.02

697

5

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.2万人学习

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

共5课时 | 1.6万人学习