DIV CSS 佈局教程網

JavaScript 屬性操作詳解:attributes、getAttribute 與 setAttribute 全整理
編輯:JavaScript基礎知識     

操作 DOM 元素的屬性,JavaScript 提供了兩條路:一條是「屬性名稱」導向(getAttribute / setAttribute / removeAttribute),另一條是「節點物件」導向(getAttributeNode / setAttributeNode / removeAttributeNode)。本文把兩組 API 的用法與雷區一次講清楚。

API 速查

· attributes:取得元素的所有屬性,結果是一個 NamedNodeMap 集合
· getAttribute(name):取得指定屬性的值
· setAttribute(name, value):建立屬性並指定值(已存在則覆寫)
· createAttribute(name):只建立一個屬性節點,尚未掛到元素上
· removeAttribute(name):刪除指定屬性
· getAttributeNode(name):取得屬性節點物件
· setAttributeNode(node):把屬性節點掛到元素上
· removeAttributeNode(node):移除指定的屬性節點

attributes 的用法

attributes 取出的每一項都是節點物件,因此取值時要用 [] 搭配屬性名稱。IE 早期也接受 () 呼叫,但為了跨瀏覽器一致,一律用中括號。

<body>
<div id="t"><input type="hidden" id="sss" value="aaa"></div>
</body>
<script>
var d = document.getElementById("sss").attributes["value"];
document.write(d.name);  // value
document.write(d.value); // aaa
</script>

getAttribute / setAttribute / removeAttribute

這三個是最常用的組合,觀念簡單,但有幾個容易踩到的細節:

1. createAttribute() 是 document 的方法,不需要針對特定元素呼叫。
2. 屬性名稱不要使用 name、type、value 這類與內建屬性同名的字,容易在部分瀏覽器上出現難以理解的行為。
3. 用 createAttribute 建立屬性時若沒有設定 nodeValue,Firefox 會視為空字串,舊版 IE 則視為 undefined。

<script>
var d = document.getElementById("sss").getAttribute("value");
document.write(d); // aaa

document.getElementById("sss").setAttribute("good", "hello");
alert(document.getElementById("t").innerHTML); // 多了一個 good="hello"
</script>

createAttribute 的完整流程

<script>
window.onload = function () {
  var oBox = document.getElementById('box');

  oBox.setAttribute('value', 'name');       // 直接設定屬性與值
  var attr = document.createAttribute('hallo'); // 只建立屬性節點
  attr.nodeValue = 'world';                 // 指派值
  oBox.setAttributeNode(attr);              // 掛到元素上
};
</script>
<ul id="box"></ul>

節點導向的三個方法

getAttributeNode / setAttributeNode / removeAttributeNode 的操作對象是「屬性節點」本身,而不是字串名稱。理解這點之後就不容易用錯。

<script>
// 取得節點
var d = document.getElementById("sss").getAttributeNode("value");
document.write(d.name);  // value
document.write(d.value); // aaa

// 掛上新的屬性節點
var attr = document.createAttribute("good");
document.getElementById("sss").setAttributeNode(attr);

// 移除屬性節點
var target = document.getElementById("sss").getAttributeNode("value");
document.getElementById("sss").removeAttributeNode(target);
</script>

現代寫法補充

上述 API 在今天仍然完全可用,但實務上有幾點值得注意:

· 讀寫標準屬性時,直接用 el.value 這類 DOM -property 寫法通常比 getAttribute 更直觀,也能拿到「當前狀態」而非「HTML 初始值」。
· 判斷屬性是否存在用 el.hasAttribute('disabled'),比判斷 getAttribute 回傳值更清楚。
· 自訂的資料屬性建議用 data-* 命名,並透過 el.dataset 存取,它會自動處理 data-user-name 到 dataset.userName 的轉換。
· 一次要改多個樣式或屬性時,可用 el.setAttribute 搭配迴圈,或直接用 Object.assign(el.style, {...}) 處理樣式。

el.dataset.userId = '1001';       // 產生 data-user-id="1001"
console.log(el.dataset.userId);   // 1001
el.removeAttribute('disabled');
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved