HTMLElement

ここへジャンプ:
  1. プロパティ
  2. メソッド
  3. 仕様
  4. ブラウザーの実装状況
  5. 関連情報

HTMLElement インターフェイスは、任意の HTML 要素を表します。いくつかの要素は直接このインターフェイスを実装し、他のものは HTMLElement を継承したインターフェイス経由で実装されています。

プロパティ

親である Element からプロパティを継承し、GlobalEventHandlers と TouchEventHandlers からのプロパティを実装しています。

HTMLElement.accessKey
要素に割り当てられたアクセスキーを表す DOMString です。
HTMLElement.accessKeyLabel 読取専用
要素に割り当てられたアクセスキーを含む DOMString を返します。
HTMLElement.contentEditable
DOMString。この文字列が "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.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 からメソッドを継承しています。

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 の定義		 廃止された 初期定義。

ブラウザーの実装状況

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

機能 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) ? (有) ? ? ?

関連情報

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

タグ: 
 このページの貢献者: Marsf, mamodayo, lv7777, AshfaqHossain, acid, ethertank, DavidWalsh
 最終更新者: Marsf,