自訂屬性是把附加資料掛在 DOM 元素上的常用手法,在 HTML5 之後更有了 data-* 的標準寫法。以下把原生與 jQuery 兩套 API 並列整理。
var testEle = document.getElementById("test");
testEle.setAttribute("test", "aaa"); // 設定
testEle.getAttribute("test"); // 讀取
testEle.attributes["test"].nodeValue; // 另一種讀取方式
三種寫法讀到的都是同一個值。第三種是走 attributes 集合取得節點物件再取 nodeValue,在需要一次遍歷所有屬性時比較有用;單純取值用 getAttribute 最直觀。
若要移除,用 testEle.removeAttribute("test")。
$("#test").attr("test", "aaa"); // 設定
$("#test").removeAttr("test"); // 刪除
// 以自訂屬性作為選擇條件
var testAttr = "ddd";
$('#test[test="'+ testAttr +'"]')
讀取時同樣是 $("#test").attr("test"),只傳一個參數即為取值。
HTML5 之後,自訂屬性應以 data- 前綴命名,例如 data-userid="1001"。這麼做有兩個實際好處:一是 HTML 校驗器不會報「非法屬性」;二是 jQuery 提供 .data() 方法,會自動把 data-user-id 轉為 .data('userId'),並順帶完成型別轉換(數字字串會變成真正的 number)。
// HTML: <div id="test" data-user-id="1001">
$("#test").data("userId"); // 1001(number)
$("#test").attr("data-user-id"); // "1001"(string)
要注意兩者的差異:.data() 有內部快取,第一次讀取後會存起來,之後即使 attr 改了 DOM 上的值,.data() 仍回傳快取內容。因此需要與 DOM 保持同步時,請統一使用 attr;只是讀取初始設定值時,.data() 較方便。
以上就是原生與 jQuery 操作自訂屬性的對照整理,希望對你的開發有所幫助。