Layui eleTree 使用指南:打造高效树形选择器

1 下载量 102 浏览量 更新于2024-08-30 收藏 60KB PDF 举报
本文主要介绍了Layui框架中的eleTree模块,这是一个用于实现树状选择器的组件。eleTree提供了一种优雅的方式来展示层级数据,并支持用户进行选择操作。在实际应用中,eleTree常用于组织结构、文件目录等场景。 在开始使用eleTree之前,需要确保已经正确地引入了相关资源。JS文件应引用`layui/lay/modules/eleTree.js`,CSS文件则需要引入`layui/css/layui.css`和`layui/css/modules/eleTree/eleTree.css`。页面中可以通过`<div>`标签创建eleTree实例,例如`<div class="eleTree" lay-filter="data1"></div>`,其中`lay-filter`属性用于标识不同的eleTree实例。 eleTree的配置项非常丰富,包括但不限于以下几点: 1. 数据(data):eleTree的数据源,通常是一个包含多级嵌套对象的数组。每个对象至少包含`label`属性,表示节点的文本。如果节点有子节点,则应包含`children`属性,其值是一个包含子节点的数组。`spread`属性用于控制节点是否默认展开,`disabled`属性表示节点是否禁用,`checked`属性表示节点是否默认被选中。 2. 样式(style):可以通过CSS来定制eleTree的样式,例如节点的展开图标、选中样式等。 3. 事件(events):eleTree提供了多种事件回调,如`onNodeClick`(节点点击事件)、`onCheckChange`(选中状态改变事件)等,可以根据业务需求编写相应的处理函数。 4. 功能设置(options):可以设置是否开启多选(`checkStrictly`),是否允许半选(`halfCheck`),以及是否自动展开父节点(`autoExpandParent`)等。 以下是一个简单的使用示例: ```html <!DOCTYPE html> <html lang="zh"> <head> <meta charset="UTF-8"> <link rel="stylesheet" href="layui/css/layui.css"> <link rel="stylesheet" href="layui/css/modules/eleTree/eleTree.css"> <script src="layui/layui.js"></script> </head> <body> <div class="eleTree" lay-filter="data1"></div> <button class="layui-btn">获取选中数据</button> <script> layui.use(['eleTree'], function () { var eleTree = layui.eleTree; var data = [ // 数据源结构 ]; eleTree.render({ el: '.eleTree', // 指定eleTree的容器元素 data: data, checkStrictly: true, // 开启严格模式,不允许半选 showLine: true, // 显示连接线 onNodeClick: function (d) { console.log('点击了节点:', d); }, onCheckChange: function (d, checked) { console.log('选中状态改变:', d, '当前状态:', checked); } }); }); </script> </body> </html> ``` 在这个例子中,当用户点击节点或改变选中状态时,会将相关信息打印到控制台。通过这种方式,开发者可以根据业务逻辑处理用户的交互行为。 Layui的eleTree组件提供了一个强大且易于使用的树状选择器,通过灵活的配置和丰富的事件机制,能够满足各种复杂的界面需求。只需按照官方文档的指引,结合实际项目需求,就可以轻松集成并发挥出eleTree的强大功能。