data-*
試してみましょう
<h1>Secret agents</h1>
<ul>
<li data-id="10784">Jason Walters, 003: Found dead in "A View to a Kill".</li>
<li data-id="97865">
Alex Trevelyan, 006: Agent turned terrorist leader; James' nemesis in
"Goldeneye".
</li>
<li data-id="45732">
James Bond, 007: The main man; shaken but not stirred.
</li>
</ul>
h1 {
margin: 0;
}
ul {
margin: 10px 0 0;
}
li {
position: relative;
width: 200px;
padding-bottom: 10px;
}
li:after {
content: "Data ID: " attr(data-id);
position: absolute;
top: -22px;
left: 10px;
background: black;
color: white;
padding: 2px;
border: 1px solid #eee;
opacity: 0;
transition: 0.5s opacity;
}
li:hover:after {
opacity: 1;
}
すべてのカスタムデータは、属性を設定した要素の HTMLElement
インターフェイスを通して使用できます。 HTMLElement.dataset
プロパティがそれらへのアクセス手段を提供します。
*
は、 XML 名の作成規則に加えて以下の制約に従う名前に置き換えることができます。
- 大文字小文字にかかわらず、名前を
xml
で始めてはならない。 - 名前にコロン (
:
) を含めてはならない。 - 名前に大文字を含めてはならない。
なお、 HTMLElement.dataset
プロパティは DOMStringMap
であり、またカスタムデータ属性名のハイフン (U+002D
) はその次の文字を大文字化したもの(キャメルケース)に変換されるので、 data-test-value は HTMLElement.dataset.testValue
(または HTMLElement.dataset["testValue"]
)としてアクセスできます。
使用方法
data-*
属性を追加すると通常の HTML 要素でも、より複雑で強力なプログラムオブジェクトになります。例えばゲームで宇宙船の "スプライト" を、単純な <img>
要素に class
属性といくつかの data-*
属性を設定したもので表すことができるでしょう。
html
<img
class="spaceship cruiserX3"
src="shipX3.png"
data-ship-id="324"
data-weapons="laserI laserII"
data-shields="72%"
data-x="414354"
data-y="85160"
data-z="31940"
onclick="spaceships[this.dataset.shipId].blasted()" />
もっと深い HTML のデータ属性の使用については、データ属性の使用を参照してください。
仕様書
Specification |
---|
HTML # attr-data-* |
ブラウザーの互換性
関連情報
- すべてのグローバル属性
- これらの値を読み書きできる
HTMLElement.dataset
プロパティ - データ属性の使用