layui select怎么实现多层树形下拉选择框(treeSelect)

夏敏大大_8346

夏敏大大_8346

2026-11-20

448人浏览

原创

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

layui select怎么实现多层树形下拉选择框(treeselect)

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 占位:
  • 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 弹层机制对齐。常见翻车点:

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统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 里取不到值——这些都不是样式问题,是状态管理没对齐。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3123

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6863

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7670

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7638

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1083

5

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

20

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

20

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

20

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

20

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 13.3万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 11.6万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习