layui table的toolbar分表头和行内两种：表头toolbar用于全局操作，行内toolbar在cols列配置中，通过{{d}}访问当前行数据，二者作用域和使用场景完全不同。
layui table 的 toolbar 是表头工具栏，不是行内操作栏
很多人一上来就往 toolbar 里塞“编辑”“删除”按钮，结果发现点击没反应，或者按钮全堆在表头上——因为 toolbar 只负责渲染在表格顶部的区域，它和每一行完全无关。
真正控制行内操作的是 cols 中某列的 toolbar 字段（注意：是列定义里的，不是表格配置顶层的），它接收一个模板字符串或函数，作用域是当前行数据。
-
table.render()顶层的toolbar：只渲染一次，在表头右侧；适合放“添加”“导出”“刷新”这类全局操作 -
cols某列的toolbar：每行渲染一次，可访问{{d}}（当前行数据）；适合放“编辑”“详情”“停用”等行级操作 - 两者命名相同但上下文完全不同，混用就会找不到变量、事件绑定失效、模板不解析
行工具栏模板里写 {{d.id}} 报错或为空？检查数据字段名和作用域
常见现象是点了按钮，控制台报 Cannot read property 'id' of undefined，或者弹窗里显示 undefined。根本原因不是 ID 不存在，而是模板没进对作用域。
- 行工具栏必须写在
cols的某一列中，且该列type: 'operations'或fixed: 'right'等常规列均可，关键是它的toolbar字段要存在 - 模板中只能用
{{d.xxx}}，不能用{{data.xxx}}或{{row.xxx}}；d是 layui 内部约定的作用域别名 - 如果原始数据字段带点号（如
user.name），模板里不能直接写{{d.user.name}}，需提前在parseData或后端返回时扁平化，或改用函数式toolbar - 函数式写法更可控：
toolbar: function(d) { return '<button class="layui-btn layui-btn-xs" lay-event="edit">编辑</button>'; }，此时d就是完整行数据对象
给行工具栏按钮绑定事件，为什么 table.on('tool(test)', ...) 不触发？
监听器不生效，90% 是因为事件名、过滤器或渲染时机出了问题。Layui 的 tool 事件是委托机制，依赖两个关键匹配：
- 表格容器必须有
id属性，且table.render()中的id配置值要和监听器里的test完全一致（区分大小写） - 按钮必须带
lay-event="xxx"属性，且值要和监听回调里的data.event === 'xxx'对应；比如按钮写lay-event="del"，监听里就要判断if(data.event === 'del') - 监听代码必须在
table.render()之后执行，否则 DOM 还没挂载好，委托无效；推荐把监听写在 render 回调里，或用layui.use(['table'], () => {...})包一层 - 如果用了异步加载（
url配置），确保数据返回结构符合 layui 要求（含data和count字段），否则表格可能没真正渲染，事件委托自然不生效
表头工具栏按钮想禁用/显隐，不能直接操作 DOM，要用 table.reload()
有人习惯用 $('.layui-table-tool .layui-btn').prop('disabled', true)，这看似能点不动，但下次 reload 或排序后状态就丢了——因为表头是动态重绘的，手动改的 DOM 会被覆盖。
- 正确做法是把按钮状态逻辑放进
toolbar模板函数里，例如：toolbar: function() { return layui.sessionData('role') === 'admin' ? '<button class="layui-btn">导出</button>' : ''; } - 如果需要运行时切换（如权限变更后立刻隐藏），调用
table.reload('test', { toolbar: newToolbarFn })，传入新函数即可 - 注意：
reload会重新请求数据（除非加page: false, where: {...}控制），高频切换建议缓存原始数据，避免重复请求
toolbar 和列内 toolbar 共用一个词，但变量、生命周期、使用方式全都不一样。写之前先问自己一句：这个按钮是管整张表，还是只管这一行？答案决定了你该往哪层配置里塞代码。 
