Layui tree 组件无内置搜索功能,需手动实现:遍历数据递归标记匹配节点,生成精简后保持层级的新数据并 reload;配合防抖、ID 展开状态维护(加 spread: true)提升体验。
为什么直接用 tree.render() 无法触发搜索过滤
layui 的原生 tree 组件不内置搜索功能,tree.render() 渲染后所有节点是静态 dom,没有提供类似 filter() 或 setfilter() 的 api。你调用 tree.reload() 时传入新数据,它只会整棵树重绘,不会“动态高亮+收起无关节点”——这是用户真正想要的交互效果。
如何手动实现关键词匹配 + 节点展开/隐藏逻辑
核心思路是:遍历原始树数据,递归标记哪些节点或其子孙匹配关键词,再基于标记结果生成「精简后仍保持层级结构」的新数据,并重新渲染。注意不是只筛叶子节点,父节点只要任一后代匹配,自己也必须保留(否则路径断开)。
实操建议如下:
- 用深度优先遍历(DFS)处理原始
data,每个节点加一个临时字段如match(布尔值),表示自身或后代是否匹配 - 匹配判断用
node.name.includes(keyword),注意大小写敏感,如需忽略则用toLowerCase() - 过滤后生成新数组时,跳过
match === false且无子节点(或子节点全被筛掉)的节点 - 调用
tree.reload({ data: filteredData }),不要改原始数据引用,避免副作用
示例片段:
function filterTreeData(data, keyword) {
if (!keyword) return data;
const reg = new RegExp(keyword, 'i');
function walk(nodes) {
return nodes
.map(node => {
const matchedSelf = reg.test(node.name);
const children = node.children ? walk(node.children) : [];
const hasMatchedChild = children.some(c => c.match || c.matchedSelf);
if (matchedSelf || hasMatchedChild) {
return {
...node,
match: true,
children: children.length ? children : undefined
};
}
return null;
})
.filter(Boolean);
}
return walk(data);
}
// 使用时
const keyword = document.getElementById('searchInput').value;
const filtered = filterTreeData(originalTreeData, keyword);
tree.reload({ data: filtered });
搜索框输入实时响应与性能注意事项
监听 input 事件即可,但别直接每敲一个字就调用 filterTreeData + reload——尤其当树有上千节点时,DOM 重绘会卡顿。
推荐做法:
- 用
setTimeout做防抖,延迟 300ms 再执行过滤,用户停顿后才响应 - 如果原始数据量极大(>2000 节点),把
filterTreeData改成 Web Worker 处理,避免阻塞主线程 - 避免在
tree.on('click')回调里做搜索,那属于误触场景;搜索应独立绑定在 input 上 - 记得清空时还原为原始
data,而不是传空数组,否则节点全部消失
展开状态丢失问题怎么解决
tree.reload() 后所有节点默认收起,用户之前手动展开的路径没了。Layui 没暴露当前展开节点 ID 列表,所以得自己维护。
可行方案:
- 在
tree.on('click', ...)中监听展开/收起动作,用 Set 存储已展开节点的id(需确保原始数据每个节点有唯一id字段) - 过滤后新数据中,对匹配节点的
id检查是否在 Set 中,是则加spread: true属性 - 注意:Layui tree 的
spread是初始化参数,reload 时带上才能生效,不是运行时可修改的
这步容易漏,没加 spread: true 就等于白做了搜索体验。











