DIV CSS 佈局教程網

用 jQuery 的 data() 讀取 HTML5 自訂屬性 data-*
編輯:JavaScript綜合知識     

如果你使用 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") 存取。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved