グローバル属性

グローバル属性は、すべての HTML 要素で共通の属性です。すべての要素で使用できますが、要素によっては効果がないこともあります。

グローバル属性は、標準仕様で定義されていない要素を含む、すべての HTML 要素で指定することができます。つまり、その要素を使用することで文書が HTML5 に準拠しなくなるような標準外の要素であっても、これらの属性は受け入れなければなりません。例えば、 <foo hidden>…</foo> とマークアップされたコンテンツは、 <foo> が妥当な HTML 要素ではなくても、 HTML5 準拠のブラウザーは非表示にします。

基本的な HTML グローバル属性に加えて、以下のグローバル属性も存在します。

  • xml:langxml:base。これらは XHTML 仕様から継承したもので非推奨ですが、互換性のために残されています。
  • アクセシビリティを確保するために使用される、 ARIA の role 属性および複数の aria-* 状態およびプロパティ。
  • イベントハンドラー属性: onabort, onautocomplete, onautocompleteerror, onblur, oncancel, oncanplay, oncanplaythrough, onchange, onclick, onclose, oncontextmenu, oncuechange, ondblclick, ondrag, ondragend, ondragenter, ondragleave, ondragover, ondragstart, ondrop, ondurationchange, onemptied, onended, onerror, onfocus, oninput, oninvalid, onkeydown, onkeypress, onkeyup, onload, onloadeddata, onloadedmetadata, onloadstart, onmousedown, onmouseenter, onmouseleave, onmousemove, onmouseout, onmouseover, onmouseup, onmousewheel, onpause, onplay, onplaying, onprogress, onratechange, onreset, onresize, onscroll, onseeked, onseeking, onselect, onshow, onsort, onstalled, onsubmit, onsuspend, ontimeupdate, ontoggle, onvolumechange, onwaiting

グローバル属性の一覧

accesskey

現在の要素に対するキーボードショートカットを生成するヒントを与えます。この属性の値は、空白区切りの文字のリストです。ブラウザーは、この文字リストの中から、コンピューターのキーボードレイアウトに存在する最初の文字を使用します。

autocapitalize

入力されたテキストを自動的に大文字にするかどうか、大文字にする場合はその方法を制御します。

autofocus

ページの読み込み時、またはその一部である <dialog> が表示された時点で、その要素がフォーカスされるようにすることを示す。この属性は論理値で、初期値は false です。

class

要素のクラスの空白区切りリストです。 CSS の クラスセレクター や JavaScript の Document.getElementsByClassName() メソッドのような関数を使えば、特定の要素を選択したりアクセスしたりすることができます。

contenteditable

ユーザーによる要素の編集が可能かどうかを示す列挙型属性です。編集可能な場合、ブラウザーはその要素を編集可能なものに変更します。この属性の値は、以下のどちらかでなければなりません。

  • true または 空文字列: 要素が編集可能であることを示す
  • false: 要素は編集不可であることを示す
contextmenu 非推奨; 非標準

その要素のコンテキストメニューとして使用する <menu>id を指定します。

data-*

これらの属性はカスタムデータ属性と呼ばれており、 HTML とその DOM 表現との間で、固有の情報を交換できるようにします。すべてのカスタムデータは、その属性を設定した要素の HTMLElement インターフェイスを通して使用することができます。 HTMLElement.dataset プロパティでカスタムデータにアクセスできます。

dir

要素のテキストの書字方向を示す、列挙型属性です。以下の値を使用することができます。

  • ltr: left to right を表し、左書きの言語 (日本語、英語など) に対して使用します。
  • rtl: right to left を表し、右書きの言語 (アラビア語など) に対して使用します。
  • auto: ユーザーエージェントに決定させます。要素の中の文字を、書字方向を強く決定する文字が見つかるまで解析し、その方向を要素全体に適用する基本的なアルゴリズムを使用します。
draggable

ドラッグ&ドロップ API を使用して要素をドラッグすることができるかを示す列挙型属性です。以下の値を使用することができます。

  • true: 要素がドラッグ可能であることを示す
  • false: 要素がドラッグ不可であることを示す
