萬盛學電腦網

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

jQuery 實現複選框全選、反選、全不選功能完整範例

表單中「全選/反選/全不選」是經典需求。本文提供純 jQuery 實作,涵蓋事件綁定、狀態同步、效能優化與無障礙考量。

HTML 結構

<table id="data-table">
  <thead>
    <tr>
      <th><input type="checkbox" id="check-all"> 全選</th>
      <th>名稱</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><input type="checkbox" class="row-check" value="1"></td><td>項目 1</td></tr>
    <tr><td><input type="checkbox" class="row-check" value="2"></td><td>項目 2</td></tr>
    <tr><td><input type="checkbox" class="row-check" value="3"></td><td>項目 3</td></tr>
  </tbody>
</table>
<button type="button" id="btn-invert">反選</button>
<button type="button" id="btn-none">全不選</button>

jQuery 核心邏輯

(function($) {
  const $table = $('#data-table');
  const $checkAll = $('#check-all');
  const $rowChecks = $table.find('.row-check');
  const $btnInvert = $('#btn-invert');
  const $btnNone = $('#btn-none');

  // 1. 全選/取消全選
  $checkAll.on('change', function() {
    const checked = this.checked;
    $rowChecks.prop('checked', checked).trigger('change');
  });

  // 2. 反選
  $btnInvert.on('click', function() {
    $rowChecks.each(function() {
      this.checked = !this.checked;
    }).trigger('change');
  });

  // 3. 全不選
  $btnNone.on('click', function() {
    $rowChecks.prop('checked', false).trigger('change');
  });

  // 4. 子選項變更時同步「全選」狀態
  $rowChecks.on('change', function() {
    const total = $rowChecks.length;
    const checked = $rowChecks.filter(':checked').length;
    
    $checkAll.prop('checked', checked === total);
    $checkAll.prop('indeterminate', checked > 0 && checked < total);
  });

  // 5. 取得已選值(表單提交前)
  $('#submit-btn').on('click', function() {
    const selected = $rowChecks.filter(':checked').map(function() {
      return this.value;
    }).get();
    console.log('已選值:', selected); // ["1", "3"]
  });
})(jQuery);

關鍵 API 差異:.prop() vs .attr()

  • .prop('checked', true):設定**屬性**,影響 DOM 狀態,觸發 change 事件,為正確做法。
  • .attr('checked', 'checked'):設定**屬性值**,僅影響初始 HTML,不改變當前狀態,**不建議**用於動態切換。

效能優化:事件代理與批次操作

// 大量列表(>1000 行)建議使用事件代理
$table.on('change', '.row-check', function() {
  // 同步全選狀態邏輯...
});

// 批次更新 DOM 避免重繪
const checked = $checkAll.prop('checked');
$rowChecks.each(function() { this.checked = checked; });
// 單次觸發 change 事件
$rowChecks.trigger('change');

無障礙增強

  • indeterminate 狀態:視覺上顯示「部分選中」(水平線),螢幕閱讀器可識別。
  • 按鈕使用 <button type="button"> 避免表單提交。
  • 提供鍵盤操作提示:Space 切換、Tab 移動焦點。

Vanilla JS 替代方案(無 jQuery 專案)

const checkAll = document.getElementById('check-all');
const rowChecks = document.querySelectorAll('.row-check');

checkAll.addEventListener('change', () => {
  rowChecks.forEach(cb => cb.checked = checkAll.checked);
});

// 反選
document.getElementById('btn-invert').addEventListener('click', () => {
  rowChecks.forEach(cb => cb.checked = !cb.checked);
});

// 同步 indeterminate
function syncIndeterminate() {
  const checked = [...rowChecks].filter(cb => cb.checked).length;
  checkAll.indeterminate = checked > 0 && checked < rowChecks.length;
  checkAll.checked = checked === rowChecks.length;
}
rowChecks.forEach(cb => cb.addEventListener('change', syncIndeterminate));

掌握核心邏輯後,無論使用 jQuery 或原生 JS,都能輕鬆實作穩健的複選框互動。

copyright © 萬盛學電腦網 all rights reserved