萬盛學電腦網

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

JavaScript 實現 Checkbox 全選、反選與值收集完整方案

常見場景

後台管理系統的列表頁常需提供「全選/取消全選」、「單選聯動全選狀態」、「獲取所有已選項目的 ID」功能。

現代化實作(ES6 + 原生 DOM API)

<!-- HTML 結構 -->
<table id="data-table">
  <thead>
    <tr>
      <th><input type="checkbox" id="select-all"></th>
      <th>名稱</th>
      <th>狀態</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><input type="checkbox" class="row-checkbox" value="1"></td><td>項目 A</td><td>啟用</td></tr>
    <tr><td><input type="checkbox" class="row-checkbox" value="2"></td><td>項目 B</td><td>停用</td></tr>
    <tr><td><input type="checkbox" class="row-checkbox" value="3"></td><td>項目 C</td><td>啟用</td></tr>
  </tbody>
</table>
<button id="get-selected">獲取已選 ID</button>
<pre id="output"></pre>
<script>
(() => {
  const selectAll = document.getElementById('select-all');
  const rowCheckboxes = document.querySelectorAll('.row-checkbox');
  const getSelectedBtn = document.getElementById('get-selected');
  const output = document.getElementById('output');

  // 用 Set 儲存已選 value,自動去重、O(1) 查找
  const selectedValues = new Set();

  // 更新全選框狀態
  function updateSelectAllState() {
    const checkedCount = document.querySelectorAll('.row-checkbox:checked').length;
    selectAll.checked = checkedCount === rowCheckboxes.length && checkedCount > 0;
    selectAll.indeterminate = checkedCount > 0 && checkedCount < rowCheckboxes.length;
  }

  // 同步 Set
  function syncSet(checkbox) {
    if (checkbox.checked) selectedValues.add(checkbox.value);
    else selectedValues.delete(checkbox.value);
  }

  // 全選/取消全選
  selectAll.addEventListener('change', () => {
    rowCheckboxes.forEach(cb => {
      cb.checked = selectAll.checked;
      syncSet(cb);
    });
    updateSelectAllState();
  });

  // 單選聯動
  rowCheckboxes.forEach(cb => {
    cb.addEventListener('change', () => {
      syncSet(cb);
      updateSelectAllState();
    });
  });

  // 獲取已選 ID
  getSelectedBtn.addEventListener('click', () => {
    output.textContent = JSON.stringify([...selectedValues], null, 2);
  });

  // 初始化
  updateSelectAllState();
})();
</script>

核心邏輯解析

  1. Set 資料結構:自動去重,add/delete/has 皆為 O(1),比陣列 indexOf/splice 高效。
  2. indeterminate 屬性:原生支援「半選」狀態(部分選中),UX 更佳。
  3. 事件委派替代方案:若列表動態渲染,可在 `` 掛載單一 `change` 事件,判斷 `e.target.matches('.row-checkbox')`。
  4. value 屬性:直接儲存業務 ID(字串或數字),避免額外 `data-*` 屬性。

jQuery 版本(兼容舊專案)

$('#select-all').on('change', function () {
  $('.row-checkbox').prop('checked', this.checked).trigger('change');
});

$('.row-checkbox').on('change', function () {
  const $checkboxes = $('.row-checkbox');
  $('#select-all').prop({
    checked: $checkboxes.filter(':checked').length === $checkboxes.length,
    indeterminate: $checkboxes.filter(':checked').length > 0 && $checkboxes.filter(':checked').length < $checkboxes.length
  });
});

$('#get-selected').on('click', function () {
  const ids = $('.row-checkbox:checked').map(function () { return this.value; }).get();
  console.log(ids);
});

避坑指南

  • 不要使用 `` 靜態屬性,動態操作請用 `.prop('checked', true)` / `.checked = true`。
  • 大量資料(>1000 行)時,考慮虛擬滾動或分頁,避免一次渲染過多 Checkbox 導致效能問題。
  • 後端驗證:前端全選僅為輔助,刪除/批量操作 API 必須再次驗證權限與資料完整性。
copyright © 萬盛學電腦網 all rights reserved