核心選擇器
// 所有同名 checkbox
$("input[name='fruit']")
// 已勾選者
$("input[name='fruit']:checked")
// 未勾選者
$("input[name='fruit']:not(:checked)")
獲取勾選值(陣列)
// jQuery map + get
const values = $("input[name='fruit']:checked").map((i, el) => el.value).get();
// 原生
const valuesNative = [...document.querySelectorAll("input[name='fruit']:checked")].map(el => el.value);
批次操作封裝
const CheckboxGroup = {
// 選擇器上下文
_sel: "input[name='fruit']",
getChecked() {
return $(this._sel).filter(":checked");
},
getValues() {
return this.getChecked().map((i, el) => el.value).get();
},
// 全選
checkAll() {
$(this._sel).prop("checked", true);
},
// 取消全選
uncheckAll() {
$(this._sel).prop("checked", false);
},
// 奇數項(索引 0,2,4... 即第 1,3,5 項)
checkOdd() {
$(this._sel).filter(":even").prop("checked", true); // :even = 0-based even index
},
// 偶數項
checkEven() {
$(this._sel).filter(":odd").prop("checked", true);
},
// 反選
invert() {
$(this._sel).prop("checked", (i, v) => !v);
},
// 獲取勾選項的完整資料
getCheckedData() {
return this.getChecked().map((i, el) => ({
value: el.value,
text: $(el).next("label").text().trim(), // 假設緊鄰 label
element: el
})).get();
}
};
完整互動 Demo
<div style="border:1px solid #999; padding:15px; max-width:500px; margin:50px auto; font-size:14px;">
<button id="btnAll">全選</button>
<button id="btnNone">取消全選</button>
<button id="btnOdd">選中奇數項</button>
<button id="btnInvert">反選</button>
<button id="btnGet">獲取選中值</button>
<br><br>
<label><input type="checkbox" name="fruit" value="apple"> 蘋果</label>
<label><input type="checkbox" name="fruit" value="banana"> 香蕉</label>
<label><input type="checkbox" name="fruit" value="orange"> 橘子</label>
<label><input type="checkbox" name="fruit" value="grape"> 葡萄</label>
<label><input type="checkbox" name="fruit" value="pear"> 梨子</label>
<label><input type="checkbox" name="fruit" value="mango"> 芒果</label>
</div>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script>
const $ = jQuery;
const sel = "input[name='fruit']";
$("#btnAll").click(() => $(sel).prop("checked", true));
$("#btnNone").click(() => $(sel).prop("checked", false));
$("#btnOdd").click(() => $(sel).filter(":even").prop("checked", true));
$("#btnInvert").click(() => $(sel).prop("checked", (i, v) => !v));
$("#btnGet").click(() => {
const vals = $(sel).filter(":checked").map((i, el) => el.value).get();
alert(vals.length ? "選中:" + vals.join(", ") : "未選擇任何項目");
});
</script>
原生 JS 版(零依賴、效能最佳)
const checkboxes = document.querySelectorAll("input[name='fruit']");
const byId = id => document.getElementById(id);
byId("btnAll").onclick = () => checkboxes.forEach(cb => cb.checked = true);
byId("btnNone").onclick = () => checkboxes.forEach(cb => cb.checked = false);
byId("btnOdd").onclick = () => [...checkboxes].filter((_, i) => i % 2 === 0).forEach(cb => cb.checked = true);
byId("btnInvert").onclick = () => checkboxes.forEach(cb => cb.checked = !cb.checked);
byId("btnGet").onclick = () => {
const vals = [...checkboxes].filter(cb => cb.checked).map(cb => cb.value);
alert(vals.length ? "選中:" + vals.join(", ") : "未選擇任何項目");
};
避坑提醒
- 用
prop() 而非 attr() 設定/讀取 checked(詳見文章 70294)。
:even/:odd 是 **0-based 索引**(:even = 第 1、3、5 項),非直觀的「奇數/偶數」項。
- 動態新增 checkbox 後,事件委派:
$(document).on("change", "input[name='fruit']", handler)。