Layui表格导出功能怎么手动控制导出列的先后顺序

大宇同学_3841

大宇同学_3841

2026-05-19

948人浏览

原创

导出列顺序由 cols 配置决定,不是 DOM 渲染顺序;Layui 的 exportFile 仅依据 table.render 时传入的 cols 数组顺序导出,不识别拖拽、hide: true 或临时 cols 参数,动态调整需修改 config.cols[0]。

导出列顺序由 cols 配置决定,不是 DOM 渲染顺序

很多人以为表格里拖拽调整了列顺序,导出就会跟着变——不会。layui 的 exportfile 方法(包括 table.exportfile)完全不读取页面上的 <th> 或 <code><td> 排列,它只认你初始化表格时传入的 <code>cols 数组结构。

关键点:同一级 cols 数组中对象的顺序,就是导出 Excel 表头和数据列的顺序。

  • 如果你用的是多级表头(如 children),导出只支持一级 cols[0] 下的字段,嵌套的 children 不会自动展平或参与排序
  • exportFile 不会识别 hide: true 的列,但也不会跳过你写在 cols 里、实际没渲染的列——只要它在数组里,就导出
  • 列宽、样式、合并单元格等格式导出时不生效,顺序是唯一能靠配置控制的维度

exportFile 不接受自定义列数组,得改 table.config

你不能像调用 table.exportFile('id', { cols: [...] }) 这样临时传新列顺序——这个 API 没有 cols 参数。它只接受 id、data、type 和 filename。

所以想手动控制顺序,只有两个办法:

  • 在调用 table.render() 时,把 cols 按你想要的导出顺序写好,后续所有导出都按这个走
  • 导出前动态重写表格实例的 config.cols,再调 exportFile —— 注意必须改 config.cols[0](默认第一级),且要确保改完后没有其他逻辑依赖旧顺序
  • 如果用了 table.on('init') 或异步加载列配置,务必等 config 真正挂载完成后再改,否则改了也白改

隐藏列但保留导出顺序:用 hide: false + unresize: true 配合

有时候你需要某列在界面上不可见(比如 ID 字段),但又必须出现在导出文件最前面。这时候别用 hide: true,因为它会让这列彻底不出现在导出里。

正确做法是让列“视觉隐藏但逻辑存在”:

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

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

下载
  • 设置 hide: false(显式关闭隐藏)
  • 加 unresize: true 和 width: 1,再配合 CSS .layui-table-cell{ overflow: hidden; } 视觉上收掉
  • 把它放在 cols[0] 数组最前面,就能保证导出时排第一
  • 注意:如果用户点了“显示列”菜单,这列会重新出现,所以更适合后台管理类场景,且需同步控制权限

导出 CSV 时中文乱码?顺序没错但内容错位

这不是顺序问题,是编码陷阱。Layui 导出 CSV 默认用 UTF-8,但 Windows Excel 打开时会当成 ANSI,导致首列看起来像乱码、后续列整体右移一格。

解决方式不是调顺序,而是加 BOM 头:

  • 拦截 exportFile 返回的 Blob,用 new Blob(['\ufeff' + csvContent], ...) 包一层
  • 或者改用服务端导出,由后端写 BOM 并设 Content-Type: text/csv;charset=utf-8
  • 如果坚持前端导出,注意 exportFile 的 type 参数填 'csv' 时,内部生成逻辑不加 BOM;填 'xls' 反而自带兼容处理

顺序对了,但打开一看字段全偏了——八成是这个原因,不是 cols 写错了。

真正麻烦的不是怎么排顺序,而是得记住:Layui 的导出本质是把 config.cols 映射成二维数组再喂给 SheetJS(旧版)或自研生成器,中间没留钩子。想灵活控制,要么提前规划好 cols,要么自己造个 exportData 方法绕过它。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

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

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

2023.08.11

2523

5

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

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

2023.10.09

5443

6

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

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

2024.03.19

6470

13

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

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

2024.03.22

6078

10

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

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

2024.05.22

863

5

ajax教程
ajax教程

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

2023.06.14

2860

4

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

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

2023.08.31

360

5

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

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

2023.11.15

2693

5

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

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

2024.09.24

1161

6

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.1万人学习

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

共5课时 | 1.6万人学习