萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript Checkbox 全選/反選/全不選:原生與 jQuery 多種實現

核心需求

  • 全選:勾選所有同名 checkbox
  • 全不選:取消勾選所有
  • 反選:勾選變不勾選、不勾選變勾選
  • 子選項變化時自動更新全選框狀態

原生 JS 實現(無依賴)

// 通用工具函數
function getCheckboxes(name) {
  return Array.from(document.getElementsByName(name)).filter(el => el.type === 'checkbox');
}

function setAll(name, checked) {
  getCheckboxes(name).forEach(cb => cb.checked = checked);
}

function toggleAll(name) {
  getCheckboxes(name).forEach(cb => cb.checked = !cb.checked);
}

// 綁定全選框聯動
function bindSelectAll(selectAllSelector, itemName) {
  var $selectAll = document.querySelector(selectAllSelector);
  var $items = getCheckboxes(itemName);

  $selectAll.addEventListener('change', function() {
    setAll(itemName, this.checked);
  });

  $items.forEach(cb => cb.addEventListener('change', function() {
    var checkedCount = $items.filter(c => c.checked).length;
    $selectAll.checked = checkedCount === $items.length;
    $selectAll.indeterminate = checkedCount > 0 && checkedCount < $items.length; // 三態
  }));
}

// 使用
bindSelectAll('#selectAll', 'goods');

jQuery 簡潔版

// 全選/取消
$('#selectAll').on('change', function() {
  $('input[name="goods"]').prop('checked', this.checked);
});

// 子項變化更新全選框(含半選狀態)
$('input[name="goods"]').on('change', function() {
  var $items = $('input[name="goods"]');
  var $checked = $items.filter(':checked');
  $('#selectAll').prop({
    checked: $checked.length === $items.length,
    indeterminate: $checked.length > 0 && $checked.length < $items.length
  });
});

// 反選按鈕
$('#invertSelect').click(function() {
  $('input[name="goods"]').each(function() { this.checked = !this.checked; }).trigger('change');
});

HTML 結構示例

<table id="goodsTable">
  <thead>
    <tr><th><input type="checkbox" id="selectAll"> 全選</th><th>商品</th></tr>
  </thead>
  <tbody>
    <tr><td><input type="checkbox" name="goods" value="1"></td><td>商品 A</td></tr>
    <tr><td><input type="checkbox" name="goods" value="2"></td><td>商品 B</td></tr>
    <tr><td><input type="checkbox" name="goods" value="3"></td><td>商品 C</td></tr>
  </tbody>
</table>
<button id="invertSelect">反選</button>
<button onclick="setAll('goods', true)">全選</button>
<button onclick="setAll('goods', false)">全不選</button>

進階場景:分頁表格的跨頁全選

若表格分頁,前端只持有當前頁數據,需後端配合:

  1. 全選框改為三態:indeterminate 表示「當前頁全選但非全部數據」
  2. 點擊全選時:若非 indeterminate → 當前頁全選;若 indeterminate → 發送 selectAll=true 參數給後端,後端返回所有 ID 或標記會話
  3. 刪除/導出等操作:根據前端勾選 ID + 後端標記的「全選會話」確定操作範圍

無障礙與體驗優化

  • 全選框添加 aria-label="全選所有商品"
  • 行點擊(非 checkbox 區域)也可切換勾選:tbody tr 綁定 click 切換首個 checkbox
  • Shift+點擊實現範圍選中(類文件管理器)

總結

Checkbox 全選看似簡單,但「三態同步、分頁跨頁、範圍選中、無障礙」等細節決定體驗質量。原生 JS 版零依賴、體積極小;jQuery 版代碼更簡潔。建議封裝為 CheckboxGroup 組件,統一管理狀態與事件。

copyright © 萬盛學電腦網 all rights reserved