HTMLImageElement インターフェイス

　HTMLImageElement インターフェイスは、画像を web ページに取り込むための <img> エレメントを定義したインターフェイスです。
　このインターフェイスでプロパティ、メソッド、イベントを定義しています。

HTMLImageElement 継承図

　扱える画像は、JPG、GIF、PNG、APNG、AVIF、SVG、WebP形式です。

- ad -

プロパティ(Properties)

　HTMLImageElement インターフェイスは以下の独自のプロパティをもちます。HTMLElement インターフェイスのプロパティも継承しています。

プロパティ	概要	分類
.alt	画像が読み込まれなかった場合の代替えテキストの設定と取得。DOMString 型
.complete	画像の読み込みが完了したか／否か。ただし判定に条件がある。Boolean 型
.crossOrigin	JavaScript の XMLHttpRequest を使用してリクエストをする際の CORS の設定を指定
.currentSrc	現在表示されている画像の URL。USVString 型
.decoding	データを画像として表示する方法（デコード方法）を指定。 DOMString 型
.fetchPriority	画像の取得の優先度を指定
.height	画像のレンダリング時の高さ。unsigned long 型
.isMap	イメージマップ <map> を利用するか／否か。boolean 型。
.loading	画像を読み込むタイミングを設定。 DOMStringt 型
.naturalHeight	実際の画像の高さ。unsigned long　型
.naturalWidth	実際の画像の幅。unsigned long　型
.referrerPolicy	画像を取得するためのリファラーを設定。DOMString 型
.sizes	カンマ区切りのサイズ設定。 DOMString 型
.src	画像ソースのURL。USVStringg 型
.srcset	条件による読み込む画像ソースのURLを設定。USVStringg 型
.useMap	<img> からイメージマップ <map> を指定する。<map> の name 属性の値に # を付ける。DOMString 型
.width	画像のレンダリング時の幅。unsigned long 型
.x	画像のレンダリングし始める位置、x座標。
.y	画像のレンダリングし始める位置、y座標。

　以下は、HTMLElement インターフェイスのプロパティと継承したプロパティです。参考にしてください。

Nodeのプロパティ一覧　

タイプ名（ハンドラー名）	概要	分類

Elementのプロパティ一覧　

タイプ名（ハンドラー名）	概要	分類

HTMLElementのプロパティ一覧　

タイプ名（ハンドラー名）	概要	分類

　HTMLImageElement インターフェイスは以下の独自のメソッドがあります。

メソッド	概要	分類
.decode()	画像が利用できるようになったかを Promise オブジェクト返す

　HTMLImageElement インターフェイスが継承したHTMLElement インターフェイスのメソッドです。 Node 、Element インターフェイスのメソッドを含みます。使えないものもあるので参考してください。

Nodeのメソッド一覧　

タイプ名（ハンドラー名）	概要	分類

Elementのメソッド一覧　

タイプ名（ハンドラー名）	概要	分類

HTMLElementのメソッド一覧　

タイプ名（ハンドラー名）	概要	分類

　HTMLImageElement にイベントハンドラーを定義する方法には以下があります。

HTMLImageElement.addEventListener( 'click', ()=>{...} )

HTMLImageElement.onclick = function(){...}

<button onclick = "..." >

　イベントについてはEventを参照してください。イベントの監視についてはEventTargetが担っています。

　以下は、HTMLImageElement が継承しているイベント一覧です。使えないものもあるので参考にしてください。

GlobalEventHandlersのイベント一覧　

タイプ名（ハンドラー名）	概要	分類

DocumentAndElementEventHandlersのイベント一覧　

タイプ名（ハンドラー名）	概要	分類

HTMLElementのイベント一覧　

タイプ名（ハンドラー名）	概要	分類

- ad -