Layui表格导出功能如何处理字段名中包含点号(.)的数据

阿静吖_4009

阿静吖_4009

2026-06-02

492人浏览

原创

Layui的table.exportFile不支持嵌套字段路径,field必须为合法JS标识符(纯英文、数字、下划线),嵌套字段如"data.info.name"需在parseData中扁平化为data_info_name等顶层键名,否则导出为空或报错。

field 写成 data.info.name 导出为空或报错

layui 的 table.exportfile 不解析嵌套路径表达式,它会把 field: "data.info.name" 当作一个完整字符串去查 row["data.info.name"] —— 而原始数据里显然没有这个键名,结果就是该列导出为空,或在取值时触发 cannot read property 'xxx' of undefined。

  • 渲染时可能正常(因为 templet 或内部逻辑做了路径解析),但导出走的是纯属性访问逻辑,不走渲染链路
  • 哪怕后端返回的是扁平结构,只要你在 cols 里写了带点号的 field,导出就失效
  • 常见错误写法:field: "user.profile.avatar"、field: "order.items.0.price"、field: "meta.created_at"

必须把嵌套字段提前扁平化到 row 顶层

导出前需在数据进入表格前,或调用 exportFile 前,把深层字段“提上来”。不能依赖导出函数自动解构。

  • 若用 parseData 接口响应,就在里面做映射:data: res.data.list.map(item => ({ ...item, user_name: item.user?.name, avatar_url: item.user?.profile?.avatar }))
  • 若导出选中行,先用 getSelections() 拿到对象数组,再 map 扁平化:selections.map(s => ({ ...s, full_name: s.user?.name || s.contact?.name }))
  • 注意 null/undefined 防御:用可选链 ?. 或三元判断,避免 item.user.name 报错中断流程

表头 title 和实际 field 必须分离设计

title 可以自由写中文、符号、层级描述(如“用户姓名”“订单-创建时间”),但 field 必须是合法 JS 标识符:仅含英文、数字、下划线,且不能以数字开头。

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

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

下载
  • 错误:{ field: "用户姓名", title: "用户姓名" } → 导出取值失败
  • 正确:{ field: "user_name", title: "用户姓名" } → 渲染显示中文,导出取值安全
  • 如果后端字段已固定为 user.info.name,不要改接口,而是在前端预处理时重命名:user_info_name 或 userName

导出时 field 拼错或大小写不一致会导致整列为空

导出逻辑严格按 cols 中定义的 field 键名去取值,和 JavaScript 对象属性访问一样区分大小写、不可容忍拼写误差。

  • 原始数据有 userName,但 cols 写了 field: "username" → 该列全空
  • 用了 parseData 扁平化出 order_id,但列配置写成 field: "orderId" → 导出无值,也不报错
  • 调试建议:在导出前 console.log(table.cache['your-id'][0]) 看真实 key 名,再核对 cols 中每个 field
真正容易被忽略的是:**你看到表格里能正常显示嵌套字段,不代表导出也能用同一套写法**。Layui 在渲染和导出两条路径上对 field 的处理完全独立——前者可能兼容路径语法,后者只认扁平 key。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2035

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

2962

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1016

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3359

7

ajax教程
ajax教程

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

2023.06.14

2620

4

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

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

2023.08.31

340

5

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

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

2023.11.15

2453

5

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

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

2024.09.24

1141

6

热门下载

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

精品课程

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

共87课时 | 12.7万人学习

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

共89课时 | 11万人学习

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

共5课时 | 1.6万人学习