enterkeyhint

仮想キーボードの Enter キーにどのようなアクションラベル(またはアイコン)を表示するかを指示します。

exportparts

シャドウ部品を入れ子になったシャドウツリーから軽いツリーへ変換しながらエクスポートするために使用します。

hidden

列挙型の属性で、要素がまだ、あるいはもはや関連性がないことを示します。例えば、ログイン処理が完了するまで使えない要素を隠すために使用できます。ブラウザーはこの要素を表示しません。この属性は、表示することが正当なコンテンツを隠すために使用してはいけません。

id

文書全体で一意でなければならない識別子 (ID) を定義します。(フラグメント識別子を使った) リンク、スクリプト、 (CSS での) スタイルづけなど要素を特定するために使用されます。

inert

ブラウザーがその要素に対するユーザー入力イベントを無視するようにする論理値です。クリックイベントが存在している場合に有用です。

inputmode

この要素やその内容を編集する時に使用する仮想キーボードの種類の構成に関するヒントをブラウザーに与えます。主に <input> 要素で使用されますが、 contenteditable モードにあるすべての要素で使用することができます。

is

標準の HTML 要素が、登録したカスタム組み込み要素のようにふるまうように指定することができます(詳しくはカスタム要素の使用を参照)。

メモ: item* 属性は、 WHATWG HTML Microdata 仕様の一部です。

itemid

項目の一意でグローバルな識別子です。

itemprop

項目にプロパティを追加するために使用します。すべての HTML 要素で itemprop 属性を指定することができ、この itemprop は名前と値の組で構成されます。

itemref

itemscope 属性を持つ要素の子孫以外のプロパティは、 itemref を使用して項目に関連付けることができます。文書中の他の場所で追加のプロパティがある要素の id (itemid ではない) の一覧を提供します。

itemscope

itemscope は (通常) itemtype とともに、ブロックに含まれている HTML が特定の項目に関するものであることを指定します。 itemscope は項目を作成し、それに関連付けられる itemtype のスコープを定義します。 itemtype は、項目やそのプロパティの文脈を説明する語彙 (schema.org など) の有効な URL です。

itemtype

データ構造内の itemprop (項目のプロパティ)を定義するために使う、語彙の URL を指定します。 itemscope は、 itemtype で設定した語彙がデータ構造内でアクティブになるスコープを設定するために使用します。

lang

要素の言語を定義します。編集不可能な要素を記述している言語、または編集可能な要素に記述されるべき言語を定義します。この属性の値は、 RFC 5646: Tags for Identifying Languages (also known as BCP 47) で定義された形式の「言語タグ」(ハイフン区切りの「言語サブタグ」列)です。 xml:lang はこの要素より優先します。

nonce

暗号化ノンス ("number user once") で、コンテンツセキュリティポリシーが取得を許可するかどうかを決定するために使用することがあります。

part

要素のパート名の空白区切りによるリストです。パート名を利用すると、 CSS がシャドウツリー内にある特定の要素を ::part 擬似要素を使用することで選択し、スタイル付けすることができます。

popover

要素をポップオーバー要素として指定するために使用します(ポップオーバーAPI 参照)。ポップオーバー要素は、呼び出す/コントロール要素(すなわち、popovertarget属性を持つ <button><input type="button">)、または HTMLElement.showPopover() 呼び出しによって開かれるまで、 display: none によって非表示になります。

role

ロールはコンテンツの意味づけを定義し、スクリーンリーダーや他のツールが、その種類のオブジェクトに対するユーザーの期待に沿った方法でオブジェクトを表示し、対話を支援することを可能にします。ロールは role="role_type" を使って HTML 要素に追加します。ここで role_type は ARIA 仕様書でのロールの名前です。

slot

シャドウ DOM のシャドウツリー内のスロットを、要素に割り当てます。slot 属性を持つ要素は、 slot 属性の値と一致する name 属性の値を持つ <slot> 要素が生成したスロットに割り当てられます。

