在批量操作介面(如檔案管理、郵件選取、商品批量編輯)中,常需限制使用者最多只能勾選 N 個核取方塊。本文提供一個簡潔、可複用的 jQuery 解決方案,並說明關鍵邏輯與擴充建議。
click 事件<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},無法再勾選`);
});
title 或 aria-describedby 提示「最多可選 3 項」以 change 事件搭配 prop('disabled') 控制可用狀態,是限制 Checkbox 勾選數量最穩健、相容性最佳的方案。將邏輯封裝為通用函式後,即可在專案中任意複用,並輕鬆擴充上限提示、統計面板等功能。