核心 API 對照表
| 方法 | 用途 | 參數形式 | 返回值 | 關鍵特性 |
.attr(name) | 讀取屬性值 | 字串 | 字串 / undefined | 只讀取集合中第一個元素 |
.attr(name, value) | 設置單一屬性 | 字串, 字串/數值/函數 | jQuery 物件 (鏈式) | 值為函數時接收 (index, 當前值) |
.attr(object) | 批量設置 (JSON) | 物件 {key: value} | jQuery 物件 | 一次設置多個屬性,效能更好 |
.removeAttr(name) | 移除屬性 | 字串 (可空格分隔多個) | jQuery 物件 | 移除 HTML 屬性及對應 DOM property |
.prop() | 操作 DOM Property | 同上 | 同上 | 布林屬性必用 prop (checked, disabled, selected...) |
完整互動範例
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>jQuery attr/removeAttr 示範</title>
<style>
.container { max-width: 600px; margin: 40px auto; padding: 20px; font-family: sans-serif; }
.box { width: 200px; height: 80px; border: 2px solid #ddd; border-radius: 8px; margin: 10px auto; display: flex; align-items: center; justify-content: center; font-family: monospace; font-size: 13px; transition: all 0.2s; }
.controls { display: flex; gap: 10px; justify-content: center; flex-wrap: wrap; margin: 20px 0; }
button { padding: 8px 16px; background: #1976d2; color: white; border: none; border-radius: 4px; cursor: pointer; }
button.secondary { background: #757575; }
button.danger { background: #e53935; }
.log { background: #263238; color: #aed581; padding: 12px; border-radius: 4px; font-family: monospace; font-size: 13px; white-space: pre-wrap; min-height: 80px; }
</style>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
<div class="container">
<h2 style="text-align:center;">attr() / removeAttr() 互動示範</h2>
<div id="div1" class="box">div1 - 無屬性</div>
<div id="div2" class="box">div2 - 無屬性</div>
<div class="controls">
<button id="btnSetSingle">1. 單個設置 attr('data-x', 'val')</button>
<button id="btnSetJson">2. JSON 批量設置 attr({...})</button>
<button id="btnGetAttr" class="secondary">3. 讀取第一個元素屬性</button>
<button id="btnRemove" class="danger">4. 移除 div2 的 data-age</button>
<button id="btnClear" class="secondary">清除日誌</button>
</div>
<div class="log" id="log">操作日誌...</div>
</div>
<script>
$(function() {
const $divs = $('div.box');
const $log = $('#log');
const log = (msg) => $log.prepend(`[${new Date().toLocaleTimeString()}] ${msg}\n`);
// 1. 單個設置
$('#btnSetSingle').on('click', () => {
$divs.eq(0).attr('data-role', 'admin').attr('data-level', 99);
$divs.eq(1).attr('data-role', 'user').attr('data-level', 1);
log('已單個設置 data-role, data-level');
});
// 2. JSON 批量設置 (推薦)
$('#btnSetJson').on('click', () => {
$divs.eq(0).attr({ 'data-role': 'admin', 'data-level': 99, 'data-active': 'true' });
$divs.eq(1).attr({ 'data-role': 'user', 'data-level': 1, 'data-active': 'false' });
log('已 JSON 批量設置 3 個屬性');
});
// 3. 讀取屬性 (只取第一個)
$('#btnGetAttr').on('click', () => {
const role = $divs.attr('data-role'); // 只讀取第一個 div 的
const level = $divs.attr('data-level');
log(`讀取第一個元素: data-role="${role}", data-level="${level}"`);
log(`提示: .attr() 只返回集合中第一個元素的值`);
});
// 4. 移除屬性
$('#btnRemove').on('click', () => {
$divs.eq(1).removeAttr('data-level data-active'); // 空格分隔移除多個
log('已移除 div2 的 data-level, data-active');
log(`驗證: data-level="${$divs.eq(1).attr('data-level')}" (應為 undefined)`);
});
$('#btnClear').on('click', () => $log.text('操作日誌...'));
});
</script>
</body>
</html>
關鍵細節深度解析
1. .attr() 讀取只取第一個元素
<div id="a" data-x="1"></div>
<div id="b" data-x="2"></div>
$('div').attr('data-x'); // "1" (只取第一個)
$('div').map((_, el) => el.getAttribute('data-x')).get(); // ["1", "2"] 取所有值
2. JSON 批量設置的優勢
- 單次 DOM 操作,減少重排/重繪
- 程式碼更簡潔、可讀性更高
- 屬性名可含連字號:
{'data-user-id': 123} (字串鍵名)
3. removeAttr() 的副作用:同步移除 DOM Property
<input type="checkbox" checked>
$('input').removeAttr('checked');
// 結果:HTML 移除 checked 屬性,DOM property checked 變為 false
// 視覺上核取方塊變為未勾選
這是刻意設計:removeAttr 會將對應的 DOM property 設為預設值 (布林屬性為 false)。
4. attr vs prop 鐵律
| 屬性類型 | 正確方法 | 例子 |
| HTML 標準屬性 (id, class, name, href, src, data-*, ...) | .attr() | attr('href'), attr('data-id') |
| 布林屬性 (checked, disabled, selected, readonly, required, ...) | .prop() | prop('checked', true) |
| 動態狀態 (value, scrollTop, scrollLeft, ...) | .prop() / .val() | val('text'), prop('scrollTop', 100) |
| 表單元素屬性 (type, tagName, nodeName, ...) | .prop() (唯讀) | prop('tagName') |
5. 使用函數值動態計算屬性
// 為每個元素根據索引設置不同 data-index
$('li').attr('data-index', function(index) {
return index + 1;
});
// 根據現有屬性計算新值
$('a').attr('href', function(i, oldHref) {
return oldHref + '?track=click';
});
實戰場景:自定義資料屬性 (data-*)
<div data-user='{"id":1,"name":"Alice","roles":["admin"]}'></div>
// jQuery .data() 會自動解析 JSON (僅首次)
const data = $('div').data('user'); // {id:1, name:"Alice", roles:["admin"]} (物件)
// .attr() 返回原始字串
const raw = $('div').attr('data-user'); // '{"id":1,"name":"Alice","roles":["admin"]}' (字串)
// 寫入 .data() 不會更新 HTML 屬性
$('div').data('user', {id:2}); // 只更新內部快取
$('div').attr('data-user', JSON.stringify({id:2})); // 同步更新 HTML
總結
.attr() 處理 HTML 屬性,.prop() 處理 DOM Property —— 分清這兩者是前端進階的分水嶺
- 批量設置用 JSON 物件:
.attr({key1: val1, key2: val2})
- 移除屬性用
.removeAttr('attr1 attr2'),空格分隔多個
- 讀取集合中所有元素的屬性值,用
.map((_, el) => el.getAttribute('attr')).get()
- 布林屬性 (checked/disabled/selected) 永遠用 .prop()