0

0

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

聖光之護

聖光之護

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

|

460人浏览过

|

来源于php中文网

原创

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

本文介绍如何使用原生 javascript 实现 accordion 中每组子复选框与顶部“全选”复选框的双向联动:点击全选框可批量操作,勾选/取消任意子项时自动更新全选框状态。

在权限管理类表单中,常需为多个功能模块(如 Projects、Project Category、Project Type)分别提供“全选”控制能力。理想行为应满足两个核心逻辑:

  • 正向控制:点击“全选”复选框 → 所有同组子复选框同步勾选或取消;
  • 反向同步:任意一个子复选框状态变更 → 自动检测整组是否全部选中,从而动态更新“全选”框的 checked 状态。

你当前的代码仅实现了正向控制(onclick="toggleProjects(this)"),但缺少对子项变更的监听,因此无法响应“手动取消某一项”后全选框仍保持勾选的问题。

✅ 推荐方案:原生 JavaScript(无 jQuery 依赖)

以下为清晰、可复用、符合语义的实现方式(适配你的 Bootstrap Accordion 结构):

<!-- 示例:Projects 分组(其他分组结构同理) -->
<h2 class="accordion-header">
  <button class="accordion-button collapsed gap-3" type="button"
          data-bs-toggle="collapse" data-bs-target="#flush-collapseOne">
    <input class="form-check-input" type="checkbox" value="" id="selectAllList1" />
    Projects
  </button>
</h2>
<div id="flush-collapseOne" class="accordion-collapse collapse">
  <ul class="list-group">
    <li class="list-group-item">
      <div class="form-check">
        <input class="form-check-input" type="checkbox" name="projects" value="add" />
        <label class="form-check-label">Add New Project</label>
      </div>
    </li>
    <li class="list-group-item">
      <div class="form-check">
        <input class="form-check-input" type="checkbox" name="projects" value="view" />
        <label class="form-check-label">View Project</label>
      </div>
    </li>
    <li class="list-group-item">
      <div class="form-check">
        <input class="form-check-input" type="checkbox" name="projects" value="edit" />
        <label class="form-check-label">Edit Project</label>
      </div>
    </li>
  </ul>
</div>
// 封装为可复用函数,避免重复代码
function setupSelectAll(groupName, toggleId) {
  const toggler = document.getElementById(toggleId);
  const checkboxes = document.querySelectorAll(`input[name="${groupName}"]`);

  // 【反向同步】监听每个子项变化,更新全选框状态
  checkboxes.forEach(box => {
    box.addEventListener('change', () => {
      const allChecked = Array.from(checkboxes).every(cb => cb.checked);
      toggler.checked = allChecked;
      // 可选:当全部未选时,也清除 indeterminate 状态(见下方说明)
      if (!allChecked && !Array.from(checkboxes).some(cb => cb.checked)) {
        toggler.indeterminate = false;
      }
    });
  });

  // 【正向控制】点击全选框,同步所有子项
  toggler.addEventListener('change', () => {
    checkboxes.forEach(cb => (cb.checked = toggler.checked));
  });
}

// 初始化各分组(按需调用)
setupSelectAll('projects', 'selectAllList1');
setupSelectAll('projectCategory', 'selectAllList2');
setupSelectAll('projectType', 'selectAllList3');

? 关键说明与增强建议

  • indeterminate 状态(进阶体验)
    当部分子项被选中时,“全选框”应显示为半选(—)状态,提升用户感知。可在 change 回调中添加:

    const checkedCount = Array.from(checkboxes).filter(cb => cb.checked).length;
    toggler.indeterminate = checkedCount > 0 && checkedCount < checkboxes.length;
  • 避免 ID 冲突:你原始代码中多个 <label for="list1"> 共享相同 id="list1",违反 HTML 唯一性规范,务必为每个复选框设置唯一 id(如 id="project-add"、id="category-view")。

    Wave.Video
    Wave.Video

    一个在线的AI自动化视频创作平台

    下载
  • 性能与兼容性:上述代码使用 addEventListener 替代内联 onclick,更易维护且支持现代浏览器(包括 IE11+)。若需兼容更老版本,可改用 attachEvent 回退方案。

  • jQuery 版本(如必须使用)

    function setupSelectAllJQ(groupName, toggleId) {
      const $toggler = $(`#${toggleId}`);
      const $boxes = $(`input[name="${groupName}"]`);
    
      $boxes.on('change', () => {
        const allChecked = $boxes.filter(':checked').length === $boxes.length;
        $toggler.prop('checked', allChecked).prop('indeterminate', 
          $boxes.filter(':checked').length > 0 && !allChecked
        );
      });
    
      $toggler.on('change', () => {
        $boxes.prop('checked', $toggler.is(':checked'));
      });
    }

✅ 总结

真正健壮的“全选/反选”逻辑必须是双向绑定:既要响应全选框操作,也要监听子项变更并反馈状态。通过 change 事件 + Array.from().every() 检测 + addEventListener 解耦,即可实现高内聚、低耦合的权限控制组件。建议移除所有内联 JS(如 onclick),统一交由初始化脚本管理,便于后续扩展与测试。

热门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号