如果你使用 jQuery,存取 data-* 自訂屬性會輕鬆許多。data() 方法允許在 DOM 元素上綁定任意型別的資料,而且避免了在元素上直接掛屬性可能導致的循環引用記憶體洩漏。
.data( key, value ) // 設定單一值 .data( obj ) // 批次設定 .data( key ) // 取得單一值 .data() // 取得全部資料物件
從 jQuery 1.4.3 起,HTML5 的 data- 屬性會自動被引用進 jQuery 的資料物件中。
<div data-role="page"
data-last-value="43"
data-hidden="true"
data-options='{"name":"John"}'>
</div>
以下四個判斷式都會回傳 true:
$("div").data("role") === "page";
$("div").data("lastValue") === 43;
$("div").data("hidden") === true;
$("div").data("options").name === "John";
與 HTML5 原生 API 不同,jQuery 會嘗試把字串轉為 JavaScript 值,包括布林、數字、物件、陣列與 null。轉換的原則是「若不改變數值的表示則轉為數字」:例如 "1E02" 與 "100.000" 在數值上等同 100,但轉換會改變原本的表示形式,因此保留為字串;而 "100" 則會被轉為數字 100。
若屬性值以 { 開始或 [ 開始,jQuery 會用 parseJSON 解析,但內容必須符合合法 JSON 語法(包含屬性名稱要加雙引號)。若無法解析為 JS 值,則保留字串。
如果想把值當純字串處理,請改用 attr()。data- 屬性只在第一次被讀取時解析,之後所有值都存在 jQuery 內部快取中,因此後續對元素做 .data(obj) 的操作不會影響已取出的物件。
另外,不帶參數呼叫 .data() 會取得所有資料組成的 JavaScript 物件。這個物件可以安全存在變數裡——一旦取出,之後對元素的 data 操作就不再影響它。而且直接操作這個物件,比每次呼叫 .data() 取值設定都要快一些。
最後提醒命名對應:HTML 中的 data-last-value 在 JS 中要用駝峰式 .data("lastValue") 存取。