DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
HTML5 自訂 data-* 屬性與 jQuery .data() 方法完整用法
編輯:HTML5詳解     

從 jQuery Mobile 的 data-role 說起

用過 jQuery Mobile 的人,對 data-role、data-theme 這類寫法應該不陌生。例如只要加上一段標記,就能得到現成的頁眉效果:

<div data-role="header">
  <h1>我是標題</h1>
</div>

用手機瀏覽器打開,樣式就直接套用上了:

為什麼只寫一個 data-role="header",就能得到深色底、白字、文字居中的效果?下面用最簡單的實作,把這背後的機制講清楚。

自己動手做一個 data-* 屬性

我們寫一個 HTML 頁面,自訂一個 data-chb="header" 屬性,希望帶有這個屬性的 div 呈現黑底白字、文字居中;沒有這個屬性的 div 則維持預設樣式:

<body>
<div data-chb="header">
<h1>我是使用了 data-chb 自訂屬性的 div</h1>
</div>
<br/>
<div>
我沒有使用 data-chb 自訂屬性,該怎麼展現就怎麼展現;
</div>
</body>

接著定義對應的 CSS:

<style>
.ui_header {
  background-color: black;
  text-align: center;
  color: white;
  border: 1px solid #000;
}
</style>

然後用一段腳本,在頁面載入時動態加上樣式類別:

<script type="text/Javascript">
window.onload = function () {
  var elems = document.getElementsByTagName("div");
  if (elems != null && elems.length > 0) {
    var length = elems.length;
    // 遍歷所有 DIV 元素
    for (var i = 0; i < length; i++) {
      var elem = elems[i];
      // 取得該元素的自訂屬性
      var customAttr = elem.dataset.chb;
      // 也可以寫成 elem.dataset["chb"]
      // 如果是預先定義好的 header 值,表示需要處理
      if (customAttr == "header") {
        elem.setAttribute("class", "ui_header");
      }
    }
  }
}
</script>

執行後的效果:

為什麼 HTML5 要引入 data-*

我們總喜歡在標籤上塞自訂屬性來存放與操作資料。但這種做法有兩個隱憂:一是你無法保證未來不會有別的腳本把你的屬性重置掉;二是它會讓 HTML 在語法上偏離規範,還可能帶來其他副作用。這正是 HTML5 加入自訂 data 屬性的原因。

用法非常直覺:你可以在任何標籤上添加以「data-」開頭的屬性。這些屬性不會顯示在頁面上,不影響版面與外觀,但可讀可寫。下面是一段完全合法的 HTML5 標記:

<div id="awesome"
     data-myid="3e4ae6c4e">Some awesome data</div>

用 jQuery 讀取 data-*

要讀這些值,你当然可以遍歷元素逐一取用,但 jQuery 已經內建了方法:.data()。其中 .data(obj) 這種形式在 jQuery 1.4.3 之後加入,可以直接取回對應的 data 屬性。

var myid = jQuery("#awesome").data('myid');
console.log(myid);

data-* 屬性裡還能寫 JSON。例如下面這樣的標記:

<div id="awesome-JSon" data-awesome='{"game":"on"}'></div>

就能透過 key 直接取到對應的 value:

var gameStatus = jQuery("#awesome-JSon").data('awesome').game;
console.log(gameStatus);

反過來,你也可以用 .data(key, value) 直接為 data-* 賦值。

這裡有個觀念要記住:data-* 屬性應該與元素本身語意相關,不要把它當成可以塞任何東西的通用儲存空間。

補充一點:即使 data-* 是 HTML5 才正式納入規範的寫法,jQuery 的 .data() 本身並不綁定 HTML5,因此在舊頁面或舊瀏覽器上,你一樣可以用它來操作 data-* 資料。

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