萬盛學電腦網

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

jQuery 限制 Checkbox 可勾選數量:防止超選的實用技巧

在批量操作介面(如檔案管理、郵件選取、商品批量編輯)中,常需限制使用者最多只能勾選 N 個核取方塊。本文提供一個簡潔、可複用的 jQuery 解決方案,並說明關鍵邏輯與擴充建議。

核心邏輯

  1. 監聽所有目標 checkbox 的 click 事件
  2. 統計目前已勾選數量
  3. 若達上限:僅保留已勾選項可互動,其餘全部禁用
  4. 若未達上限:全部啟用

完整範例程式碼

<ul id="fileList">
  <li><input type="checkbox" name="apk[]" value="1"> APK1</li>
  <li><input type="checkbox" name="apk[]" value="2"> APK2</li>
  <li><input type="checkbox" name="apk[]" value="3"> APK3</li>
  <li><input type="checkbox" name="apk[]" value="4"> APK4</li>
  <li><input type="checkbox" name="apk[]" value="5"> APK5</li>
  <li><input type="checkbox" name="apk[]" value="6"> APK6</li>
  <li><input type="checkbox" name="apk[]" value="7"> APK7</li>
</ul>

<script>
$(function () {
  const MAX_SELECT = 3;                 // 最大可勾選數
  const $checkboxes = $('input[name="apk[]"]'); // 目標群組

  $checkboxes.on('change', function () {
    const checkedCount = $checkboxes.filter(':checked').length;

    if (checkedCount >= MAX_SELECT) {
      // 超過上限:未勾選者禁用,已勾選者保持啟用
      $checkboxes.not(':checked').prop('disabled', true);
    } else {
      // 未達上限:全部啟用
      $checkboxes.prop('disabled', false);
    }
  });
});
</script>

關鍵點解析

技巧說明
.prop('disabled', true/false)jQuery 1.6+ 建議用 prop() 而非 attr() 操作布林屬性
.filter(':checked')高效篩選已勾選元素,避免重複遍歷
.not(':checked')精準鎖定「未勾選」項目進行禁用
使用 change 而非 click相容鍵盤操作(Space 鍵)與程式觸發

進階擴充:封裝成可複用函式

/**
 * 限制 checkbox 群組最大勾選數
 * @param {string} selector - 目標 checkbox 選擇器(如 'input[name="apk[]"]')
 * @param {number} max - 最大可勾選數
 * @param {Function} [onLimitReached] - 達上限時的回呼(可選)
 */
function limitCheckboxSelection(selector, max, onLimitReached) {
  const $boxes = $(selector);
  $boxes.on('change', function () {
    const checked = $boxes.filter(':checked');
    if (checked.length >= max) {
      $boxes.not(':checked').prop('disabled', true);
      onLimitReached?.(checked.length, max);
    } else {
      $boxes.prop('disabled', false);
    }
  });
}

// 使用範例
limitCheckboxSelection('input[name="apk[]"]', 3, (cnt, max) => {
  console.warn(`已達上限 ${max},無法再勾選`);
});

無障礙與 UX 小建議

  • 搭配 title 或 aria-describedby 提示「最多可選 3 項」
  • 達上限時以 Toast 或訊息區塊明確告知使用者
  • 若需支援「全選」按鈕,請在全選邏輯中同步檢查上限

結語

以 change 事件搭配 prop('disabled') 控制可用狀態,是限制 Checkbox 勾選數量最穩健、相容性最佳的方案。將邏輯封裝為通用函式後,即可在專案中任意複用,並輕鬆擴充上限提示、統計面板等功能。

copyright © 萬盛學電腦網 all rights reserved