XML DOM HTMLElement オブジェクト

HTMLElementオブジェクトはHTML中の要素を表現しています。

HTMLElementオブジェクトの属性

HTMLドキュメントの各要素は、要素のHTML属性に対応する属性を持っています。ここにすべてのHTMLタグがサポートする属性がリストされています。他の属性は、特定のHTMLタグ固有です。HTMLElementオブジェクトは以下を継承しています: Node および Element オブジェクトの標準属性であり、以下に説明するいくつかの非標準属性も実装しています:

className

要素のclass属性を規定しています。注意:この属性名は"class"ではありません。なぜなら、"class"はJavaScriptの保留語だからです。

タイプ:String。状態:書き換え可能。

currentStyle

この特定のIE固有の属性は、要素のすべてのCSS属性のカascadingグループに適用されます。これはWindow.getComputedStyle()のIE固有の代替です。

タイプ:String。状態:書き換え可能。

dir

要素のdir属性を規定しています。ドキュメントのテキストの方向を宣言しています。

タイプ:String。状態:書き換え可能。

id

要素のid属性を規定しています。ドキュメント内で、同じid値を持つ要素は2つ以上存在しません。

タイプ:String。状態:書き換え可能。

innerHTML

要素に含まれる文字列を規定しています。要素自身の開始タグと終了タグは含まれません。この属性をクエリすることで、要素の内容がHTMLテキストとして返されます。この属性をHTMLテキストとして設定すると、要素の内容をHTMLの解析表現で置き換えることができます。ドキュメントの読み込み時にこの属性は設定できません。これはIE4から始まった非標準属性ですが、すべての現代のブラウザでサポートされています。

タイプ:String。状態:書き換え可能。

lang

要素のlang属性は、要素内容の言語コードを宣言しています。

タイプ:String。状態:書き換え可能。

offsetHeight, offsetWidth

要素の高さと幅をピクセル単位で返します。これは非標準ですが、非常にサポートされている属性です。

タイプ:int。状態:読み取り専用。

offsetLeft

現在の要素の左端がその含み要素の左端までのピクセル単位でのオフセットを返します。

タイプ:int。状態:読み取り専用。

offsetTop

現在の要素の上端がその含み要素の上端までのピクセル単位でのオフセットを返します。

タイプ:int。状態:読み取り専用。

offsetParent

最も近い動的配置された含み要素への参照を返します。すべてのオフセットは、その要素に基づいて決定されます。要素のstyle.displayがnoneに設定されている場合、この属性はnullを返します。これは非標準ですが、非常にサポートされている属性です。

タイプ:Node。状態:読み取り専用。

scrollHeight, scrollWidth

要素の完全な高さと幅をピクセル単位で返します。要素にスクロールバーがある場合(例えば、CSSのoverflow属性によるもの)、これらの属性はoffsetHeightとoffsetWidthと異なります。offsetHeightとoffsetWidthは、要素の見える部分の大きさのみを報告します。これは非標準ですが、非常にサポートされている属性です。

タイプ:int。状態:読み取り専用。

scrollTop, scrollLeft

要素の左端または上端にスクロールされたピクセル数を設定または返します。要素にスクロールバーがある場合(例えば、要素の CSS overflow 属性が auto に設定されている場合)のみ、これらのピクセルが有効です。これらの属性は、ドキュメントの <body> や <html> タグ上にのみ定義されます(これはブラウザに関連しています)そして、ドキュメントのスクロール位置を決定するために一緒に使用されます。これらの属性は、<iframe> タグのスクロール量を指定しません。これは非標準ですが、非常にサポートされている属性です。

タイプ:int。状態:書き換え可能。

style

現在の要素に設定されたインライン CSS スタイルの style 属性の値を返します。この属性の値は文字列ではありません。注意してください。

タイプ:CSS2Properties。状態:読み取り専用。

title

要素の title 属性を定義します。マウスが要素に乗ったとき、多くのブラウザが「ツールチップ」にこの属性の値を表示します。

タイプ:String。状態:書き換え可能。

HTMLElement オブジェクトのメソッドを継承しています。

HTMLElement オブジェクトは、 Node および Element オブジェクトの標準メソッド。特定のタグに特化したメソッドを実装する要素もあります。CodeW3C.com では、 HTML DOM リファレンスマニュアルの各タグ参照ページで、これらのメソッドの情報が提供されています。

ほとんどの現代ブラウザは以下の非標準メソッドを実装しています:

メソッド 説明
scrollIntoView() ドキュメントをスクロールし、この要素をウィンドウの顶部または底部に表示します。

HTMLElement オブジェクトのイベントハンドラ

マウスとキーボードイベントに対応するすべての HTML 要素はここにリストされているイベントハンドラをトリガーできます。リンクやボタンなどの一部の要素は、これらのイベントが発生したときにデフォルトの操作を実行します。このような要素については、以下でさらに詳細な情報を取得できます:特定の要素のリファレンスページ中に見つけることができます。

参照してください。 HTML イベント属性リファレンスマニュアル、HTML イベントハンドラに関する情報をさらに詳しく学びます。

HTMLElement オブジェクトに関する詳細な情報を得る方法

CodeW3C.com の HTML DOM リファレンスマニュアルでは、HTML マークアップに対応する DOM オブジェクトに対して特別なリファレンスページを作成しました:

HTML DOM リファレンスマニュアル

関連ページ

XML DOM リファレンスマニュアル:Document オブジェクト

XML DOM リファレンスマニュアル:Document.getElementById()

XML DOM リファレンスマニュアル:Document.getElementsByTagName()