用過 jQuery Mobile 的人,對 data-role、data-theme 這類寫法應該不陌生。例如只要加上一段標記,就能得到現成的頁眉效果:
<div data-role="header"> <h1>我是標題</h1> </div>
用手機瀏覽器打開,樣式就直接套用上了:


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

我們總喜歡在標籤上塞自訂屬性來存放與操作資料。但這種做法有兩個隱憂:一是你無法保證未來不會有別的腳本把你的屬性重置掉;二是它會讓 HTML 在語法上偏離規範,還可能帶來其他副作用。這正是 HTML5 加入自訂 data 屬性的原因。
用法非常直覺:你可以在任何標籤上添加以「data-」開頭的屬性。這些屬性不會顯示在頁面上,不影響版面與外觀,但可讀可寫。下面是一段完全合法的 HTML5 標記:
<div id="awesome"
data-myid="3e4ae6c4e">Some awesome data</div>
要讀這些值,你当然可以遍歷元素逐一取用,但 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-* 資料。