HTMLElement インターフェイスは、任意の HTML 要素を表します。いくつかの要素は直接このインターフェイスを実装し、他のものは HTMLElement を継承したインターフェイス経由で実装されています。
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25 236,20 236,30 226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25 351,20 351,30 341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
プロパティ
親である Element からプロパティを継承し、GlobalEventHandlers と TouchEventHandlers からのプロパティを実装しています。
HTMLElement.accessKey- 要素に割り当てられたアクセスキーを表す
DOMStringです。 HTMLElement.accessKeyLabel読取専用- 要素に割り当てられたアクセスキーを含む
DOMStringを返します。 HTMLElement.contentEditableDOMString。この文字列が"true"の場合は要素が編集可能、"false"の場合は編集不可です。HTMLElement.isContentEditable読取専用- 要素のコンテンツが編集可能か否かを示す
Booleanを返します。 HTMLElement.contextMenu- 要素に割り当てたコンテキストメニューを表す
HTMLMenuElementです。nullになる可能性があります。 HTMLElement.dataset読取専用- 要素の カスタムデータ属性 (
data-*) を読み書きできるスクリプトのDOMStringMapを返します。 HTMLElement.dir- 要素の記述方向を表す
dirグローバル属性を反映するDOMStringです。可能な値は、"ltr"および"rtl"、"auto"です。 HTMLElement.draggable- 要素がドラッグ可能かどうかを示す
Booleanです。 HTMLElement.dropzone読取専用dropzoneグローバル属性を反映し、要素のドロップ操作に関する動作を記述するDOMSettableTokenListを返します。HTMLElement.hidden- 要素が hidden か否かを示す
Booleanです。 HTMLElement.itemScope- アイテムのスコープを表す
Booleanです。 HTMLElement.itemType読取専用DOMSettableTokenList… を返します。HTMLElement.itemId- アイテム ID を表す
DOMStringです。 HTMLElement.itemRef読取専用DOMSettableTokenList… を返します。HTMLElement.itemProp読取専用DOMSettableTokenList… を返します。HTMLElement.itemValue- アイテムの値を表す
Objectを返します。 HTMLElement.lang- 要素の属性およびテキスト、要素のコンテンツの言語を表す
DOMStringです。 HTMLElement.offsetHeight読取専用- レイアウトに対して相対的な要素の高さを含む
double値を返します。 HTMLElement.offsetLeft読取専用- この要素の左境界線からその
offsetParentの左境界線までの距離であるdouble値を返します。 HTMLElement.offsetParent読取専用- 現在計算済みのすべてのオフセット計算値からの要素である
Elementを返します。 HTMLElement.offsetTop読取専用- 要素の上境界線からその
offsetParentの上境界線までの距離であるdouble値を返します。 HTMLElement.offsetWidth読取専用- レイアウトに対して相対的な要素の幅を含む
double値を返します。 HTMLElement.properties読取専用HTMLPropertiesCollection… を返します。HTMLElement.spellcheck- スペルチェック を制御する
Booleanです。これはすべての HTML 要素上で提供されていますが、すべての要素に効果があるとは限りません。 HTMLElement.style- 要素の style 属性の宣言を表すオブジェクトである
CSSStyleDeclarationです。 HTMLElement.tabIndex- タブ順内の要素の位置を表す
long値です。 HTMLElement.title- マウスポインターが要素上に置かれた時に現れるポップアップボックスのテキストを含む
DOMStringです。 HTMLElement.translate- translation を表す
Booleanです。
イベントハンドラー
onXYZ 形式のほとんどのイベントプロパティは、GlobalEventHandlers または TouchEventHandlers で定義されており、HTMLElement により実装されています。さらに HTMLElement 固有のイベントプロパティがいくつかあります。
HTMLElement.oncopycopyイベントのイベントハンドリングコードを返します (バグ 280959)。HTMLElement.oncutcutイベントのイベントハンドリングコードを返します (バグ 280959)。HTMLElement.onpastepasteイベントのイベントハンドリングコードを返します (バグ 280959)。TouchEventHandlers.ontouchstarttouchstartイベントのイベントハンドリングコードを返します。TouchEventHandlers.ontouchendtouchendイベントのイベントハンドリングコードを返します。TouchEventHandlers.ontouchmovetouchmoveイベントのイベントハンドリングコードを返します。TouchEventHandlers.ontouchentertouchenterイベントのイベントハンドリングコードを返します。TouchEventHandlers.ontouchleavetouchleaveイベントのイベントハンドリングコードを返します。TouchEventHandlers.ontouchcanceltouchcancelイベントのイベントハンドリングコードを返します。
メソッド
親である Element からメソッドを継承しています。
HTMLElement.blur()- 現在フォーカスされている要素からキーボードフォーカスを外します。
HTMLElement.click()- 要素にマウスクリックイベントを送信します。
HTMLElement.focus()- 要素に現在のキーボードフォーカスを当てます。
HTMLElement.forceSpellCheck()- 要素上のコンテンツに対してスペルチェックを実行します。
仕様
| 仕様書 | 策定状況 | 備考 |
|---|---|---|
| CSS Object Model (CSSOM) View Module HTMLElement の定義 |
草案 | 次のプロパティを追加: offsetParent, offsetTop, offsetLeft, offsetWidth, offsetHeight。 |
| HTML Living Standard HTMLElement の定義 |
現行の標準 | 次のプロパティを追加: translate, itemScope, itemType, itemId, itemRef, itemProp, properties, itemValue。次のメソッドを追加: forceSpellcheck()。onXYZ 属性を GlobalEventHandlers インターフェイスへ移動し、そこから継承したプロパティを追加。 |
| HTML5 HTMLElement の定義 |
勧告 | 次のプロパティを追加: dataset, hidden, tabindex, accessKey, accessKeyLabel, draggable, dropzone, contentEditable, isContentEditable, contextMenu, spellcheck, commandType, commandLabel, commandIcon, commandHidden, commandDisabled, commandChecked, style, およびすべての onXYZ プロパティ。id と className プロパティを Element インターフェイスへ移動。 |
| Document Object Model (DOM) Level 2 HTML Specification HTMLElement の定義 |
廃止された | Document Object Model (DOM) Level 2 HTML Specification からの変更なし。 |
| Document Object Model (DOM) Level 1 Specification HTMLElement の定義 |
廃止された | 初期定義。 |
ブラウザーの実装状況
現在、互換性データを可読形式の JSON フォーマットに置き換えているところです。
この互換性一覧は古い形式を使っており、これに含まれるデータの置き換えが済んでいません。
手助けしていただける場合は、こちらから！
| 機能 | Firefox (Gecko) | Chrome | Edge | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| 基本サポート | 1.0 (1.7 or earlier) | ? | (有) | ? | ? | ? |
accessKey |
5.0 (5.0) | 17.0 | (有) | ? | ? | 6.0 |
accessKeyLabel |
8.0 (8.0) | ? | 未サポート | ? | ? | 未サポートWebKit bug 72715 |
blur() |
5.0 (5.0) | ? | (有) | 9 | ? | ? |
click() |
5.0 (5.0) | ?9 | (有) | 9 | ? | 6.0 |
dataset |
6.0 (6.0) | 8 | (有) | 11 | 11.10 | 5.1 |
focus() |
5.0 (5.0) | ? | (有) | 9 | ? | ? |
contentEditable |
3.0 (1.9) | (有) | (有) | 5.5 | 9 | (有) |
spellcheck |
2.0 (1.8.1) | ? | (有) | ? | ? | ? |
style |
(有) (CSSStyleDeclaration ではなく CSS2Properties を返す) |
(有) | (有) | (有) | (有) | (有) |
forceSpellCheck() |
未サポート | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート |
draggable |
(有) | ? | (有) | ? | 12.0 | ? |
dropzone |
未サポート | 未サポート | 未サポート | 未サポート | 12.0 | 未サポート |
offsetLeft, offsetTop, offsetParent, offsetHeight, offsetWidth |
(有) | ? | (有) | (有) | ? | ? |
translate |
未サポート | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート |
itemScope, itemType, itemRef, itemId, itemProp, itemValue |
6.0 (6.0) | 未サポート | 未サポート | 未サポート | 11.60 (Opera 15 で削除) |
未サポート |
properties |
(有) | ? | 未サポート | ? | ? | ? |
HTMLElement.ontouchstart, HTMLElement.ontouchend, HTMLElement.ontouchmove, HTMLElement.ontouchenter, HTMLElement.ontouchleave, HTMLElement.ontouchcancel |
(有) | (有) | 未サポート | 未サポート | ? | (有) |
HTMLElement.oncopy, HTMLElement.oncut, HTMLElement.onpaste |
3.0 (1.9) | ? | (有) | ? | ? | ? |
| 機能 | Firefox Mobile (Gecko) | Android | Edge | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| 基本サポート |
1.0 (1.0) |
? | (有) | ? | ? | ? |
accessKey |
5.0 (5.0) | ? | (有) | ? | ? | ? |
accessKeyLabel |
8.0 (8.0) | ? | 未サポート | ? | ? | ? |
blur() |
5.0 (5.0) | ? | (有) | ? | ? | ? |
click() |
5.0 (5.0) | ? | (有) | ? | ? | ? |
dataset |
6.0 (6.0) | ? | (有) | ? | ? | ? |
focus() |
5.0 (5.0) | ? | (有) | ? | ? | ? |
HTMLElement.oncopy, HTMLElement.oncut, HTMLElement.onpaste |
1.0 (1.9) | ? | (有) | ? | ? | ? |
関連情報
Elementインタフェース