导出必须用table.cache获取过滤后的真实数据,因其存储搜索条件下的全部匹配项;需确保已执行table.reload()更新缓存,并严格匹配field与对象key才能正确导出。
导出前必须用 table.cache 拿真实过滤数据
直接调 table.getdata('id') 拿到的是原始未过滤的全量数据,导出会错。真正反映“当前搜索条件下的全部匹配项”的,只有 table.cache['id'] ——它在每次 table.reload() 后自动更新,存的就是你输入关键词、选筛选项后,后端返回(或前端过滤)的所有结果,不分页。
常见错误:点了导出按钮,内容却是全部原始数据,或空。根本原因是没等 reload() 完就去读 table.cache,或者压根没触发 reload()。
- 确保搜索提交(如
form.on('submit(filter)'))里调用了table.reload(),且传了正确的id -
table.cache是对象,key 就是你 render 时写的id: 'userTable',所以读的时候写table.cache.userTable或table.cache['userTable'] - 如果表格还没完成首次加载(比如页面刚打开、接口还在 pending),
table.cache['id']可能是undefined,加个守卫:if (!table.cache['userTable']) return
table.exportFile() 必须手动传 cols 和 data
Layui 自带的工具栏导出按钮只认初始化时的配置,不支持动态过滤后的数据。要导出 table.cache 里的内容,必须绕过默认行为,手动调 table.exportFile(id, data, options)。
关键点:第一个参数是表头配置数组,第二个是数据数组,二者字段名(field)必须严格一致,大小写、下划线都不能错。
-
cols不是直接拿table.config.cols,而是取渲染时定义的列配置,比如:[{field: 'username', title: '用户名'}, {field: 'status', title: '状态'}] -
data必须是table.cache['userTable'],不能是table.getData('userTable') - 如果某列是操作列(如含按钮),它的
field值(比如'opt')不在数据对象里,导出时那一列会为空;要跳过它,就得先遍历cols过滤掉对应field,再构造清洗后的data数组 - 别漏掉
title字段——哪怕写title: '',否则表头不显示
templet 渲染的内容不会自动转为纯文本
你在列里用 templet: '<span class="layui-badge">{{d.status==1 ? "启用" : "禁用"}}</span>' 渲染状态,导出时不会解析 HTML,也不会提取文字,而是直接取 d.status 的原始值(比如 1 或 0)。
想导出“启用”“禁用”这种可读文本,得在构造 data 数组前手动映射:
const cache = table.cache['userTable'] || [];
const exportData = cache.map(item => ({
username: item.username,
status: item.status === 1 ? '启用' : '禁用',
email: item.email
}));
- 所有带格式、图标、链接的列,都得这样提前处理,否则导出内容和界面上看到的对不上
- 避免用
prop、value这类非标准字段名作为field,Layui 导出只认field对应的 key - 如果用了多级嵌套字段(如
d.user.name),field写成'user.name'并不行,得在映射时扁平化:name: item.user?.name
IE 下导出 .xls 文件可能失败
这是已知兼容性问题:IE 对 Blob 和下载响应头支持不完整,table.exportFile() 生成的 .xls 文件在 IE 中常卡住或报错。
解决方案不是换文件类型,而是降级处理:
- 检测浏览器:
if (navigator.userAgent.indexOf('Trident') > -1),是 IE 就强制用type: 'csv' - CSV 导出需注意中文乱码:后端返回时加 BOM 头(
\ufeff),前端拼数据时也建议加 - 别依赖
window.location.href跳转导出逻辑来兜底——那是给后端全量导出用的,这里exportFile是纯前端行为
最易被忽略的一点:table.cache 更新不是实时的,reload 后必须等 done 回调执行完才能读;很多人把导出逻辑写在 reload 的 success 回调里,但 done 才是缓存真正写入的时机。











