HTML5的自定義屬性data-*詳細介紹和JS操作實例

作者：Eve Cole 更新時間：2025-05-30 20:16:01

點評：HTML5 增加了一項新功能是自定義數據屬性，也就是data-* 自定義屬性。在HTML5中我們可以使用以data- 為前綴來設置我們需要的自定義屬性，來進行一些數據的存放

當然高級瀏覽器下可通過腳本進行定義和數據存取。在項目實踐中非常有用。

例如：

使用attribute方法存取data-* 自定義屬性的值

使用attributes方法存取data-* 自定義屬性的值非常方便：

// 使用getAttribute獲取data- 屬性

var user = document . getElementById ( 'user' ) ;

var userName = plant . getAttribute ( 'data-uname' ) ; // userName = '腳本之家'

var userId = plant . getAttribute ( 'data-uid' ) ; // userId = '12345'

// 使用setAttribute設置data- 屬性

user . setAttribute ( 'data-site' , 'http://www.vevb.com' ) ;

此方法能在所有的現代瀏覽器中正常工作，但它不是HTML 5 的自定義data-*屬性被使用目的，不然和我們以前使用的自定義屬性就沒有什麼區別了，例如：

// 使用getAttribute獲取data- 屬性

var user = document . getElementById ( 'user' ) ;

var userName = plant . getAttribute ( 'uname' ) ; // userName = '腳本之家'

var userId = plant . getAttribute ( 'uid' ) ; // userId = '12345'

// 使用setAttribute設置data- 屬性

user . setAttribute ( 'site' , 'http://www.vevb.com' ) ;

</script>

這種“原始”的自定義屬性和上面data-* 自定義屬性沒什麼區別，知識屬性名不一樣。

dataset屬性存取data-*自定義屬性的值

這種方式通過訪問一個元素的dataset 屬性來存取data-* 自定義屬性的值。這個dataset 屬性是HTML5 JavaScript API的一部分，用來返回一個所有選擇元素data- 屬性的DOMStringMap對象。

使用這種方法時，不是使用完整的屬性名，如data-uid 來存取數據，應該去掉data- 前綴。

還有一點特別注意的是： data- 屬性名如果包含了連字符，例如：data-date-of-birth ，連字符將被去掉，並轉換為駝峰式的命名，前面的屬性名轉換後應該是： dateOfBirth 。

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(Gecko) 6.0+ Internet Explorer 11+ Opera 11.10+ Safari 6+瀏覽器中實現，所以在此期間最好用的getAttribute和setAttribute來操作。

關於data-屬性選擇器

在實際開發時，您可能會發現它很有用，你可以根據自定義的data- 屬性選擇相關的元素。例如使用querySelectorAll選擇元素：

// 選擇所有包含'data-flowering' 屬性的元素

document . querySelectorAll ( '[data-flowering]' ) ;

// 選擇所有包含'data-text-colour' 屬性值為red的元素

document . querySelectorAll ( '[data-text-colour="red"]' ) ;

同樣的我們也可以通過data- 屬性值對相應的元素設置CSS樣式，例如下面這個例子：

.user {

width : 256px ;

height : 200px ;

}

.user[data-name='feiwen'] {

color : brown

}

.user[data-name='css'] {

color : red

}

</style>