JavaScript实现复选框全选、全不选和反选

作者:窗边听雨

时间:2026-11-19

浏览:533

详细讲解如何使用原生JavaScript实现复选框的全选、全不选和反选功能。涵盖checked布尔属性的核心控制机制、主控复选框与子选项的双向联动、indeterminate半选状态管理以及基于事件委托的性能优化。

文章目录
技术教程 阅读时长:约 8 分钟 技术栈:原生 JavaScript (ES6+) / DOM API
JavaScript实现复选框全选、全不选和反选
概览图:JavaScript 复选框控制核心逻辑与双向联动体系
在 Web 表单、数据管理列表及后台管理系统中,复选框的批量勾选属于高频操作。实现“全选”、“全不选”和“反选”的核心,在于通过 JavaScript 直接读写 DOM 元素的布尔属性 element.checked,并在各个子项变化时反向推导主控复选框的完整选中、部分选中(indeterminate 半选)与未选中状态。本文将从底层属性机制、三种操作的基础实现、双向联动闭环以及事件委托性能优化四个层次,给出可直接在生产中复用的完整方案。

一、复选框状态控制的核心机制

初学者在操作复选框时,最容易出现的失误是混淆了 HTML 标签特性(Attribute) 与 DOM 对象属性(Property)。理解这两者的本质区别,是编写稳健复选框逻辑的前提。

1. 为什么不能使用 setAttribute('checked')?

在 HTML 规范中,标签内声明的 <input type="checkbox" checked> 仅仅决定了页面初次载入时的“默认值”(对应 DOM 对象的 defaultChecked 属性)。当用户在界面中点击了该复选框后,其界面状态已经脱离了 HTML 属性的控制,转由浏览器内部的活动内存状态管理。

如果使用 element.setAttribute('checked', 'checked') 或 element.removeAttribute('checked'),修改的仅仅是 DOM 节点上的特性标记,并不会动态更新已经经过用户交互的复选框勾选状态。因此,必须直接赋值布尔属性:element.checked = true 或 element.checked = false。

2. 认识半选状态:indeterminate

在现代 UI 设计中,当子列表中只有部分项目被选中时,表头的主控复选框通常需要显示一条横杠(即半选/部分选中态)。许多开发者试图在 HTML 源码中寻找 indeterminate 标签,但事实上 HTML 语法中根本不存在此属性。

indeterminate 是一个纯粹由 JavaScript 提供的 DOM 视觉布尔属性:

  • element.indeterminate = true:浏览器将渲染半选横杠样式(即便此时 element.checked 为 false)。
  • element.indeterminate = false:清除横杠视觉,恢复正常的空白或对勾表现。
JavaScript实现复选框全选、全不选和反选
图 1:复选框 DOM 属性映射与三态模型

二、三种基础操作的实现原理与代码

在实现操作之前,我们需要先通过选择器获取所有的目标子选项复选框。推荐使用 document.querySelectorAll() 获取静态的 NodeList 集合。

1. 全选 (Select All)

全选的目标是将集合中的每一个子复选框的 checked 属性强制置为 true。如果存在主控复选框,还需将其 indeterminate 重置为 false 并勾选。

// 获取所有子复选框并设为 true
function selectAll() {
  const items = document.querySelectorAll('.item-checkbox');
  items.forEach(item => {
    item.checked = true;
  });
}

2. 全不选 (Deselect All)

全不选即清空所有勾选项,将每一个子复选框的 checked 属性置为 false。

// 获取所有子复选框并设为 false
function deselectAll() {
  const items = document.querySelectorAll('.item-checkbox');
  items.forEach(item => {
    item.checked = false;
  });
}

3. 反选 (Invert Selection)

反选的逻辑是“原先选中的变为未选,原先未选的变为选中”。这可以直接借助 JavaScript 的逻辑非操作符(!)对当前状态进行布尔取反:

// 对当前 checked 状态取反
function invertSelection() {
  const items = document.querySelectorAll('.item-checkbox');
  items.forEach(item => {
    item.checked = !item.checked;
  });
}
JavaScript实现复选框全选、全不选和反选
图 2:全选、全不选与反选操作的执行逻辑与状态变换

三、实现主控复选框与子选项的双向联动闭环

在实际业务场景中,单纯提供三个独立按钮往往不够,通常需要表格顶部的“主控复选框”与所有数据行形成双向联动:

  1. 下行联动(主控 → 子项):用户勾选或取消主控复选框时,所有子选项跟随主控状态批量变更。
  2. 上行联动(子项 → 主控):用户逐个勾选子选项时,系统自动统计选中数量,动态决定主控复选框呈现“全选”、“半选”还是“全不选”。
JavaScript实现复选框全选、全不选和反选
图 3:主控复选框与子项列表的双向联动生命周期

双向联动实现的核心算法

反推主控状态的关键是计算当前已被选中的子项总数 checkedCount 与子项总数 total:

function updateMasterCheckbox() {
  const master = document.querySelector('#checkAll');
  const items = document.querySelectorAll('.item-checkbox');
  
  const total = items.length;
  // 空列表保护
  if (total === 0) {
    master.checked = false;
    master.indeterminate = false;
    return;
  }

  // 统计已勾选数量
  let checkedCount = 0;
  items.forEach(item => {
    if (item.checked) checkedCount++;
  });

  if (checkedCount === total) {
    // 分支 1:全部选中
    master.checked = true;
    master.indeterminate = false;
  } else if (checkedCount === 0) {
    // 分支 2:全部未选
    master.checked = false;
    master.indeterminate = false;
  } else {
    // 分支 3:部分选中(半选状态)
    master.checked = false;
    master.indeterminate = true;
  }
}
避坑提示:indeterminate 与 checked 属性的优先级

