data-*

data-* グローバル属性はカスタムデータ属性と呼ばれる属性の組を作り、HTML と、スクリプトによって使用されるであろう DOM 表現との間で、固有の情報を交換できるようにします。すべてのカスタムデータは、属性を設定した要素の HTMLElement インターフェイスを通して使用できます。HTMLElement.dataset プロパティがそれらへのアクセス手段を提供します。
* は、以下の制約と合わせて xml 名の作成規則に従う名前に置き換えられます:

  • XML として使用する場合であっても、名前を xml で始めてはならない。
  • 名前にコロン (U+003A) を含めてはならない。
  • 名前に大文字の A から Z を含めてはならない。

HTMLElement.dataset プロパティは StringMap であり、またカスタムデータ属性名のハイフン (U+002D) は次の文字を大文字化したものに置き換えられる (キャメルケース) 点に注意してください。よってカスタムデータ属性 data-test-valueHTMLElement.dataset.testValue としてアクセスできます。

仕様

仕様書 策定状況 コメント
WHATWG HTML Living Standard
The definition of 'data-*' in that specification.
Living Standard 最新のスナップショットである HTML5.1 から変更なし。
HTML5.1
The definition of 'data-*' in that specification.
草案 WHATWG HTML Living Standard のスナップショットであり、HTML5 から変更はありません。
HTML5
The definition of 'data-*' in that specification.
勧告 WHATWG HTML Living Standard のスナップショットであり、この属性を初めて定義しました。

ブラウザ実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート (有) 6 (6) (有) (有) (有)
機能 Android Android 版 Chrome Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート (有) 6.0 (6) (有) (有) (有) (有)

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: yyss
 最終更新者: yyss,