layui原生不支持treeSelect,需用layui-tree-select插件或自行封装;该插件兼容2.8.x版本,支持单/多选、异步加载、禁用节点及搜索高亮,数据格式须含id/title/children字段。

layui 原生不支持 treeSelect,必须扩展或换方案
layui 官方 select 组件只支持扁平选项,没有树形结构能力。强行用 lay-trees 或模拟嵌套 optgroup 会丢失层级交互(如禁用父节点、勾选联动、搜索过滤),且无法展开/折叠。真要树形下拉,得引入第三方插件或自己封装。
推荐用 layui-tree-select 插件(轻量、兼容 layui 2.x)
社区维护的 layui-tree-select 是目前最贴合需求的方案:它复用 layui 的皮肤和弹层逻辑,数据格式与 layui tree 一致,支持单选/多选、异步加载、节点禁用、搜索高亮。使用前需确认你的 layui 版本是 2.8.x 或更低(layui 3 尚未适配)。
实操步骤:
- 下载
layui-tree-select.js和layui-tree-select.css,放入项目static/layui/目录下 - 在
layui.use中声明依赖:['treeSelect'] - HTML 中用普通
select占位:<select id="areaTree"></select> - JS 初始化时传入树形数据(注意字段名:
id、title、children):
treeSelect.render({
elem: '#areaTree',
data: [{
id: '1',
title: '华东',
children: [{
id: '11',
title: '上海'
}]
}],
search: true,
click: function(d){ console.log(d.id, d.title); }
});
自己封装要注意的三个坑
如果坚持手写,核心难点不在渲染,而在与 layui 弹层机制对齐。常见翻车点:
- 点击 select 后弹层位置错乱 → 必须调用
layui.layer.tips并手动计算top/left,不能直接用div浮动 - 失去键盘导航(Tab / 方向键)→ 需监听
keydown,手动管理焦点,且要兼容 layui 的form.on('select')事件触发逻辑 - 表单提交时拿不到值 → 必须同步写入原始
select的value属性,并触发change事件,否则form.val()读不到
异步加载树节点时,data 参数必须返回标准格式
后端接口返回的数据若不规范,treeSelect 会静默失败(不报错但无子节点)。要求返回的 JSON 必须满足:
- 顶层是数组(不是
{data: [...]}包裹) - 每个节点必须含
id和title字段(name或label不识别) - 子节点字段名固定为
children,不能是nodes或list - 若某节点无子节点,
children字段应设为[]或省略,不能为null
错误示例:{"code":0,"data":[{"id":"1","name":"北京"}]} → 缺少 title,children 字段缺失且外层多了一层 data。
树形选择真正的复杂点不在“怎么画出来”,而在于父子节点状态同步、搜索时的路径高亮、以及和 layui 表单验证链路的对接。很多开发者卡在“能显示”就以为完成了,结果上线后发现 disabled 节点可点击、搜索后展开状态丢失、或者 form.verify 里取不到值——这些都不是样式问题,是状态管理没对齐。


















