基礎 HTML 結構
<input type="checkbox" name="test" value="0"> 0
<input type="checkbox" name="test" value="1"> 1
<input type="checkbox" name="test" value="2"> 2
<!-- ... -->
<input type="button" id="btnGet" value="獲取選中值" />
核心方法對比
方法 1:原生 JS 遍歷(無依賴)
function chk() {
var objs = document.getElementsByName('test');
var vals = [];
for (var i = 0; i < objs.length; i++) {
if (objs[i].checked) vals.push(objs[i].value);
}
alert(vals.length ? vals.join(',') : '未選擇任何項');
}
方法 2:jQuery 選擇器 + each(推薦)
function jqchk() {
var vals = [];
$('input[name="test"]:checked').each(function() {
vals.push($(this).val());
});
alert(vals.length ? vals.join(',') : '未選擇任何項');
}
方法 3:map() 一行流(現代寫法)
var vals = $('input[name="test"]:checked').map(function() {
return this.value;
}).get(); // ["1", "3", "5"]
常用操作封裝
$(document).ready(function() {
// 全選
$("#btnAll").click(function() {
$("[name='items']").prop("checked", true);
});
// 取消全選
$("#btnNone").click(function() {
$("[name='items']").prop("checked", false);
});
// 奇數項(索引 0,2,4... 即第 1、3、5 項)
$("#btnOdd").click(function() {
$("[name='items']:even").prop("checked", true);
});
// 反選
$("#btnToggle").click(function() {
$("[name='items']").each(function() {
$(this).prop("checked", !$(this).prop("checked"));
});
});
// 獲取所有選中值
$("#btnGetVals").click(function() {
var vals = $("[name='items']:checked").map(function() {
return this.value;
}).get();
console.log(vals); // 陣列
alert(vals.join("\n"));
});
});
完整可運行 Demo
<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>Checkbox 操作演示</title>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<style>
.panel {border:1px solid #999; width:500px; padding:15px; background:#f9f9f9; margin:50px auto;}
button {margin-right: 10px; padding: 5px 10px;}
</style></head><body>
<div class="panel">
<button id="btnAll">全選</button>
<button id="btnNone">取消全選</button>
<button id="btnOdd">選中奇數項</button>
<button id="btnToggle">反選</button>
<button id="btnGetVals">獲取選中值</button>
<br><br>
<label><input type="checkbox" name="items" value="item1"> 項目 1</label>
<label><input type="checkbox" name="items" value="item2"> 項目 2</label>
<label><input type="checkbox" name="items" value="item3"> 項目 3</label>
<label><input type="checkbox" name="items" value="item4"> 項目 4</label>
<label><input type="checkbox" name="items" value="item5"> 項目 5</label>
<label><input type="checkbox" name="items" value="item6"> 項目 6</label>
</div>
<script>/* 上述 JS 代碼 */</script>
</body></html>
最佳實踐提醒
- ✅ 統一使用
.prop("checked") 而非 .attr("checked") (jQuery 1.6+)
- ✅ 使用
:checked 偽類選擇器,語義清晰且性能好
- ✅ 批量操作用
.prop() 直接設置,無需 each 循環
- ✅ 獲取值用
.map().get() 直接得陣列,代碼簡潔