萬盛學電腦網

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

jQuery attr 與 prop 核心差異深度解析:屬性 vs 特性的本質區別

一句話總結

HTML Attribute(屬性)初始化 DOM Property(特性),之後兩者獨立運作。操作實時狀態用 prop,操作初始 HTML 用 attr。

核心區別對照表

維度.prop().attr()
操作對象DOM Property(JS 對象屬性)HTML Attribute(標籤屬性)
返回類型原始類型(布爾、數字、對象)字符串 / null
布爾屬性返回 true/false返回 "屬性名" / undefined
同步性實時反映當前狀態多數情況不隨狀態變化
適用場景checked、selected、disabled、value、tabIndex自定義屬性、data-*、href、src(初始值)

實戰驗證代碼

<input id="chk" type="checkbox" checked>
<input id="txt" type="text" value="initial">
<a id="link" href="/page" data-id="123" custom-attr="test">Link</a>

<script>
// Checkbox
console.log($('#chk').prop('checked')); // true(實時狀態)
console.log($('#chk').attr('checked')); // "checked"(初始 HTML)
$('#chk').prop('checked', false);
console.log($('#chk').prop('checked')); // false
console.log($('#chk').attr('checked')); // "checked" 依然是初始值!

// Text Input
console.log($('#txt').prop('value')); // "initial" → 用戶輸入後變為新值
console.log($('#txt').attr('value')); // "initial" 始終不變

// Link
console.log($('#link').prop('href'));  // 完整絕對 URL "https://domain.com/page"
console.log($('#link').attr('href'));  // 原始值 "/page"
console.log($('#link').data('id'));    // 123(數字,自動轉類型)
console.log($('#link').attr('data-id')) // "123"(字符串)
console.log($('#link').attr('custom-attr')) // "test"
console.log($('#link').prop('custom-attr')) // undefined

版本演進關鍵節點

  • jQuery 1.6:引入 .prop(),嘗試修復混亂,但破壞向後兼容
  • jQuery 1.6.1:緊急修復,恢復部分 .attr() 舊行為
  • jQuery 1.9+:徹底分離,.attr() 不再處理布爾屬性
  • jQuery 3.0+:移除舊兼容代碼,性能提升

最佳實踐清單

// ✅ 正確
$('input').prop('checked', true);
$('option').prop('selected', true);
$('input').prop('disabled', false);
$('input').val('new value'); // 專用方法,內部用 prop
$('#elem').data('key', {obj: 1}); // 數據綁定,非 attr/prop

// ❌ 錯誤
$('input').attr('checked', 'checked');
$('input').attr('checked', true);
$('#elem').attr('data-key', 'value'); // 應用 .data()

// 🎯 灰色地帶:href/src
// 獲取完整 URL 用 .prop('href') / .prop('src')
// 獲取原始 HTML 值用 .attr('href') / .attr('src')
// 設置建議用 .attr(),瀏覽器會同步更新 property

底層原理:DOM Level 2 規範

  • Attribute:element.attributes 名稱節點映射,序列化 HTML 時輸出
  • Property:element.propertyName,JS 引擎內部表示,渲染引擎讀取此值
  • 同步規則:標準屬性雙向同步(id、title、class、href、src...),自定義屬性單向(Attribute → Property 初始化)
copyright © 萬盛學電腦網 all rights reserved