萬盛學電腦網

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

jQuery `attr()` 方法完整指南:屬性 vs 屬性、佈爾屬性、數據屬性與常見誤區

核心區別:Attribute (屬性) vs Property (屬性/特性)

概念Attribute (HTML 屬性)Property (DOM 屬性)
定義位置HTML 標籤上寫死DOM 節點物件上
修改方式`setAttribute` / `.attr()`直接賦值 `el.prop = val` / `.prop()`
同步關係初始化時同步,後續**不同步**即時生效,不影響 attribute
典型例子`id`、`class`、`src`、`href`、`data-*`、`value`(初始)`checked`、`selected`、`disabled`、`value`(當前)、`href`(解析後絕對路徑)

`.attr()` vs `.prop()` 選擇指南

// ✅ 使用 .attr() 的場景
$('img').attr('src', 'new.jpg');        // HTML 屬性
$('a').attr('href', '/about');          // HTML 屬性
$('div').attr('data-id', 123);          // data-* 自定義屬性
$('input').attr('value', 'initial');    // 初始值 (attribute)

// ✅ 使用 .prop() 的場景 (jQuery 1.6+)
$('input:checkbox').prop('checked', true);   // 動態狀態
$('option').prop('selected', true);          // 動態狀態
$('input').prop('disabled', false);          // 動態狀態
$('input').prop('value', 'current');         // 當前輸入值
$('a').prop('href');                         // 解析後絕對 URL

// ❌ 常見錯誤
$('input:checkbox').attr('checked', true);   // 僅設初始屬性,不改變視覺狀態!
$('#chk').attr('checked'); // 返回 "checked" 字串,非 boolean

佈爾屬性特殊行為

<input type="checkbox" checked>           // 有屬性 = true
<input type="checkbox">                  // 無屬性 = false

// .attr() 返回值
$(':checkbox').attr('checked'); // "checked" | undefined (字串或 undefined)

// .prop() 返回值
$(':checkbox').prop('checked'); // true | false (標準 boolean)

// 設置
$(':checkbox').prop('checked', true);  // ✅ 勾選
$(':checkbox').attr('checked', 'checked'); // ✅ 也可,但語意屬於 attribute
$(':checkbox').removeAttr('checked');  // ✅ 取消勾選 (移除 attribute)
$(':checkbox').prop('checked', false); // ✅ 取消勾選 (設 property)

數據屬性 `data-*`:`.data()` vs `.attr('data-*')`

方法讀取寫入快取類型轉換
`.data(key)`優先讀快取 → 再讀 attribute → 自動轉型 (JSON、Number、Boolean)只寫快取,**不更新 DOM**✅ 內部快取✅ 智能轉換
`.attr('data-key')`直接讀 DOM attribute直接寫 DOM attribute❌ 無快取❌ 永遠字串
<div data-id="123" data-active="true" data-user='{"name":"Bob"}'></div>

$div.data('id');      // 123 (Number)
$div.data('active');  // true (Boolean)
$div.data('user');    // {name: "Bob"} (Object)
$div.attr('data-id'); // "123" (String)

$div.data('newKey', 456); // 僅快取,DOM 無 data-new-key
$div.attr('data-new-key', '456'); // 寫入 DOM,下次 .data() 會讀到

表單值:`.val()` 才是正途

// ❌ 錯誤
$('input').attr('value', 'new'); // 只改 initial value,畫面不變
$('input').prop('value', 'new'); // 雖可行但語意不清

// ✅ 正確
$('input, select, textarea').val('new'); // 統一處理所有表單控件
$('#multiSelect').val(['a', 'b']);       // 多選

效能與最佳實踐

  • **批量讀寫**:同 `.css()`,避免迴圈中交替 `.attr()` 讀寫觸發重排。
  • **事件委託中**:`e.target.getAttribute('data-id')` 比 `$(e.target).data('id')` 快 10 倍以上(無 jQuery 封裝開銷)。
  • **SVG 元素**:必須用 `.attr()`,`.prop()` 在 SVG 元素上行為不一致。
  • **自定義屬性前綴**:HTML5 規範要求 `data-*`,亂用 `my-attr` 會導致驗證失敗、SSR 脫水不一致。

原生替代方案

// 獲取 attribute
el.getAttribute('data-id');           // String | null
el.hasAttribute('disabled');          // Boolean

// 設置 attribute
el.setAttribute('data-id', '123');
el.removeAttribute('data-id');

// 獲取/設置 property (布爾屬性、value、checked、selected)
el.checked = true;
el.value = 'text';
el.disabled = false;

// dataset (data-* 專用,自動駝峰轉換)
el.dataset.id;           // "123"
el.dataset.userName;     // data-user-name
el.dataset.newKey = 456; // 寫入 data-new-key="456" (字串化)

結語

**Attribute ≠ Property**。牢記:`checked`/`selected`/`disabled`/`value(當前)` 用 `.prop()`/`val()`;`src`/`href`/`data-*`/`class`/`id` 用 `.attr()`;需同步 DOM 給 CSS/SEO 選擇器用 `.attr()`,純邏輯狀態用 `.prop()`/`.data()`。現代原生 `dataset`、`classList`、`el.prop` 已足夠優雅,新代碼優先原生。

copyright © 萬盛學電腦網 all rights reserved