萬盛學電腦網

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

jQuery .attr() 與 .removeAttr() 操作元素屬性完整指南

前言

jQuery 提供 .attr() 讀取/設定屬性、.removeAttr() 移除屬性,是 DOM 操作的核心工具。本文系統整理語法、重載形式、常見用法與現代原生替代方案。

.attr() 完整語法與重載

語法用途回傳值
.attr(name)取得第一個匹配元素的屬性值String / undefined
.attr(name, value)設定所有匹配元素的單一屬性jQuery (鏈式)
.attr(object)批次設定多個屬性 {name: value, ...}jQuery
.attr(name, function)函式回傳值設定屬性,參數 (index, oldValue)jQuery

實戰範例

1. 讀取屬性

<img id="avatar" src="a.jpg" alt="頭像" data-user-id="123">

$('#avatar').attr('src');        // "a.jpg"
$('#avatar').attr('data-user-id'); // "123" (HTML5 data-* 也可用 .data())
$('#avatar').attr('nonexist');   // undefined

2. 設定單一屬性

$('#avatar').attr('src', 'b.jpg');
$('#avatar').attr('alt', '新頭像');

3. 批次設定多屬性(物件語法)

$('#avatar').attr({
    src: 'b.jpg',
    alt: '切換後',
    title: '點擊放大'
});

4. 函式動態設定

// 為所有圖片加上索引 data-index
$('img').attr('data-index', function(index) {
    return index;
});

5. 圖片滑過切換(原文 hover 範例重構)

<img class="hover-img" src="images/a.jpg" alt="原圖" data-hover="images/b.jpg" data-hover-alt="切換後">

$('.hover-img').hover(
    function() { // mouseenter
        const $this = $(this);
        $this.data('orig-src', $this.attr('src'))
             .data('orig-alt', $this.attr('alt'))
             .attr({ src: $this.data('hover'), alt: $this.data('hover-alt') });
    },
    function() { // mouseleave
        const $this = $(this);
        $this.attr({ src: $this.data('orig-src'), alt: $this.data('orig-alt') });
    }
);

.removeAttr() 完整語法

// 移除單一屬性
$('#avatar').removeAttr('alt');

// 移除多個屬性(空格分隔,jQuery 1.7+)
$('#avatar').removeAttr('alt title data-user-id');

內部呼叫原生 removeAttribute(),但自動處理 jQuery 物件集合與鏈式呼叫。

屬性 vs. Property 關鍵區別

分類屬性Property
定義HTML 標籤屬性DOM 物件屬性
同步單向:HTML → DOM 初始化雙向即時同步
典型例子src, href, class, id, data-*checked, selected, disabled, value, innerHTML
jQuery 方法.attr() / .removeAttr().prop() / .removeProp()

⚠️ 常見錯誤:用 .attr() 處理 checked/disabled

// ❌ 錯誤:attr 只影響初始 HTML,不改變實際勾選狀態
$('#chk').attr('checked', true); 

// ✅ 正確:prop 操作 DOM property
$('#chk').prop('checked', true);
$('#chk').prop('disabled', false);

現代原生替代方案 (Vanilla JS)

const el = document.getElementById('avatar');

// 讀取
el.getAttribute('src');           // 等同 .attr('src')
el.hasAttribute('data-user-id');  // 檢查存在性

// 設定
el.setAttribute('src', 'b.jpg');
el.setAttribute('data-index', '5');

// 批次設定
['src', 'alt', 'title'].forEach(attr => el.setAttribute(attr, '...'));

// 移除
el.removeAttribute('alt');

// data-* 專用 API (自動轉型)
el.dataset.userId;        // 讀取 data-user-id -> "123" (字串)
el.dataset.userId = '456'; // 寫入
delete el.dataset.userId;  // 刪除

最佳實務建議

  • 優先用 .prop() 處理 checked, selected, disabled, readonly, value, tabIndex 等布林/數值屬性。
  • 用 .attr() 處理 src, href, class, id, data-*, role, aria-* 等 HTML 屬性。
  • 批次操作用物件語法:.attr({...}) 減少 DOM 重繪。
  • 避免在迴圈中重複查詢:先快取 const $el = $('#id') 再操作。
  • 專案若已脫離 jQuery:改用原生 setAttribute/getAttribute 或 dataset。

總結

.attr() 處理 HTML 屬性,.prop() 處理 DOM Property,兩者分工明確。.removeAttr() 批次移除屬性。現代開發可直接使用原生 API,但理解兩者差異對維護舊專案、除錯複雜行為至關重要。

copyright © 萬盛學電腦網 all rights reserved