Layui表格导出功能如何设置导出的Sheet工作表名称

星杰同学_5148

星杰同学_5148

2026-05-13

999人浏览

原创

可修改Sheet名称,需绕过Layui封装,用xlsx.js手动导出:取table.cache数据,用XLSX.utils.json_to_sheet构建sheet,设置ws['!name'] = '自定义名'(≤31字符),再写入workbook并导出。

导出 Excel 时 Sheet 名称默认是 “Sheet1”,怎么改?

layui 的 table.exportfile() 方法本身不支持直接传入 sheet 名称,它底层调用的是 sheetjs(xlsx.js),而 layui 封装时把工作表名写死为 "sheet1"。所以你无论怎么配参数,exportfile() 都不会生效——这不是你配置错了,是 layui 没留口。

绕过 Layui 封装,用 xlsx.js 手动构造导出

必须跳过 table.exportFile(),自己拿表格数据 + xlsx.js 生成文件。关键点在于:先用 table.cache 拿数据,再用 XLSX.utils.aoa_to_sheet() 或 XLSX.utils.json_to_sheet() 构建 sheet,最后手动设 sheet['!ref'] 和 ws_name。

  • table.cache['your-table-id'] 是当前页渲染的数据(含格式化后的值,注意是否要原始字段)
  • 如果要导出全部页数据,得自己发请求拉取全量,Layui 表格不自动给你
  • 用 XLSX.utils.json_to_sheet(data, { header: ['id', 'username', 'status'] }) 可控列顺序,比 aoa_to_sheet 更稳
  • 设置 sheet 名称只需在写入 workbook 前赋值:ws['!name'] = '用户汇总'(长度不能超 31 字符,含中文)

常见报错和兼容性注意

直接上 xlsx.js 导出,容易遇到几个典型问题:

  • 导出文件打不开 → 检查是否漏了 XLSX.write(wb, { bookType: 'xlsx', type: 'array' }),type: 'binary' 在新版 Chrome 下会乱码
  • 中文 Sheet 名显示为方块 → 确保 xlsx.js 版本 ≥ 0.18.5,老版本对 Unicode 工作表名支持差
  • 导出内容缺列或顺序错 → 不要用 table.config.cols 自己拼 header,优先以 data[0] 的 key 为准,或显式定义 header 数组
  • Layui 2.8+ 引入了内置 xlsx,但没暴露接口;建议外链独立引入 xlsx.full.min.js,避免版本冲突

一个最小可行导出示例

假设表格 ID 是 userTable,想导出名为 “员工名单” 的 Sheet:

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

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

下载
const data = layui.table.cache['userTable'];
const ws = XLSX.utils.json_to_sheet(data, { header: ['id', 'username', 'email'] });
ws['!name'] = '员工名单'; // ← 就是这行控制 Sheet 名
const wb = XLSX.utils.book_new();
XLSX.utils.book_append_sheet(wb, ws, ws['!name']);
XLSX.writeFile(wb, '员工名单.xlsx');

注意:header 数组顺序决定列序,字段名必须和 data 对象的 key 一致;如果后端返回字段带前缀(如 user_username),得先 map 一遍。

真正麻烦的不是改名字,而是 Layui 把数据、样式、合并单元格这些都隔离在内部,你要自定义就得重走整条链路——Sheet 名只是第一个拦路虎。

相关文章

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

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

下载

相关标签:

layui

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系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

5303

6

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

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

2024.03.19

6350

13

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

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

2024.03.22

5938

10

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

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

2024.05.22

843

5

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

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

2023.07.25

5161

7

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

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

2023.07.31

3196

5

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

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

2023.08.02

2980

3

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

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

2023.08.02

1444

3

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.1万人学习

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

共5课时 | 1.6万人学习