萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML 腳本教學

JavaScript 實現複選框全選/取消全選:三種模式完整範例

批量操作資料時,「全選/取消全選」是高頻需求。本文提供三種實作模式:原生 JS 邏輯、現代 ES6 簡潔寫法、不可變資料流模式(適合 Vue/React),並解決「全選狀態同步」難題。

核心邏輯:三種狀態

  • 全選:所有子項 `checked = true`,全選框 `checked = true`、indeterminate = false。
  • 全不選:所有子項 `checked = false`,全選框 `checked = false`、indeterminate = false。
  • 部分選:子項混合,全選框 `checked = false`、indeterminate = true(顯示為橫槓/半選狀態)。

模式一:原生 JS 經典寫法(兼容 IE)

<form id="batchForm">
  <label><input type="checkbox" id="selectAll"> 全選/取消</label>
  <fieldset id="items">
    <label><input type="checkbox" name="ids" value="1"> 項目 1</label>
    <label><input type="checkbox" name="ids" value="2"> 項目 2</label>
    <label><input type="checkbox" name="ids" value="3"> 項目 3</label>
  </fieldset>
</form>

<script>
const form = document.getElementById('batchForm');
const selectAll = document.getElementById('selectAll');
const items = form.querySelectorAll('input[name="ids"]');

// 1. 點擊全選框 → 切換所有子項
selectAll.onclick = () => {
  const checked = selectAll.checked;
  items.forEach(cb => cb.checked = checked);
  selectAll.indeterminate = false;
};

// 2. 點擊子項 → 更新全選框狀態
items.forEach(cb => {
  cb.onchange = () => {
    const checkedCount = [...items].filter(c => c.checked).length;
    selectAll.checked = checkedCount === items.length;
    selectAll.indeterminate = checkedCount > 0 && checkedCount < items.length;
  };
});
</script>

模式二:ES6 現代寫法(箭頭函數、解構、Class)

class CheckboxGroup {
  constructor(selectAllSel, itemSel) {
    this.selectAll = document.querySelector(selectAllSel);
    this.items = [...document.querySelectorAll(itemSel)];
    this.bind();
  }
  bind() {
    this.selectAll.addEventListener('click', () => this.toggleAll());
    this.items.forEach(cb => cb.addEventListener('change', () => this.sync()));
  }
  toggleAll() {
    const checked = this.selectAll.checked;
    this.items.forEach(cb => cb.checked = checked);
    this.selectAll.indeterminate = false;
  }
  sync() {
    const checked = this.items.filter(cb => cb.checked);
    this.selectAll.checked = checked.length === this.items.length;
    this.selectAll.indeterminate = checked.length > 0 && checked.length < this.items.length;
  }
  getSelectedValues() {
    return this.items.filter(cb => cb.checked).map(cb => cb.value);
  }
}

// 使用
const group = new CheckboxGroup('#selectAll', 'input[name="ids"]');
// 取得勾選值:group.getSelectedValues()

模式三:資料驅動模式(Vue 3 Composition API 範例)

<script setup>
import { ref, computed } from 'vue';

const allItems = ref([
  { id: 1, label: '專案 Alpha' },
  { id: 2, label: '專案 Beta' },
  { id: 3, label: '專案 Gamma' },
]);
const selectedIds = ref([]);

// 計算屬性自動同步 indeterminate
const isAllSelected = computed(() => selectedIds.value.length === allItems.value.length);
const isIndeterminate = computed(() => selectedIds.value.length > 0 && !isAllSelected.value);

function toggleAll() {
  if (isAllSelected.value) {
    selectedIds.value = [];
  } else {
    selectedIds.value = allItems.value.map(i => i.id);
  }
}

function submit() {
  console.log('提交 IDs:', selectedIds.value);
}
</script>

<template>
  <label>
    <input type="checkbox" v-model="selectedIds" :value="item.id" v-for="item in allItems" :key="item.id">
    {{ item.label }}
  </label>
  <label>
    <input type="checkbox" :checked="isAllSelected" :indeterminate="isIndeterminate" @change="toggleAll">
    全選
  </label>
  <button @click="submit">批量處理</button>
</template>

進階技巧

  • 大量資料虛擬化:只渲染可視區,全選需配合資料層邏輯(如「全選 = 選中所有 ID」,不實際渲染所有 checkbox)。
  • Shift 範圍選取:記住 `lastCheckedIndex`,按 Shift + Click 時自動勾選範圍內項目。
  • 無障礙:`

常見錯誤

  1. 用 `getElementsByName` 回傳即時集合,迴圈中修改 `length` 導致索引錯位 → 改用 `[...nodes]` 或 `Array.from()` 轉陣列。
  2. 忘記同步 `indeterminate`,導致部分選時全選框顯示未勾選,使用者困惑。
  3. 表單提交前未檢查 `disabled` 狀態,導致伺服端收到空值。

掌握狀態同步邏輯,全選功能就能既簡潔又健壯。

copyright © 萬盛學電腦網 all rights reserved