layui 2.9.0+ 支持 treetable.expandall() 和 foldall() 方法,需在 render 完成后调用且节点含 children 字段;旧版需模拟点击 .layui-icon-addition/.subtraction 图标;spread 字段仅初始渲染生效,不响应式。
treetable 没有内置的 expandall() 或 foldall() 方法,必须通过 api 调用或模拟点击实现。直接调用 render() 重绘或修改数据后 reload() 都不会自动触发展开/折叠状态变更——状态由 dom 节点上的图标类和内部缓存共同控制。
用 treeTable.expandAll() 和 treeTable.foldAll()(Layui 2.9.0+)
从 Layui 2.9.0 开始,treeTable 模块正式提供了这两个方法,但需注意:它们只对已渲染完成的表格生效,且要求节点数据中存在有效的 children 字段(空数组 [] 也算,null 或 undefined 会导致跳过)。
- 调用前确保
treeTable.render()已执行完毕,建议在done回调里绑定按钮事件 -
expandAll()不会递归强制展开“无子节点”的节点(即children为空或不存在),这点和手动点击图标行为一致 - 若表格启用了
accordion: true,expandAll()仍会尝试展开所有节点,但手风琴逻辑会在后续用户交互中立即干预——所以批量展开时应关闭accordion - 示例:
treeTable.expandAll('treeTableDemo'); // 'treeTableDemo' 是 render 时传入的 id
兼容旧版(Layui
低版本只能靠遍历 DOM 触发点击事件,本质是模拟用户点击展开/折叠图标。这种方式不依赖内部 API,但耦合了图标类名,稳定性略低。
- 展开全部:查找所有
.layui-icon-addition(加号图标),逐个 dispatch click - 折叠全部:查找所有
.layui-icon-subtraction(减号图标),逐个 dispatch click - 注意:必须等表格 DOM 渲染完成再执行,推荐放在
done回调或setTimeout(..., 0)中 - 容易踩的坑:
querySelectorAll只匹配当前页可见节点(虚拟滚动启用时),如需全量操作,得先禁用page: false或配合scrollTo滚动加载
spread 字段不能用于运行时批量控制展开状态
spread: true 只在初始渲染时起作用,它不是响应式字段。修改已有节点的 spread 值并调用 reload(),不会改变当前展开状态——treeTable 内部不监听该字段变化。
- 想用数据驱动方式控制,默认展开请在原始数据里写死
spread: true;运行时切换请用expandAll()/foldAll()或模拟点击 - 动态增删节点后,新节点的
spread值才会影响其初始状态,老节点不变 - 别在
data数组里给每个节点都塞spread: true然后指望reload()刷新出效果——这招没用
最易被忽略的一点:如果表格启用了 onlyIconControl: true,那么模拟点击文字区域或任意父容器都无效,必须精准点击 .layui-icon-addition 或 .layui-icon-subtraction 元素本身——否则事件根本不会触发展开逻辑。











