萬盛學電腦網

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

jQuery Checkbox 全選 Bug:attr() vs prop() 深度解析與正確用法

問題現象

使用 .attr('checked', true/false) 控制 checkbox 勾選時,第一次生效,第二次失效。

錯誤代碼

$('#checkAll').click(function() {
  if ($(this).is(':checked')) {
    $('[name="items"]:checkbox').attr('checked', true);  // 錯誤
  } else {
    $('[name="items"]:checkbox').attr('checked', false); // 錯誤
  }
});

正確代碼:使用 .prop()

$('#checkAll').click(function() {
  var checked = $(this).prop('checked'); // 讀取屬性也用 prop
  $('[name="items"]:checkbox').prop('checked', checked);
});

核心區別:Attribute vs Property

概念Attribute (屬性)Property (屬性/特性)
定義HTML 標籤上寫死的初始值DOM 對象在內存中實時的狀態值
獲取方式.attr().prop()
checkbox 勾選狀態checked="checked"(初始值).checked = true/false(實時狀態)
動態改變後不變跟隨用戶操作實時變化

為什麼 attr() 會失效?

  1. 頁面加載時,瀏覽器解析 HTML,將 checked="checked" 存為 Attribute(默認值)。
  2. 用戶點擊 checkbox,瀏覽器更新 DOM 對象的 Property .checked = true,Attribute **不變**。
  3. 代碼執行 .attr('checked', true):jQuery 1.6+ 會設置 Attribute,但瀏覽器渲染勾選狀態**只看 Property**。
  4. 第二次點擊「全選」按鈕,Attribute 已經是 checked="checked",再次設置無效果,Property 也不會同步更新 → 視覺上失效。

jQuery 版本演進

  • 1.5.2 及之前:.attr() 同時處理 Attribute 和 Property,有 bug 但「湊巧」能改動 Property。
  • 1.6.0:嚴格分離,.attr() 只操作 Attribute,.prop() 操作 Property。導致大量舊代碼失效。
  • 1.6.1+:為兼容性,.attr('checked', true) 內部自動轉調 .prop('checked', true),**但不建議依賴此行為**。

必須用 .prop() 的屬性清單

// Boolean 屬性(狀態型)
checked, selected, disabled, readonly, 
multiple, hidden, required, open, 
autofocus, autoplay, async, controls, defer, loop, scoped

// 非 Boolean 但屬於 Property
value, selectedIndex, nodeName, nodeType, 
defaultValue, defaultChecked, tagName, 
location, readyState (window/document)

最佳實踐建議

  1. 統一使用 .prop() 獲取/設置 checkbox、radio、select、disabled 等狀態屬性。
  2. 只在操作**自定義 HTML 屬性**(如 data-id, title, href, src)時使用 .attr()。
  3. 讀取 checkbox 狀態:$(this).prop('checked') 或 this.checked(原生最快)。
  4. 表單提交前序列化:$('form').serialize() 內部正確讀取 Property,無需手動干預。

擴展:純 CSS 實現全選(無 JS)

<style>
  #master:checked ~ .list input[type="checkbox"] { 
    /* 無法用 CSS 改變 checked 狀態,僅能樣式聯動 */
  }
</style>

⚠️ CSS 無法修改 DOM Property,真正的全選仍需 JS。

copyright © 萬盛學電腦網 all rights reserved