toolbar生效需同时满足：表格配置含toolbar、对应script模板ID匹配且type="text/html"、未被defaultToolbar:false等覆盖；事件监听须用table.on('toolbar(滤镜值)',fn)，按钮需lay-event属性。
toolbar 属性怎么配才生效
必须同时满足三个条件，toolbar 才会真正渲染出按钮：表格配置里写了 toolbar，对应模板存在且 id 匹配，还要确保没被 defaulttoolbar: false 或其他覆盖逻辑屏蔽。
-
toolbar值可以是字符串（如'#toolbarDemo'）或 HTML 字符串（如'<button class="layui-btn">导出</button>'），但推荐用模板 ID——更易维护、支持事件绑定 - 模板必须是
<script type="text/html" id="toolbarDemo">...</script>，不能写成<div id="toolbarDemo">，否则table.render()找不到 - 如果用了
defaultToolbar数组（比如['filter', 'exports']），自定义toolbar会和它并存；想完全替换，得显式设defaultToolbar: []
按钮点击事件监听不到？检查 lay-filter 和 on('toolbar()')
工具栏按钮的点击不走 form.on('submit')，也不走普通 click，必须用 table.on('toolbar(你的lay-filter值)', callback)，漏掉括号里的 filter 名或拼错，事件就静默失效。
- 表格初始化时的
lay-filter="userTable"必须和监听时的toolbar(userTable)完全一致，大小写、下划线都不能差 - 按钮上必须带
lay-event="export_csv"这类属性，obj.event拿到的就是这个值，不是id或class - 别在模板里写
onclick="xxx()"——会破坏 layui 的事件代理机制，且拿不到obj对象里的表格上下文（如obj.config、obj.data）
想在工具栏里加下拉菜单或二级操作
layui 原生不提供下拉菜单组件，但可以用纯 HTML + CSS + 简单 JS 实现，关键是把子菜单包裹在按钮同级容器内，并用 lay-event 绑定到每个子项上。
- 模板里写：
<div class="layui-btn-group"><button class="layui-btn">导出</button><div class="layui-dropdown"><span class="layui-btn layui-btn-primary layui-border">▼</span><dl><dd><a lay-event="export_csv">CSV</a></dd><dd><a lay-event="export_xlsx">Excel</a></dd></dl></div></div> - CSS 需手动控制
.layui-dropdown显示/隐藏（用display: none/block或visibility），layui 不接管这部分样式 - 监听时仍用
table.on('toolbar(userTable)')，obj.event会是"export_csv"或"export_xlsx"，直接分支处理即可
按钮状态要随数据动态变化？别在 toolbar 模板里硬判断
工具栏是全局的，不感知当前行或筛选状态。如果想“只在有选中行时才启用导出按钮”，得靠 JS 控制 DOM，而不是在模板里写 {{# if(d.length > 0) { }}...{{# } }} ——那根本没用，因为 toolbar 模板没有 d 上下文。
- 正确做法：渲染完表格后，用
table.checkStatus('userTable')拿选中数据，在回调里调用$('[lay-event="export"]').prop("disabled", !data.length) - 或者监听
checkbox事件（table.on('checkbox(userTable)')），实时更新按钮状态 - 注意：禁用按钮只是视觉反馈，最终提交前仍需在事件回调里二次校验，防止用户绕过禁用直接触发
toolbar 的坑不在写法多难，而在它和表格实例的生命周期耦合紧密——模板加载时机、事件注册顺序、filter 名一致性，三者错一个，按钮就变“哑巴”。动手前先确认 render 完了没、filter 对不对、浏览器控制台有没有报 Uncaught TypeError: Cannot read property 'on' of undefined 这类错误。
