核心區別: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` 已足夠優雅,新代碼優先原生。