attr() 是操作 HTML 屬性的萬用鑰匙,但它有好幾種簽名,各自對應不同情境。以下把五種用法搭配實例整理清楚。
// 1. 讀取「第一個」符合元素的屬性值
$("Element").attr(name); // 例:$("img").attr("src")
// 2. 為元素設定單一屬性
$("Element").attr(key, value);
// 3. 一次設定多個屬性
$("Element").attr({ key: value, key1: value1, ... });
// 4. 用函式計算屬性值,套用到「所有」符合的元素
$("Element").attr(key, function(){ ... });
// 5. 移除屬性
$("Element").removeAttr(name);
$("img").attr("src");
要注意的是「只取第一個」。即使頁面上有二十張圖,這個寫法也只會回傳第一張的 src。
$("img").attr({ src: "test.jpg", alt: "Test Image" });
傳入物件時,所有符合的 img 都會被一次更新。這比連續寫兩行 attr() 更省,也讓瀏覽器只處理一次樣式重算。
$("img").attr("src", "test.jpg");
$("img").attr("title", function() { return this.src });
這個形式最容易被忽略,卻非常實用。當每個元素要設的值都不一樣、而這個值又剛好可以從元素本身算出來時,用回呼就不必跑迴圈。注意回呼裡的 this 指的是目前的 DOM 元素,若要回傳 jQuery 物件請用 $(this)。回呼也可以帶第二個參數 index,方便做序號相關的計算。
$("img").removeAttr("title");
這是實務上最容易踩的坑。對於 src、alt、title、class 這類「HTML 屬性」,用 attr() 沒問題;但對於 checked、selected、disabled 這類會隨使用者互動而變化的「元素狀態」,應該用 prop()。兩者混用是表單元件行為異常的常見原因。
以上是 attr() 的完整用法整理,都是日常開發中反覆會用到的經驗總結。