默认只导当前页,因exportfile()不传data时自动读取table.cache['id']中按limit切分的当前页数据;需避免误传alldata、勾选数据或前端分页导致全量导出,稳妥做法是在done回调中显式取cache导出。
默认就是只导出当前页数据,不需要额外配置 —— 但前提是别误操作把它改成全量导出。
为什么 table.exportFile() 默认只导出当前页
Layui 的 table.exportFile() 在不传 data 参数时,会自动读取 table.cache['yourTableId'],而这个 cache 里存的正是当前页(按 limit 切分)的原始数据块。它不关心你有没有搜索、筛选或排序,只要没手动传 data,就只导这一页。
- 常见错误:在 toolbar 事件里写了
table.exportFile('userTable'),却意外传了全局变量allData进去(比如变量名冲突、作用域污染) - 另一个坑:用了
table.getCheckStatus('userTable').data获取勾选行后直接传给exportFile(),结果导出的是“所有勾选项”,可能跨页 —— 这不是当前页,是用户行为结果 - 如果你启用了前端分页(
page: false),table.cache里存的是全部数据,此时exportFile('id')就真会导出全部 —— 这属于配置矛盾,不是 bug
确保只导当前页的稳妥写法
显式用 table.cache 取数,避免依赖隐式行为:
- 确认表格初始化时写了
id: 'userTable',否则table.cache['userTable']是undefined - 必须在
done回调之后读取,例如:done: function(res, curr, count) { // 此时 cache 已写入 const currentPageData = table.cache['userTable'] || []; table.exportFile('用户列表', currentPageData, 'csv'); } - 不要用
table.getData('userTable')替代 —— 它返回的是 DOM 可见行,带搜索/筛选后可能比 cache 少数据
导出按钮绑定时容易踩的坑
如果用工具栏按钮触发导出(如 toolbar(userTable)),注意别在事件里偷偷混入全量逻辑:
- 错误示例:
if (obj.event === 'export') { table.exportFile('userTable', window.allData); }—— 即使按钮叫“导出”,也别默认塞全量 - 正确做法:保持轻量,只取 cache:
if (obj.event === 'exportCurrent') { const data = table.cache['userTable']; if (!data || data.length === 0) return; table.exportFile('用户列表-第' + curr + '页', data, 'csv'); } - 如果表格列里有
templet渲染的操作列(如按钮、链接),它们不会出现在cache中,天然被跳过 —— 不用额外过滤
真正难的不是“怎么只导当前页”,而是当别人改了代码、加了缓存变量、或者复用了导出函数时,你得一眼看出哪一行悄悄绕过了 cache。盯住 exportFile() 的第二个参数,它决定了导什么。











