0

0

如何实现复选框组的“全选/取消全选”联动与状态同步

心靈之曲

心靈之曲

发布时间:2026-02-01 19:28:14

|

890人浏览过

|

来源于php中文网

原创

如何实现复选框组的“全选/取消全选”联动与状态同步

本文介绍如何使用原生 javascript 实现多组独立复选框的双向联动:点击“全选”可批量操作子项,任一子项状态变化时自动更新“全选”勾选状态。

在实际开发中(如权限管理面板),常需为每组功能(如 Projects、Project Category、Project Type)提供一个“全选”复选框,并确保其与下属所有复选框保持状态同步:

  • ✅ 点击“全选” → 所有子项被勾选/取消;
  • ✅ 任一子项手动勾选/取消 → “全选”自动反映当前整体状态(全勾选时为 true,否则为 false)。

原问题中的代码仅实现了单向控制(onclick="toggleProjects(this)" 只处理“全选→子项”,未监听子项变更),导致“取消某一项后,全选框仍保持勾选”的逻辑缺陷。正确方案需双向绑定:既响应“全选框”变化,也监听所有子项的 change 事件。

以下是基于原 HTML 结构优化后的完整解决方案(推荐使用原生 JS,无需 jQuery,兼容性好且更轻量):

琅琅配音
琅琅配音

全能AI配音神器

下载

✅ 步骤一:统一结构语义化(关键前提)

为便于 JS 精准定位,建议为每个分组添加语义化 data-group 属性,并将“全选”复选框移出 <button> 内部(避免干扰 Bootstrap Accordion 的默认行为),同时修正重复 ID(如 id="list1" 多次出现):

<!-- 示例:Projects 分组(其他分组同理) -->
<div class="accordion-item">
  <h2 class="accordion-header" id="flush-headingOne">
    <button class="accordion-button collapsed gap-3" type="button"
      data-bs-toggle="collapse" data-bs-target="#flush-collapseOne"
      aria-expanded="false" aria-controls="flush-collapseOne">
      <input class="form-check-input me-2" type="checkbox" value="" 
             id="selectAllList1" data-group="projects" />
      Projects
    </button>
  </h2>
  <div id="flush-collapseOne" class="accordion-collapse collapse"
       aria-labelledby="flush-headingOne" data-bs-parent="#accordionFlushExample">
    <ul class="list-group">
      <li class="list-group-item">
        <div class="form-check">
          <input class="form-check-input" type="checkbox" value="" name="projects" />
          <label class="form-check-label">Add New Project</label>
        </div>
      </li>
      <!-- 其他子项... -->
    </ul>
  </div>
</div>

✅ 步骤二:核心 JavaScript(支持多组,无重复逻辑)

// 初始化所有分组的双向联动
document.addEventListener('DOMContentLoaded', () => {
  // 遍历每个“全选”复选框
  document.querySelectorAll('input[type="checkbox"][data-group]').forEach(toggler => {
    const groupName = toggler.dataset.group;
    const checkboxes = document.querySelectorAll(`input[type="checkbox"][name="${groupName}"]`);

    // 【1】监听“全选框”变化 → 同步所有子项
    toggler.addEventListener('change', () => {
      checkboxes.forEach(cb => cb.checked = toggler.checked);
    });

    // 【2】监听所有子项变化 → 自动更新“全选框”状态
    checkboxes.forEach(checkbox => {
      checkbox.addEventListener('change', () => {
        const allChecked = Array.from(checkboxes).every(cb => cb.checked);
        toggler.checked = allChecked;
      });
    });
  });
});

✅ 关键说明与注意事项

  • 避免内联 JS:删除 HTML 中 onclick="toggleProjects(this)",改用 addEventListener,更易维护且符合现代实践;
  • ID 唯一性:HTML 中多个 <input id="list1"> 违反规范,应改为唯一 ID 或直接使用 name 属性筛选(如上例);
  • 性能优化:Array.from(checkboxes).every(...) 在子项较少时无压力;若数量极大(>100),可缓存已勾选项数量,避免每次遍历;
  • Bootstrap 兼容性:本方案不干扰 Accordion 折叠逻辑,仅增强复选框行为;
  • 扩展性:新增分组只需添加 data-group="xxx" 和对应 name="xxx" 即可自动生效,无需修改 JS。

✅ 最终效果验证

  • ✅ 点击 Projects 全选框 → 所有 name="projects" 子项同步勾选/取消;
  • ✅ 手动取消任一 Projects 子项 → Projects 全选框自动取消;
  • ✅ 三个分组(Projects / Project Category / Project Type)完全独立、互不干扰。

此方案简洁、健壮、可扩展,是表单权限管理场景下的推荐实践。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
jquery插件有哪些
jquery插件有哪些

jquery插件有jQuery UI、jQuery Validate、jQuery DataTables、jQuery Slick、jQuery LazyLoad、jQuery Countdown、jQuery Lightbox、jQuery FullCalendar、jQuery Chosen和jQuery EasyUI等。本专题为大家提供jquery插件相关的文章、下载、课程内容,供大家免费下载体验。

156

2023.09.12

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

337

2023.10.13

jquery删除元素的方法
jquery删除元素的方法

jquery可以通过.remove() 方法、 .detach() 方法、.empty() 方法、.unwrap() 方法、.replaceWith() 方法、.html('') 方法和.hide() 方法来删除元素。更多关于jquery相关的问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

408

2023.11.10

jQuery hover()方法的使用
jQuery hover()方法的使用

hover()是jQuery中一个常用的方法,它用于绑定两个事件处理函数,这两个函数将在鼠标指针进入和离开匹配的元素时执行。想了解更多hover()的相关内容,可以阅读本专题下面的文章。

516

2023.12.04

jquery实现分页方法
jquery实现分页方法

在jQuery中实现分页可以使用插件或者自定义实现。想了解更多jquery分页的相关内容,可以阅读本专题下面的文章。

312

2023.12.06

jquery中隐藏元素是什么
jquery中隐藏元素是什么

jquery中隐藏元素是非常重要的一个概念,在使用jquery隐藏元素之前,需要先了解css样式中关于元素隐藏的属性,比如display、visibility、opacity等属性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

129

2024.02.23

jquery中什么是高亮显示
jquery中什么是高亮显示

jquery中高亮显示是指对页面搜索关键词时进行高亮显示,其实现办法:1、先获取要高亮显示的行,获取搜索的内容,再遍历整行内容,最后添加高亮颜色;2、使用“jquery highlight”高亮插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

184

2024.02.23

jQuery 正则表达式相关教程
jQuery 正则表达式相关教程

本专题整合了jQuery正则表达式相关教程大全,阅读专题下面的文章了解更多详细内容。

51

2026.01.13

Python WebSocket实时通信与异步服务开发实践
Python WebSocket实时通信与异步服务开发实践

本专题聚焦 Python 在实时通信场景中的开发实践,系统讲解 WebSocket 协议原理、长连接管理、消息推送机制以及异步服务架构设计。内容包括客户端与服务端通信实现、连接稳定性优化、消息队列集成及高并发处理策略。通过完整案例,帮助开发者构建高效稳定的实时通信系统,适用于聊天应用、实时数据推送等场景。

7

2026.03.18

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 6.2万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 3.5万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.7万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号