Layui table.exportFile()导出时状态字段仍为数字,因templet仅影响渲染不作用于导出;须用parseData预处理数据,将gender等字段映射为中文,且应基于table.cache读取当前页数据并深拷贝处理。
导出时状态字段仍是数字,不是前端显示的中文
layui 的 table.exportfile() 默认导出原始数据,templet 仅影响页面渲染,对导出无任何作用。所以即使你在列里写了 templet: d => d.gender == 1 ? '男' : '女',导出的 excel 或 csv 里还是原始的 0 或 1。
必须用 parseData 预处理导出数据
导出前需拦截原始响应,把目标字段(如 gender)替换为中文。关键点是:不能改原始 data 数组(会污染表格渲染),而应在 parseData 回调中返回新结构。
-
parseData是导出专用钩子,只在调用exportFile()时触发,不影响表格正常渲染 - 它接收原始响应对象,要求你返回一个含
data字段的对象 - 必须深拷贝或映射生成新数组,避免副作用
- 示例写法:
table.exportFile('user', { data: tableData, // 原始数据源(通常从 table.cache 获取) parseData: function(res) { return { data: res.data.map(item => ({ ...item, gender: item.gender == 1 ? '男' : item.gender == 0 ? '女' : '未知' })) }; } });
从 table.cache 拿数据比重新请求更稳
导出时别再发一次接口,直接读取当前表格缓存——它已含分页、筛选后的最新数据,且类型明确(不会出现后端吐字符串 "1" 导致 == 1 失效的问题)。
-
table.cache['your-table-id']返回当前页渲染的数据数组 - 如果用了服务端分页,
table.cache只有当前页;需完整导出时,得先调接口拉全量,再传入parseData - 注意:缓存中的值类型取决于后端返回,建议统一用
item.gender == 1(宽松比较)而非===,兼容字符串和数字
多字段或复杂映射建议抽成独立函数
如果同时要转 gender、status、role 等多个字段,硬编码在 parseData 里会难维护。更稳妥的做法是定义映射函数:
- 写一个通用转换器:
const mapField = (val, map) => map[String(val)] || map.default || val;
- 然后在
parseData中复用:gender: mapField(item.gender, { '0': '女', '1': '男', default: '未知' }),<br>status: mapField(item.status, { '0': '禁用', '1': '启用', '2': '审核中' }) - 这样后续加字段、改文案、做 i18n 都只需动
map对象,不碰导出逻辑
templet 能管到导出,其实它只管屏幕。所有字段级文本转换,导出时都得手动重做一遍,而且必须通过 parseData —— 其他任何 hook 或修改原始数据的方式,都会导致表格错乱或导出内容不一致。











