萬盛學電腦網

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

JavaScript 單獨獲取 Checkbox 選中狀態的正確姿勢

核心屬性:HTMLInputElement.checked

對於 <input type="checkbox">,只讀屬性 .checked 返回 true(選中)或 false(未選中),不受 value 屬性影響。

最簡示例

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>Checkbox 狀態檢測</title>
</head>
<body>
  <label><input type="checkbox" id="agree" value="1"> 我同意條款</label>
  <button onclick="checkStatus()">檢測狀態</button>

  <script>
    function checkStatus() {
      var cb = document.getElementById('agree');
      alert('選中狀態: ' + cb.checked); // true / false
      // 也可用 cb.checked ? '已勾選' : '未勾選'
    }
  </script>
</body>
</html>

常見錯誤與避坑

錯誤寫法問題正確寫法
cb.value返回字串 "1",無論是否勾選cb.checked
cb.getAttribute('checked')返回初始 HTML 屬性(靜態),不反映當前狀態cb.checked 或 cb.hasAttribute('checked')(僅初始)
$('#cb').attr('checked')jQuery < 1.6 返回屬性值,≥1.6 返回屬性/屬性混淆$('#cb').prop('checked') 或 $('#cb').is(':checked')
if (cb)DOM 元素永遠 truthyif (cb.checked)

jQuery 正確用法

// 1. 獲取狀態
var checked = $('#agree').prop('checked'); // 推薦:操作 property
var checked = $('#agree').is(':checked');  // 語意最清晰

// 2. 設置狀態
$('#agree').prop('checked', true);  // 勾選
$('#agree').prop('checked', false); // 取消

// 3. 切換
$('#agree').prop('checked', function(i, val) { return !val; });
// 或
$('#agree').click(); // 觸發點擊事件切換

表單提交時的值

  • 勾選時:提交 name=value(如 agree=1)。
  • 未勾選時:不提交該字段(後端收不到 agree 參數)。
  • 若需未勾選也提交值,用隱藏域配合:<input type="hidden" name="agree" value="0"><input type="checkbox" name="agree" value="1">(同名,勾選時覆蓋)。

批量操作示例

// 全選/反選
$('#check-all').on('change', function() {
  $('input[name="items"]').prop('checked', this.checked);
});

// 獲取所有選中的值
var values = $('input[name="items"]:checked').map(function() {
  return this.value;
}).get(); // ["1", "3", "5"]

總結

檢測單個 Checkbox 狀態:**原生用 .checked,jQuery 用 .prop('checked') 或 .is(':checked')**。切記區分「屬性 checked(初始狀態)」與「屬性 checked property(當前狀態)」,這是表單處理最基礎也最易踩的坑。

copyright © 萬盛學電腦網 all rights reserved