HTMLElement
インターフェイスは、任意の HTML 要素を表します。要素によってはこのインターフェイスで直接実装しており、その他の要素はこれを継承したインターフェイスを通して実装されています。
プロパティ
親である Element
からプロパティを継承しており、DocumentAndElementEventHandlers
, ElementCSSInlineStyle
, GlobalEventHandlers
, HTMLOrForeignElement
, TouchEventHandlers
からのプロパティを実装しています。
HTMLElement.accessKey
- 要素に割り当てられたアクセスキーを表す
DOMString
です。 HTMLElement.accessKeyLabel
読取専用- 要素に割り当てられたアクセスキーを含む
DOMString
を返します。 HTMLElement.contentEditable
DOMString
。この文字列がtrue
の場合は要素が編集可能、false
の場合は編集不可です。HTMLElement.isContentEditable
読取専用- 要素のコンテンツが編集可能か否かを示す
Boolean
を返します。 HTMLElement.contextMenu
- 要素に割り当てたコンテキストメニューを表す
HTMLMenuElement
です。null
になる可能性があります。 HTMLOrForeignElement.dataset
読取専用- 要素の カスタムデータ属性 (
data-*
) を読み書きできるスクリプトのDOMStringMap
を返します。 HTMLElement.dir
- 要素の記述方向を表す
dir
グローバル属性を反映するDOMString
です。可能な値は、"ltr"
および"rtl"
、"auto"
です。 HTMLElement.draggable
- 要素がドラッグ可能かどうかを示す
Boolean
です。 HTMLElement.dropzone
読取専用dropzone
グローバル属性を反映し、要素のドロップ操作に関する動作を記述するDOMSettableTokenList
を返します。HTMLElement.hidden
- 要素が hidden か否かを示す
Boolean
です。 HTMLElement.inert
Boolean
で、ユーザー操作イベント、ページ内テキスト検索 (「ページ内を検索」)、テキストの選択において、ユーザーエージェントが指定したノードがないかのように動作するかどうかを示します。HTMLElement.innerText
- ノードやその子孫の「描画される」テキストの内容を表します。ゲッターとしては、およそユーザーがカーソルで要素の内容を選択してからクリップボードにコピーしたときのテキストに相当します。
HTMLElement.itemScope
- アイテムのスコープを表す
Boolean
です。 HTMLElement.itemType
読取専用DOMSettableTokenList
… を返します。HTMLElement.itemId
- アイテム ID を表す
DOMString
です。 HTMLElement.itemRef
読取専用DOMSettableTokenList
… を返します。HTMLElement.itemProp
読取専用DOMSettableTokenList
… を返します。HTMLElement.itemValue
- アイテムの値を表す
Object
を返します。 HTMLElement.lang
- 要素の属性およびテキスト、要素のコンテンツの言語を表す
DOMString
です。 HTMLElement.noModule
Boolean
であり、モジュールスクリプトに対応しているユーザーエージェントでインポートしたスクリプトが実行されるかどうかを示します。HTMLOrForeignElement.nonce
- 指定されたフェッチが実行を許可されるかどうかを判断するために Content Security Policy が使用する、一度だけ使用される暗号学的な数値を返します。
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
です。 HTMLOrForeignElement.tabIndex
- タブ順内の要素の位置を表す
long
値です。 HTMLElement.title
- マウスポインターが要素上に置かれた時に現れるポップアップボックスのテキストを含む
DOMString
です。 HTMLElement.translate
- translation を表す
Boolean
です。
イベントハンドラー
ほとんどのイベントハンドラープロパティは、onXYZ
の形であり、DocumentAndElementEventHandlers
, GlobalEventHandlers
, TouchEventHandlers
の何れかのインターフェイスで定義されていて、HTMLElement
により実装されています。さらに HTMLElement
固有のイベントプロパティがいくつかあります。
HTMLElement.oncopy
copy
イベントのイベントハンドリングコードを返します (バグ 280959)。HTMLElement.oncut
cut
イベントのイベントハンドリングコードを返します (バグ 280959)。HTMLElement.onpaste
paste
イベントのイベントハンドリングコードを返します (バグ 280959)。TouchEventHandlers.ontouchstart
touchstart
イベントのイベントハンドリングコードを返します。TouchEventHandlers.ontouchend
touchend
イベントのイベントハンドリングコードを返します。TouchEventHandlers.ontouchmove
touchmove
イベントのイベントハンドリングコードを返します。TouchEventHandlers.ontouchenter
touchenter
イベントのイベントハンドリングコードを返します。TouchEventHandlers.ontouchleave
touchleave
イベントのイベントハンドリングコードを返します。TouchEventHandlers.ontouchcancel
touchcancel
イベントのイベントハンドリングコードを返します。
メソッド
親である Element
からメソッドを継承しており、DocumentAndElementEventHandlers
, ElementCSSInlineStyle
, GlobalEventHandlers
, HTMLOrForeignElement
, TouchEventHandlers
からのメソッドを実装しています。
HTMLElement.attachInternals()
ElementInternals
のインスタンスをカスタム要素に割り当てます。HTMLOrForeignElement.blur()
- 現在フォーカスされている要素からキーボードフォーカスを外します。
HTMLElement.click()
- 要素にマウスクリックイベントを送信します。
HTMLOrForeignElement.focus()
- 要素に現在のキーボードフォーカスを当てます。
HTMLElement.forceSpellCheck()
- 要素上のコンテンツに対してスペルチェックを実行します。
イベント
これらのイベントを待ち受けするには addEventListener()
を用いるか、イベントリスナーをこのインターフェイスの onイベント名
プロパティに代入するかしてください。
アニメーションイベント
animationcancel
- アニメーションが予期せず中断されたときに発行されます。
onanimationcancel
プロパティからも利用できます。 animationend
- アニメーションが正常に完了したときに発行されます。
onanimationend
プロパティからも利用できます。 animationiteration
- アニメーションが 1 回分完了したときに発行されます。
onanimationiteration
プロパティからも利用できます。 animationstart
- アニメーションが開始されたときに発行されます。
onanimationstart
プロパティからも利用できます。
入力イベント
beforeinput
<input>
,<select>
,<textarea>
のいずれかの要素が変更される前に発行されます。input
<input>
,<select>
,<textarea>
のいずれかの要素のvalue
が変更されたときに発行されます。
oninput
プロパティからも利用できます。change
<input>
,<select>
,<textarea>
のいずれかの要素のvalue
が変更され、ユーザーが確定したときに発行されます。input
イベントとは異なり、change
イベントは要素のvalue
が変更されるたびに発行されるわけではありません。
ポインターイベント
gotpointercapture
setPointerCapture()
を用いて要素がポインターをキャプチャしたときに発行されます。
ongotpointercapture
プロパティからも利用できます。lostpointercapture
- キャプチャされたポインターが解放されたときに発行されます。
onlostpointercapture
プロパティからも利用できます。 pointercancel
- ポインターイベントがキャンセルされたときに発行されます。
onpointercancel
プロパティからも利用できます。 pointerdown
- ポインターがアクティブになったときに発行されます。
onpointerdown
プロパティからも利用できます。 pointerenter
- ポインターが要素またはその子孫の一つのヒットテスト境界に入ったときに発行されます。
onpointerenter
プロパティからも利用できます。 pointerleave
- ポインターが要素のヒットテスト境界から出たときに発行されます。
onpointerleave
プロパティからも利用できます。 pointermove
- ポインターの座標が変化したときに発行されます。
onpointermove
プロパティからも利用できます。 pointerout
- ポインターが要素のヒットテスト境界を (他の理由で) 出たときに発行されます。
onpointerout
プロパティからも利用できます。 pointerover
- ポインターが要素のヒットテスト境界に入ったときに発行されます。
onpointerover
プロパティからも利用できます。 pointerup
- ポインターがアクティブではなくなったときに発行されます。
onpointerup
プロパティからも利用できます。
トランジションイベント
transitioncancel
- CSS トランジションがキャンセルされたときに発行されます。
ontransitioncancel
プロパティからも利用できます。 transitionend
- CSS トランジションが完了したときに発行されます。
ontransitionend
プロパティからも利用できます。 transitionrun
- CSS トランジション が最初に作成されたときに発行されます。
ontransitionrun
プロパティからも利用できます。 transitionstart
- CSS トランジションが実際に開始されたときに発行されます。
ontransitionstart
プロパティからも利用できます。
仕様書
s
仕様書 | 状態 | 備考 |
---|---|---|
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 の定義 |
廃止 | 初回定義 |
ブラウザーの互換性
BCD tables only load in the browser