在大多数现代浏览器的默认样式中,只要 element.indeterminate = true,无论此时 element.checked 为 true 还是 false,视觉上都会显示为“横杠(半选)”。为了逻辑严谨且便于表单提交数据判断,在进入半选状态时,建议显式设置 master.checked = false。

四、完整可运行代码与交互演示

以下将 HTML、CSS 和原生 JavaScript 整合为一份可以直接运行的交互示例,同时支持顶部工具栏按钮操作与表头主复选框联动:

在线交互演示:商品数据批量选择
编号 商品名称 单价 (元) 库存状态
#1001 机械键盘 87键茶轴 ¥ 399.00 现货充足
#1002 人体工学无线鼠标 ¥ 189.00 现货充足
#1003 4K Type-C 显示器 27英寸 ¥ 1,899.00 仅剩 3 件
#1004 铝合金双轴便携支架 ¥ 69.00 现货充足
当前状态:0 / 4 项已勾选 (主控:未勾选) 实时响应测试区

完整 JavaScript 实现源码

// 1. 获取核心 DOM 节点
const masterCheckbox = document.querySelector('#demo-master-check');
const tableBody = document.querySelector('#demo-item-body');
const itemCheckboxes = document.querySelectorAll('.demo-item');
const btnSelectAll = document.querySelector('#demo-btn-all');
const btnDeselectAll = document.querySelector('#demo-btn-none');
const btnInvert = document.querySelector('#demo-btn-invert');
const summaryText = document.querySelector('#demo-summary-text');

// 2. 状态更新函数(上行反推)
function syncMasterState() {
  const items = document.querySelectorAll('.demo-item');
  const total = items.length;
  const checkedCount = Array.from(items).filter(item => item.checked).length;

  if (checkedCount === 0) {
    masterCheckbox.checked = false;
    masterCheckbox.indeterminate = false;
  } else if (checkedCount === total) {
    masterCheckbox.checked = true;
    masterCheckbox.indeterminate = false;
  } else {
    masterCheckbox.checked = false;
    masterCheckbox.indeterminate = true;
  }

  // 更新文本提示
  let stateLabel = masterCheckbox.indeterminate ? '半选中' : (masterCheckbox.checked ? '全选' : '未选');
  summaryText.textContent = `当前状态:${checkedCount} / ${total} 项已勾选 (主控:${stateLabel})`;
}

// 3. 下行联动:点击表头主控复选框
masterCheckbox.addEventListener('change', function() {
  const isChecked = this.checked;
  itemCheckboxes.forEach(item => {
    item.checked = isChecked;
  });
  masterCheckbox.indeterminate = false;
  syncMasterState();
});

// 4. 事件委托:统一监听列表容器内的复选框变更
tableBody.addEventListener('change', function(e) {
  if (e.target && e.target.classList.contains('demo-item')) {
    syncMasterState();
  }
});

// 5. 按钮组操作绑定
btnSelectAll.addEventListener('click', function() {
  itemCheckboxes.forEach(item => item.checked = true);
  syncMasterState();
});

btnDeselectAll.addEventListener('click', function() {
  itemCheckboxes.forEach(item => item.checked = false);
  syncMasterState();
});

btnInvert.addEventListener('click', function() {
  itemCheckboxes.forEach(item => item.checked = !item.checked);
  syncMasterState();
});

// 初始化状态
syncMasterState();

五、关键避坑指南与性能优化

在面对数据项庞大(例如上千行数据表格)或动态增删节点的需求时,实现方式的优劣会对页面渲染性能和内存开销产生明显影响。

JavaScript实现复选框全选、全不选和反选
图 4:复选框控制实践避坑指南与方案对比
考量维度 易错 / 低效做法 推荐最佳实践 原因解析
属性操作 setAttribute('checked', 'checked') el.checked = true 特性标记只影响初始默认属性,DOM 布尔属性才能直接操作真实视图内存。
事件监听 监听 click 事件 监听 change 事件 change 在勾选动作完全确定后触发,能够天然兼容键盘(空格触发)与无障碍设备。
监听器挂载 为每一个 <input> 分别绑定 addEventListener 在父容器(如 <tbody>)使用事件委托 单监听器节约内存开销;当表格异步加载下一页或删除行时,无需重新绑定事件。
高阶数组操作 直接在 querySelectorAll 上调用 filter 先转换为真实数组 Array.from(nodeList) NodeList 虽有 forEach,但缺少 filter、every、map 等高级方法。

针对万级大列表的遍历优化建议

当复选框数量超过数千行时,避免在每次单选变更时都执行完整的全列表循环。可以通过维护一个整数计数器 checkedCounter 进行增量计算:

  • 子复选框变为 true 时:checkedCounter++;
  • 子复选框变为 false 时:checkedCounter--;
  • 直接利用 checkedCounter === total 和 checkedCounter === 0 进行 $O(1)$ 常数时间复杂度的状态判定,消除卡顿。

六、总结与开发自查清单

复选框的批量控制逻辑虽然基础,但它涵盖了 DOM 属性机制、三态视觉模型、双向事件流以及事件委托等核心前端知识点。完成编码后,可通过以下清单快速自查:

  • [ ] 是否直接使用了 checkbox.checked = true / false 而非 HTML 属性操作?
  • [ ] 主控复选框是否在部分选中时正确设置了 indeterminate = true?
  • [ ] 主控复选框在“全选”或“全不选”时,是否显式重置了 indeterminate = false?
  • [ ] 列表如果存在分页或动态新增项,是否采用了事件委托或者在数据更新后刷新了联动状态?
  • [ ] 监听的事件类型是否统一使用了 change 事件?

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章