Layui table.render() 默认不支持合计行固定在底部:其 footer 随横向滚动,需在 done 回调中手动插入 DOM 并同步表头列宽,且 reload 时须先移除旧合计行再重建。
合计行固定在表格底部不随横向滚动而移动
直接说结论:layui 的 table.render() 默认不支持合计行(footer)脱离横向滚动容器独立固定。它会和 body 区域一起被包裹在 .layui-table-box 内,滚动时自然跟随。想让它“钉”在底部不动,必须绕过默认 footer 渲染逻辑,手动插入一个 dom 节点并控制其宽度与表头对齐。
用 done 回调 + 手动追加合计 DOM 替代原生 footer
Layui 表格的 footer 配置(如 footer: true 或传入 HTML 字符串)生成的合计行是塞进 .layui-table-body 里的,必然随横向滚动。真正能固定的,是你自己 append 进去的、位于 .layui-table-box 外层或同级的 DOM。
- 在
done回调里获取表格容器:const box = $(elem).closest('.layui-table-box') - 计算表头总宽度(含滚动条占位):
box.find('.layui-table-header table').outerWidth() - 创建合计行 DOM,设为
position: relative或absolute,宽度设为上一步结果,并插入到box后面(或内部 bottom) - 监听窗口 resize 和表格重载,重新同步宽度,否则列宽变化后会错位
- 注意:不能用
fixed: true列,因为 fixed 列会把合计行撑开或截断;合计行所有单元格需按列数硬编码或遍历cols[0]动态生成
合计单元格宽度如何跟表头列宽严格对齐
表头列宽是动态计算的(受文字长度、minWidth、width 等影响),手动写的合计行如果只设固定 width 或百分比,很容易偏移。必须逐列读取真实渲染后的宽度。
- 遍历
box.find('.layui-table-header th'),用$(th).outerWidth()拿每列宽度(含 padding/border) - 合计行每个
<td>设置width: [数值]px(不是min-width),避免弹性缩放 - 第一列如果是复选框/序号列,注意
.layui-table-col-special的额外 padding,要一并计入 - 如果启用了
scrollbar(自定义滚动条),记得判断是否出现垂直滚动条——有则减去 12px(常见宽度),否则合计行整体变窄导致右偏
性能和兼容性要注意的几个硬伤
这个方案本质是 DOM 注入 + 宽度劫持,Layui 本身没为此设计 API,所以有几个现实约束很紧:
- 每次
table.reload()后,done会触发,但旧合计行不会自动销毁,必须先$('.my-footer-row').remove()再重建,否则重复叠加 - IE11 下
outerWidth()在某些嵌套场景返回0,建议 fallback 到getBoundingClientRect().width - 移动端 Safari 对
position: sticky支持差,别试图用它替代手动定位;老版本 Layui(.layui-table-box 结构略有不同,需检查父容器 class 名 - 合计行内容若含
lay-event或需要绑定点击事件,得用事件委托挂到box.parent()上,不能直接 on 到刚 append 的节点(重载后节点就丢了)
最麻烦的其实是列宽同步时机——必须等表格完全渲染完(包括字体加载、图片占位结束),done 里加个 setTimeout(..., 0) 很常见,不然第一次取到的 th 宽度是错的。


















