templet 必须是函数,不能写死模板字符串;需用标准JS逻辑判断并返回HTML,按钮必须带lay-event属性;权限字段应由后端透出,避免依赖全局变量;fixed列需显式设width;交互须通过lay-event统一处理。
templet 必须是函数,不能写死模板字符串
直接在 templet 里写 {{# if(d.status == 'draft') { }}编辑{{# } }} 这类 laytpl 语法,看似能判断,但实际只支持简单字段插值,不支持嵌套逻辑、多条件组合或权限字段校验。它本质是字符串替换,不是 js 执行环境。
真正生效的方式只有一个:把 templet 设为函数,接收参数 d(当前行原始数据),在函数体内用标准 JS 写 if/else 或 switch,最后 return 一段 HTML 字符串。
- 权限判断必须基于
d中已有的字段(如d.role、d.status、d.owner_id),不能依赖全局变量临时拼凑 - 避免在函数里调用
$.ajax或layer.open,templet 只负责“画出来”,不是“做事情” - 返回的字符串中按钮必须带
lay-event属性(如lay-event="edit"),否则table.on('tool(filter)')监听不到
templet: function(d) {
let btns = [];
if (d.status === 'draft' && window.USER_ROLE === 'admin') {
btns.push('<button class="layui-btn layui-btn-xs" lay-event="edit">编辑</button>');
}
if (d.status === 'published' && ['admin', 'editor'].includes(window.USER_ROLE)) {
btns.push('<button class="layui-btn layui-btn-xs layui-btn-danger" lay-event="unpublish">下架</button>');
}
return btns.join('');
}权限字段必须在表格数据中就存在
很多人想用 window.USER_ROLE 或 localStorage.getItem('role') 在 templet 函数里做判断,这本身没问题,但容易忽略一个前提:如果某行数据本应禁止操作(比如非本人创建),而接口没返回 is_owner: true 这类字段,仅靠全局角色就无法实现“行级权限”。
- 后端应在每条记录中透出必要权限标识,例如
can_edit、can_delete、is_creator - 前端不要在
templet里重复计算权限逻辑,比如对d.create_by和window.USER_ID做字符串比对——既易错又难维护 - 若必须前端计算,请统一抽成工具函数,如
canDo(d, 'delete'),避免每列都写一遍相同判断
fixed 列 + 动态按钮 = 必须设 width
当操作列为 fixed: 'right' 且按钮数量不固定(比如有时 1 个、有时 3 个),Layui 容易因宽度计算异常导致列错位或文字换行。这不是 bug,是 CSS 表格渲染机制限制。
-
minWidth不够,必须显式设置width(如width: 240) - 按钮组建议用
display: inline-block布局,别用浮动或 flex(Layui 内部样式会干扰) - 如果按钮太多影响可读性,优先考虑收起为下拉菜单(
layui-dropdown),而不是强行塞进一列
别在 templet 里绑定 onclick 或直接调用方法
写 onclick="handleDelete("+d.id+")" 看似省事,但会绕过 Layui 的事件委托机制,导致:无法响应 table.reload() 后的新数据、lay-event 监听失效、调试时找不到事件源。
- 所有交互行为必须通过
lay-event触发,再由table.on('tool(filter)', callback)统一处理 -
callback中可通过obj.data拿到当前行完整数据,无需手动传参 - 禁用按钮请用
layui-btn-disabled类,而不是删掉 DOM 或加disabled属性(Layui 按钮禁用需样式配合)
动态渲染的复杂点不在“怎么写判断”,而在于“权限依据是否可靠”。行级按钮显示与否,最终得落到每条数据自身携带的权限标识上——全局角色只能兜底,不能越俎代庖。


















