<p>layui table自动加序号列推荐用{type: 'numbers'}(2.8+原生支持),旧版用templet: function(d) { return d.LAY_TABLE_INDEX + 1; },全局连续需手动计算:(d.LAY_PAGE_INDEX - 1) * d.LAY_PAGE_COUNT + d.LAY_TABLE_INDEX + 1。</p>

layui table 渲染时怎么自动加序号列
直接在 cols 配置里加一列,用 templet 返回序号即可。Layui 的 table 实例会把当前行的索引(从 0 开始)传给 templet 函数,你只需 +1 就是自然序号。
注意:这个序号是渲染顺序序号,不是数据原始数组下标,也不随排序/分页重算——除非你手动干预。
- 推荐写法:
{type: 'numbers'}(layui 2.8+ 原生支持) - 兼容旧版(如 2.7):用
templet: function(d) { return d.LAY_TABLE_INDEX + 1; } -
data数组为空时,templet不会执行,所以无需额外判空 - 如果启用了
page: true,默认每页从 1 开始编号;要全局连续序号,得自己算:(d.LAY_PAGE_INDEX - 1) * d.LAY_PAGE_COUNT + d.LAY_TABLE_INDEX + 1
为什么 d.LAY_TABLE_INDEX 有时不递增或跳变
这个值是 layui 内部按「当前页渲染顺序」分配的,不是原始数据索引。常见导致异常的情况:
- 表格启用了
loading: false且数据异步返回后手动调用table.reload(),但没传initSort或where,可能触发重复渲染,导致索引错乱 - 用了
table.cache手动改数据再重载,但没同步更新data源数组,LAY_TABLE_INDEX仍按新 data 长度重排 - 自定义
done回调里又调了一次table.render(),造成嵌套渲染,索引被覆盖
验证方式:在 templet 里打印 console.log(d),看 layIndex 和 LAY_TABLE_INDEX 是否一致(新版推荐用 layIndex,更稳定)。
排序或搜索后序号还保持 1,2,3… 怎么办
默认行为就是如此——templet 每次重绘都重新执行,所以只要没做特殊处理,序号始终是当前视图下的 1,2,3…
如果你需要「原始数据序号」(比如第 5 条数据永远显示 “#5”,不管它排在哪一页),就不能依赖 LAY_TABLE_INDEX,而要在原始数据里加字段:
- 初始化前遍历数据:
data.forEach((item, i) => item._originIndex = i + 1); - 列配置写:
{field: '_originIndex', title: '序号'} - 这样即使拖拽列、排序、搜索,序号也不会变
注意:这种方案下,_originIndex 是只读标识,别拿它当真实主键用。
用 type: 'numbers' 时样式错位或不显示
这是最常见的样式问题,原因通常是自定义了 cellMinWidth 或 minWidth 太小,导致数字列被压缩隐藏,或者 CSS 覆盖了 layui 默认的 .layui-table-number 样式。
- 检查是否设置了
cellMinWidth: 1或类似极小值,建议设为50起步 - 确认没在全局 CSS 里写
.layui-table-number { display: none; }这类规则 - 如果用了
skin: 'row',需额外加style: 'text-align:center;'否则数字可能左偏 - IE11 下偶发不渲染,可降级用
templet方案兜底
复杂点在于:序号列本质是「伪列」,不占 data 字段,也不参与导出和筛选。如果业务要求导出带序号,必须在 exportData 钩子或后端拼接,前端 table 组件本身不提供该能力。


















