DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5教程
HTML5 自訂屬性 data-* 詳解與 JavaScript 操作範例
編輯:HTML5教程     

data-* 是 HTML5 提供的一組自訂屬性命名空間,讓你能把與呈現無關的資料直接掛在元素上,再用 JavaScript 讀寫。在先進瀏覽器中,讀取方式比想像中簡潔,專案實作中非常實用。

基本用法

<div id="user" data-uid="12345" data-uname=""></div>

方法一:getAttribute / setAttribute

// 取得 data- 屬性
var user = document.getElementById('user');
var userName = user.getAttribute('data-uname');
var userId = user.getAttribute('data-uid');   // '12345'

// 設定 data- 屬性
user.setAttribute('data-site', 'https://www.example.com');

這種寫法在所有現代瀏覽器都能運作,但它並沒有真正發揮 data-* 的價值——因為跟我們以前自創屬性其實沒兩樣:

<div id="user" uid="12345" uname=""></div>
<script>
var user = document.getElementById('user');
var userName = user.getAttribute('uname');
var userId = user.getAttribute('uid');
user.setAttribute('site', 'https://www.example.com');
</script>

這種「原始」自訂屬性和 data-* 唯一的差別只是屬性名前綴。更關鍵的是,自創的未定義屬性在 HTML 驗證時會報錯,而 data-* 是規格明文允許的,這是它存在的正當性。

方法二:dataset 屬性

比較道地的做法,是透過元素的 dataset 屬性存取。它是 HTML5 JavaScript API 的一部分,會回傳一個包含該元素所有 data- 屬性的 DOMStringMap 物件。

使用時有兩個規則要記住:一是要拿掉 data- 前綴;二是屬性名若含連字號,連字號會被移除並轉為駝峰命名,例如 data-date-of-birth 要寫成 dateOfBirth。

<div id="user" data-id="1234567890" data-name="" data-date-of-birth>碼頭</div>
<script type="text/javascript">
var el = document.querySelector('#user');
console.log(el.id);                    // 'user'
console.log(el.dataset);               // DOMStringMap
console.log(el.dataset.id);            // '1234567890'
console.log(el.dataset.name);          // ''
console.log(el.dataset.dateOfBirth);   // ''

el.dataset.dateOfBirth = '1985-01-05'; // 設定 data-date-of-birth
console.log('someDataAttr' in el.dataset); // false
el.dataset.someDataAttr = 'mydata';
console.log('someDataAttr' in el.dataset); // true
</script>

要刪除一個 data 屬性,可以這樣做:

delete el.dataset.id;
// 或
el.dataset.id = null;

寫法很漂亮,但要注意支援度:dataset 在 Chrome 8+、Firefox 6+、IE 11+、Opera 11.10+、Safari 6+ 才可用。若要支援更舊的環境,那段時間还是得用 getAttribute/setAttribute。實務上比較穩健的做法是寫一個小工具函式,偵測到 dataset 可用就走它,否則退回 attribute 方式。

data-* 選擇器

實際開發時,用自訂屬性來選元素往往很方便:

// 選取所有含 data-flowering 屬性的元素
document.querySelectorAll('[data-flowering]');

// 選取 data-text-colour 值為 red 的元素
document.querySelectorAll('[data-text-colour="red"]');

CSS 同樣能用屬性選擇器做客製樣式:

<style type="text/css">
.user { width: 256px; height: 200px; }

.user[data-name='feiwen'] { color: brown; }
.user[data-name='css']    { color: red; }
</style>

<div class="user" data-id="123" data-name="feiwen">1</div>
<div class="user" data-id="124" data-name="css">碼頭</div>

還有一個重點:dataset 的值一律是字串

無論你寫的是數字還是布林值,透過 dataset 讀出來都是字串,需要時得自己用 Number() 或 JSON.parse() 轉型。若要存物件或陣列,常見做法是序列化成 JSON 字串再放進去。另外,data-* 只適合放小型的、與呈現無關的資料;大量資料應該留在 JavaScript 或送進儲存 API,而不是塞進 HTML。

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