attr() vs prop():核心區別
| 特性 | .attr() | .prop() |
| 操作對象 | HTML 屬性 | DOM 屬性 |
| 布林屬性 | 回傳字串或 undefined | 回傳 true/false |
| 適用場景 | 自定義屬性、href、src、id、name | checked、disabled、selected、value、hidden |
| 版本建議 | jQuery 1.6+ 區分明確 | jQuery 1.6+ 引入 |
基本用法:設定單一屬性
// 設定 href
$('button').click(function() {
$('#keleyi').attr('href', 'https://www.jb51.net');
});
批量設定多個屬性
$('button').click(function() {
$('#keleyi').attr({
'href': 'https://www.jb51.net',
'title': '柯樂義網',
'target': '_blank'
});
});
回調函數:基於舊值計算新值
// 在原 href 後附加路徑
$('button').click(function() {
$('#keleyi').attr('href', function(i, origValue) {
return origValue + '/jquery';
});
});
關鍵場景:布林屬性必須用 prop()
<input id="chk" type="checkbox">
<input id="btn" type="button" disabled>
<div id="box" hidden>內容</div>
// ❌ 錯誤:attr 設定布林屬性
$('#chk').attr('checked', true); // 可能不生效
$('#btn').attr('disabled', false); // 不生效
$('#box').attr('hidden', false); // 不生效
// ✅ 正確:prop 設定布林屬性
$('#chk').prop('checked', true); // 勾選
$('#btn').prop('disabled', false); // 啟用
$('#box').prop('hidden', false); // 顯示
// 讀取狀態
var isChecked = $('#chk').prop('checked'); // true/false
var isDisabled = $('#btn').prop('disabled'); // true/false
移除屬性
// 移除 HTML 屬性
$('#element').removeAttr('data-custom');
// 移除 DOM 屬性(罕用)
$('#element').removeProp('customProp'); // 謹慎使用,可能導致不可逆
實戰:表單編輯狀態切換
function toggleEditMode($form, editable) {
$form.find('input, select, textarea').each(function() {
var $el = $(this);
if (editable) {
$el.prop('disabled', false).removeAttr('readonly');
} else {
$el.prop('disabled', true).attr('readonly', 'readonly');
}
});
}
// 使用
$('#editBtn').click(function() { toggleEditMode('#myForm', true); });
$('#viewBtn').click(function() { toggleEditMode('#myForm', false); });
HTML5 data-* 屬性:建議用 .data()
<div id="user" data-id="123" data-role="admin"></div>
// ✅ 推薦:.data() 自動轉型、快取
var id = $('#user').data('id'); // 123 (number)
var role = $('#user').data('role'); // 'admin'
// ⚠️ .attr() 總是回傳字串
var idStr = $('#user').attr('data-id'); // '123' (string)
// 寫入
$('#user').data('lastLogin', Date.now()); // 寫入快取,不更新 DOM
$('#user').attr('data-last-login', Date.now()); // 寫入 DOM 屬性
總結
- href、src、id、name、data-*(讀取)、自定義屬性 →
.attr()
- checked、disabled、selected、hidden、value、readonly、tabIndex →
.prop()
- data-* 寫入/讀取 →
.data()(快取、自動轉型)
- 批量設定用物件語法
.attr({...}),動態計算用回調函數