spellcheck

列挙型属性で、要素でスペルチェックを行うかどうかを定義します。以下の値が利用できます。

  • 空文字列または true: 可能であればその要素でスペルチェックを行うことを示す
  • false: その要素でスペルチェックを行わないことを示す
style

要素に適用する CSS スタイル宣言を設定します。なお、スタイルは別のファイルで定義することが推奨されます。この属性と <style> 要素の主な用途は、例えばテストのために、すばやくスタイルを適用することです。

tabindex

要素が入力フォーカスを受け付ける (focusable の) 場合に、順番的なキーボードナビゲーションに参加するかどうか、参加するならばどの位置に入るかを示す、整数値属性です。いくつかの値を取ることができます。

  • 負の数: 要素はフォーカスを受け付けますが、順番的なキーボードナビゲーションでは到達できません。
  • 0: 要素はフォーカスを受け付けて、順番的なキーボードナビゲーションで到達できます。その順番はプラットフォームの慣習に従って定義されます。
  • 正の数: 要素はフォーカスを受け付けて、順番的なキーボードナビゲーションで到達できることを表します。その相対的な順序は属性の値で定義され、 tabindex の数値の昇順にフォーカスを移します。複数の要素が同じ tabindex の値を持っている場合は、文書内における要素の相対的な位置に従います。
title

要素に関するアドバイザリー情報を表すテキストを設定します。この情報は通常、ツールチップとしてユーザーに表示されますが、必ず表示されるとは限りません。

translate

列挙型属性で、要素の属性値や子孫 Text ノードの値が、ページをローカライズするときに翻訳対象となるか、あるいは変更せずにおくかを指定します。以下の値を使用することができます。

  • 空文字列または yes: 要素が翻訳対象になることを示します。
  • no: 要素が翻訳対象にならないことを示します。
virtualkeyboardpolicy Experimental

列挙型属性で、タブレットやモバイル端末などのハードウェアキーボードが利用できない端末において、コンテンツが編集可能な要素(例えば、 <input><textarea> 要素、あるいは contenteditable 属性を設定した要素)において画面上の仮想キーボードの動作を制御するために使用します。

  • auto または空文字列: 要素がフォーカスまたはタップされたときに、自動的に仮想キーボードを示します。
  • manual: 要素へのフォーカスやタップを仮想キーボードの状態から切り離します。

仕様書

Specification
HTML Standard
# attr-contenteditable
CSS Shadow Parts
# part-attr
HTML Standard
# attr-translate
CSS Shadow Parts
# element-attrdef-html-global-exportparts
HTML Standard
# attr-nonce
HTML Standard
# attr-is
HTML Standard
# writing-suggestions
HTML Standard
# attr-inputmode
HTML Standard
# attr-data-*
HTML Standard
# the-dir-attribute
HTML Standard
# attr-slot
DOM Standard
# ref-for-dom-element-slot①
HTML Standard
# the-inert-attribute
HTML Standard
# attr-enterkeyhint
HTML Standard
# attr-tabindex
HTML Standard
# the-accesskey-attribute
HTML Standard
# the-title-attribute
VirtualKeyboard API
# dom-elementcontenteditable-virtualkeyboardpolicy
HTML Standard
# the-hidden-attribute
HTML Standard
# global-attributes:the-id-attribute-2
HTML Standard
# global-attributes:classes-2
HTML Standard
# dom-fe-autofocus
HTML Standard
# the-draggable-attribute
HTML Standard
# the-style-attribute
CSS Style Attributes
# style-attribute
HTML Standard
# attr-spellcheck
HTML Standard
# attr-lang
HTML Standard
# nonce-does-not-update-dom
HTML Standard
# attr-autocorrect
HTML Standard
# attr-autocapitalize
HTML Standard
# the-popover-attribute

ブラウザーの互換性

BCD tables only load in the browser

関連情報

  • Element インターフェイスで、ほとんどのグローバル属性を調べることができます。