讲师中心 微信公众号
AI工具推荐 视频效率加速

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

秋雪姑娘_7016

秋雪姑娘_7016

发布时间:2026-04-26 08:43:28

|

824人浏览过

|

来源于php中文网

原创

树形组件无内置全选/反选方法,须用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 的做法,都可能因渲染节奏错位导致半选态丢失或父子联动中断——尤其是带懒加载的树,子节点还没拉取,父节点却已被设为“全选”,逻辑就断了。

热门AI工具

更多
SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

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

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

2463

2023.08.11

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

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

5283

2023.10.09

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

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

6330

2024.03.19

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

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

5918

2024.03.22

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

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

843

2024.05.22

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

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

0

2026.10.14

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

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

0

2026.10.14

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

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

0

2026.10.14

VibeKnow知识视频制作与导出详解
VibeKnow知识视频制作与导出详解

本专题整理VibeKnow从注册、素材上传、AI生成到预览导出的完整操作,帮助新手快速制作第一条知识讲解视频。

0

2026.10.14

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.1万人学习

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

共5课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn