1. 開発者向けのウェブ技術
  2. HTML
  3. リファレンス
  4. グローバル属性

このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

グローバル属性

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

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

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

  • xml:lang と xml:base。これらは XHTML 仕様から継承したもので非推奨ですが、互換性のために残されています。
  • アクセシビリティを確保するために使用される、 ARIA の role 属性および複数の aria-* 状態およびプロパティ。
  • イベントハンドラー属性は後述します。

グローバル属性の一覧

accesskey

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

anchor

位置指定要素をアンカー要素に関連付けます。この属性の値は、位置指定要素をアンカーする要素の id 値です。これにより、 CSS アンカー位置指定を使用して要素を位置指定することができます。

autocapitalize

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

autocorrect

入力テキストのスペルミスを自動的に修正するかどうかを制御します。 これは、 <input> 要素の type="password"、type="email"、type="url" を除いたテキストが編集可能な要素に適用することができます。

autofocus

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

class

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

contenteditable

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

  • true または 空文字列: 要素が編集可能であることを示す
  • false: 要素は編集不可であることを示す
  • plaintext-only: これは、要素の生テキストは編集可能であるが、リッチテキストの書式設定は無効であることを示します。
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

要素の言語を定義します。編集不可能な要素を記述している言語、または編集可能な要素に記述されるべき言語を定義します。この属性の値には、有効な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

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

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

列挙型属性であり、ブラウザーが指定した入力補完を要素のスコープで有効にするかどうかを示します。

  • false: ブラウザーの入力補完を無効にします。
  • true または空文字列: 入力補間を有効にします。

グローバルイベントハンドラー属性の一覧

HTML のイベントハンドラー属性は推奨されません。その動作については、HTML 属性リファレンスをご覧ください。

下記に挙げる属性はすべての要素に適用されますが、すべての要素で機能するわけではありません。例えば、onvolumechange という HTML 属性はすべての要素で受け入れられ、volumechange イベントのリスナーを登録しますが、ブラウザーによって発生する volumechange イベントを受け取るのはメディア要素のみです。その他の要素については、EventTarget.dispatchEvent() を使用して手動でイベントを配信する必要があります。属性によっては <body> に指定できるものの、実際には window でのイベントを待ち受けるものもあります。

仕様書

仕様書
HTML
# attr-popover-hint
HTML
# the-draggable-attribute
HTML
# the-popover-attribute
HTML
# attr-slot
HTML
# attr-autocorrect
HTML
# attr-contenteditable-plaintextonly
HTML
# the-inert-attribute
HTML
# the-accesskey-attribute
HTML
# the-autofocus-attribute
HTML
# the-title-attribute
HTML
# attr-tabindex
HTML
# attr-enterkeyhint
HTML
# attr-lang
HTML
# classes
HTML
# the-dir-attribute
HTML
# heading-levels-&-offsets
HTML
# the-id-attribute
HTML
# attr-autocapitalize
HTML
# the-style-attribute
HTML
# the-hidden-attribute
HTML
# attr-contenteditable
HTML
# inert-subtrees
HTML
# attr-nonce
HTML
# attr-data-*
HTML
# attr-translate
HTML
# attr-spellcheck
HTML
# attr-inputmode
HTML
# writing-suggestions
HTML
# attr-is
DOM
# ref-for-dom-element-slot①
VirtualKeyboard API
# dom-elementcontenteditable-virtualkeyboardpolicy
CSS Shadow Module Level 1
# part-attr
CSS Shadow Module Level 1
# element-attrdef-html-global-exportparts
CSS Style Attributes
# style-attribute

ブラウザーの互換性

関連情報

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

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告