Layui如何实现树形组件的全选和反选功能

秋雪姑娘_7016

秋雪姑娘_7016

2026-04-26

824人浏览

原创

树形组件无内置全选/反选方法,须用tree.setchecked()批量操作id数组;直接jquery改checked会破坏layui状态闭环,导致ui与数据不同步。

树形组件本身不提供全选/反选的内置方法,tree.getchecked() 和 tree.setchecked() 是基础能力,但“全选”“反选”必须自己遍历节点并调用 tree.setchecked() —— 否则状态和 ui 会不同步。

为什么不能直接用 jQuery 操作 checked 属性

Layui 树形复选框是动态渲染的伪 DOM,原生 input 元素被隐藏,UI 状态由内部 tree 实例维护。直接 $('...').prop('checked', true) 只改了不可见的真实 input,Layui 不感知,也不重绘图标和半选态。

  • 现象:勾选后图标没变、父节点不自动半选、tree.getChecked() 返回空数组
  • 本质:绕过了 Layui 的状态管理闭环,破坏了父子联动逻辑
  • 正确路径:只通过 tree.setChecked(elemId, boolean) 或批量传 ID 数组触发状态变更

获取全部节点 ID 的安全方式

树结构是递归嵌套的,不能靠 $().find() 提取所有 checkbox —— 它们根本不在初始 HTML 中,而是渲染后动态插入的。必须从数据源或 tree 实例中提取 ID 列表。

  • 推荐:在初始化前把完整 ID 列表缓存下来,比如 const allIds = getAllNodeIds(data),其中 getAllNodeIds 是一个递归扁平化函数
  • 避坑:不要在 done 回调里用 $('.layui-tree-body .layui-tree-txt').length 估算节点数——文本节点 ≠ 复选框节点,且禁用节点、空 children 都会影响准确性
  • 注意:ID 必须是字符串或数字类型,tree.setChecked() 对非标准类型(如对象、null)静默失败

全选 / 反选的 JS 实现要点

绑定按钮点击事件,调用 tree.setChecked() 批量设置,再手动触发一次 form.render('checkbox')(仅当树内混用了 form 表单控件时需要;纯 tree 组件可省略)。

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

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

下载
  • 全选:tree.setChecked('test1', allIds)
  • 全不选:tree.setChecked('test1', [])
  • 反选:先 const checked = tree.getChecked('test1'); const unchecked = allIds.filter(id => !checked.includes(id)); tree.setChecked('test1', unchecked);
  • 性能提示:如果节点超 500 个,避免在单次事件中反复调用 tree.setChecked(),务必用数组批量传入,否则重绘开销陡增

默认选中必须靠后端返回 checked: true

前端 JS 在 tree.render() 后调用 tree.setChecked() 是可行的,但若想“一打开就看到某些节点已勾选”,最稳方式仍是后端在 data 数组每项里带上 checked: true 字段(小写,不能是 Checked 或 is_checked)。

这个字段会被 Layui 自动识别,并在渲染时同步到 UI 和内部状态。任何试图在 done 回调里延迟 setChecked 的做法,都可能因渲染节奏错位导致半选态丢失或父子联动中断——尤其是带懒加载的树,子节点还没拉取,父节点却已被设为“全选”,逻辑就断了。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

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

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

2023.08.11

2463

5

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

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

2023.10.09

5283

6

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

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

2024.03.19

6350

13

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

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

2024.03.22

5938

10

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

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

2024.05.22

843

5

Python uv使用教程
Python uv使用教程

本专题汇总了 Python uv 使用教程与高效使用指南,从 uv 安装配置、常用命令到虚拟环境、依赖管理与项目打包,系统讲解如何用 uv 替代 pip 与 poetry,全面提升 Python 项目开发效率,助你快速上手这一现代化包管理工具,打造干净高效的 Python 工作流。

2026.10.15

0

15

剧云AI短剧创作教程合集
剧云AI短剧创作教程合集

本专题聚焦剧云AI短剧创作,讲解从短剧灵感、梗概、全局大纲到分集、分场和正文的完整流程及节奏设计方法。

2026.10.14

0

15

剧云AI剧本创作零基础入门
剧云AI剧本创作零基础入门

本专题系统讲解剧云AI剧本创作流程,涵盖灵感、梗概、大纲、分场与正文生成,帮助新手快速完成首个中文剧本项目。

2026.10.14

0

14

VibeKnow文档转视频操作指南
VibeKnow文档转视频操作指南

本专题讲解VibeKnow上传Word、TXT、Markdown等材料生成视频的方法,覆盖内容解析、脚本组织、画面生成与成片检查。

2026.10.14

0

15

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.1万人学习

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

共5课时 | 1.6万人学习