<img>【画像 (Image)】

概要 構文 DOMインタフェース

概要

メモ

画像の定義
- ツールチップ表示：title【説明文】属性に設定 (ほぼ対応)
- 画像を表示する以外 (レイアウト上のスペーサー等) の利用は原則禁止
ハイパーリンク設定
- <map>【イメージマップ】と関連付け
  ( usemap【イメージマップ名 (#～)】属性に <map>【イメージマップ】のname【イメージマップ名】属性を指定 )
- 画像を分割して各々ハイパーリンクの設定が可能 (<map>【イメージマップ】の例参照)

例

<img src="～.gif" width="32" height="32" title="サンプル画像">

CSS (一部)

スタイル	スタイル定義
左右余白	margin-left・margin-right
上下余白	margin-top・margin-bottom
余白	margin【マージン (外部間隔)】
ボーダー幅	border-width【境界線の幅】・border-style
ボーダー	border【境界線】

外部リンク

WHATWG HTML (英語)
- 4.8.3 The img element
W3C HTML 5.2 (英語)
- 4.7.5. The img element
W3C HTML 5.1 2nd Edition (英語)
- 4.7.5. The img element
W3C HTML5 (英語)
- 4.7.1 The img element

構文

<img

必須

開始タグ

align=top | middle | bottom | left | right

テキスト位置・画像位置

alt=【代替テキスト】

代替テキスト

border=【ピクセル数】

ボーダー幅代替：スタイルシート (border-width・border-style)

crossorigin=anonymous | use-credentials

CORS(Cross-Origin Resource Sharing) 指定 (anonymous：認証情報未使用 | use-credentials：認証情報使用)

decoding=async | auto | sync

プレゼンテーション用のデコードヒント

async	他のコンテンツと同期的にデコード
auto	自動 (設定なし)
sync	他のコンテンツと非同期にデコード

height=【高さ】

高さ

hspace=【ピクセル数】

左右余白代替：スタイルシート (margin・margin-left・margin-right)

ismap

サーバサイドイメージマップ指定 (クリック座標サーバ送信)

longdesc=【詳細説明文へのリンク】

詳細説明文へのリンク (alt属性の補完)

name=【名前】

名前

referrerpolicy=【リファラーポリシー】

リファラーポリシー (W3C：Referrer Policy (英語))

値	参照元情報の送信
"" (空文字列)	上位ポリシー利用
"no-referrer"	送信なし
"no-referrer-when-downgrade"	セキュリティレベルが低下(TLS 保護：あり → なし)：送信なしその他：送信あり
"origin"	オリジンのみ送信
"origin-when-cross-origin"	クロスオリジン：オリジンのみ送信その他：送信あり
"same-origin"	同一オリジンへ移動：送信ありその他：送信なし
"strict-origin"	セキュリティレベルが低下(TLS 保護：あり → なし)：送信なしその他：オリジンのみ送信
"strict-origin-when-cross-origin"	セキュリティレベルが上昇(TLS 保護：なし → あり)：オリジンのみ送信セキュリティレベルが低下(TLS 保護：あり → なし)：送信なしその他：送信あり
"unsafe-url"	送信あり (安全でない)

sizes=【ソースサイズのセット (複数：カンマ区切り)】

イメージサイズ

src=【リソースURL】

必須

リソースURL

srcset=【リソースURL [記述子](複数：カンマ区切り)】

リソースURLセット
記述子：数値w（幅) / 数値x（画素密度) / 省略 (1x)

usemap=【イメージマップ名 (#～)】

イメージマップ名
(<map>【イメージマップ】のname【イメージマップ名】属性の前に#を付けたもの)

vspace=【ピクセル数】

上下余白代替：スタイルシート (margin・margin-top・margin-bottom)

width=【幅】

幅

【グローバル属性】

accesskey=【アクセスキー (複数：半角スペース区切り)】

アクセスキー

class=【クラス名 (複数：半角スペース区切り)】

所属クラス (複数指定：<style>【スタイル情報】)・外部スタイルシートで後から定義したほうが優先

contenteditable [ ="" (可能) | true (可能) | false (不可) | inherit (親要素継承) ]

編集可否

contextmenu=<menu>【メニュー】のid

コンテキストメニューのid

data-*=【カスタムデータ】

カスタムデータ属性

dir=ltr (左から右) | rtl (右から左) | auto (自動)

文字表記方向 (ltr：left to right text or table / rtl：right to left text or table)
※<bdo>【テキスト方向形式】の場合、ltr または rtlが必須

draggable=true (ドラッグ可能) | false (ドラッグ不可) | auto (ブラウザ既定)

ドラッグ可否

dropzone=copy (ドロップデータのコピー) | move (ドロップデータを移動) | link (ドロップデータのリンク)

ドロップデータの扱い

hidden

非表示

id=【id】

id (ドキュメント中で一意 name【コントロール名 (送信データ名)】を含む)
(<a>【ハイパーリンク】のリンク先・CSS対象(#～)・スクリプト参照)

is=【定義名】

定義名

itemid=【URL】

アイテムのグローバル識別子

itemprop=【アイテムのプロパティ (複数：半角スペース区切り)】

アイテムのプロパティ

itemref=【要素IDのリスト】

アイテムの参照リスト

itemscope

アイテムのプロパティ宣言

itemtype=【アイテムの型 (複数：半角スペース区切り)】

アイテムの型

lang=【言語コード】

言語コード (【主コード】-【副コード】例："ja"：日本語 / "en"：英語 / "en-US"：アメリカ英語)

slot=<slot>【スロット】のname属性

スロット名

spellcheck=true | false

スペルチェック有無

style=【スタイルシート (複数：セミコロン区切り / 最後のセミコロンは省略可)】

スタイル

tabindex=【タブインデックス番号】

タブインデックス

title=【説明文】

説明 (多くはツールチップ表示)
※<link>【メタデータリンク】：メタデータリンクのタイトル
※<style>【スタイル情報】：スタイルシート名

translate="" (翻訳対象) | yes (翻訳対象) | no (翻訳対象外)

翻訳可否

DOMインタフェース (HTMLImageElement・HTMLElement)

[NamedConstructor=Image(optional unsigned long width, optional unsigned long height)]			コンストラクタ
interface HTMLImageElement : HTMLElement {			W3C：interface HTMLImageElement (英語) HTML 5.1 ・HTML 5.2 ・WHATWG
【プロパティ】
【HTMLImageElement プロパティ】
		alt;	代替テキスト
		complete;	処理の完了状態 (失敗も含む)
	?	crossOrigin;	CORSの認証情報使用有無
		decoding;	プレゼンテーション用のデコードヒント
	attribute unsigned long	height;	高さ (表示)
		isMap;	サーバサイドイメージマップ指定
		longDesc;	詳細説明文へのリンク (alt属性の補完)
	attribute unsigned long	naturalHeight;	高さ (オリジナル)
	attribute unsigned long	naturalWidth;	幅 (オリジナル)
		referrerPolicy;	リファラーポリシー
		sizes;	ソースのサイズのセット
		src;	リソースURL
		srcset;	リソースURLセット
		useMap;	イメージマップ名
	attribute unsigned long	width;	幅 (表示)
【HTMLElement プロパティ】W3C：interface HTMLElement (英語) HTML 5.1・HTML 5.2・WHATWG
		accessKey;	アクセスキー
		accessKeyLabel;	アクセスキー表現文字列
		contentEditable;	編集可能状態 ("true"：編集可能 / "false"：編集不可 / "inherit"：親要素継承)
	Map	dataset;	カスタムデータ属性 (data-*) マップ
		dir;	文字表記方向 ("ltr"：左から右 / "rtl"：右から左)
		draggable;	ドラッグ可否
[PutForwards=value]	attribute DOMTokenList	dropzone;	ドロップデータの扱い
		hidden;	非表示状態
[TreatNullAs=EmptyString]		innerText;	内容 (テキスト形式)
		isContentEditable;	編集可否
		lang;	言語コード
		spellcheck;	スペルチェック有無
	attribute long	tabIndex;	タブインデックス
		title;	説明
		translate;	翻訳可否
【ElementCSSInlineStyle プロパティ】 HTMLElement implements ElementCSSInlineStyle; W3C：interface ElementCSSInlineStyle (英語)
	attribute CSSStyleDeclaration	style;	スタイル
	【CSSStyleDeclaration プロパティ】 (仕様上、次と同等： CSSStyleDeclaration implements CSS2Properties) W3C：Interface CSS2Properties (英語)
		style.～;	スタイル属性 (例：style.color・style.backgroundColor)
【Element プロパティ】interface HTMLElement : Element W3C：Interface Element (英語) HTML 5.1・HTML 5.2・WHATWG
[SameObject]	attribute NamedNodeMap	attributes;	関連属性マップ
[SameObject]	attribute DOMTokenList	classList;	クラス名リスト
		className;	クラス名
		id;	id (ページ内で一意：name【コントロール(送信)名】を含む)
	(	innerHTML;)	内容 (HTML形式) W3C：未定義 (参照：Element.outerHTML・Node.textContent (innerText))
		localName;	ローカル名
	?	namespaceURI;	ネームスペースURI
	(	outerHTML;)	タグを含む内容 (HTML形式) W3C：未定義 (参照：Element.innerHTML・Node.textContent (innerText))
	?	prefix;	プリフィックス
		tagName;	タグ名
【Node プロパティ】 interface Element : Node W3C：Interface Node (英語) HTML 5.1・HTML 5.2・WHATWG
	?	baseURI;	ベースURI
[SameObject]		childNodes;	子ノードリスト
	?	firstChild;	先頭子ノード
	?	lastChild;	最終子ノード
	?	nextSibling;	次の兄弟ノード
		nodeName;	ノード名
	attribute unsigned short	nodeType;	ノードタイプ (ELEMENT_NODE / ATTRIBUTE_NODE / TEXT_NODE / CDATA_SECTION_NODE / ENTITY_REFERENCE_NODE / ENTITY_NODE / PROCESSING_INSTRUCTION_NODE / COMMENT_NODE / DOCUMENT_NODE / DOCUMENT_TYPE_NODE / DOCUMENT_FRAGMENT_NODE / NOTATION_NODE)
	?	nodeValue;	ノード値
	?	ownerDocument;	オーナードキュメント
	?	parentElement;	親エレメント
	?	parentNode;	親ノード
	?	previousSibling;	前の兄弟ノード
	?	textContent; (IE：innerText)	内容 (Text形式) (参照：Element.innerHTML・Element.outerHTML) 取得：要素内のHTMLタグを除外しテキストのみ設定：HTMLタグはテキスト変換
【GlobalEventHandlers プロパティ (一部) 】 HTMLElement implements GlobalEventHandlers; W3C：interface GlobalEventHandlers (英語) HTML 5.1・HTML 5.2・WHATWG
	attribute EventHandler onabort;	on～;	イベントハンドラ (例：onclick・onfocus)
【ParentNode プロパティ】Element implements ParentNode; W3C：Interface ParentNode (英語)
	attribute unsigned long	childElementCount;	子エレメントの数
[SameObject]	attribute HTMLCollection	children;	子エレメントコレクション
	?	firstElementChild;	最初の子エレメント
	?	lastElementChild;	最後の子エレメント
【NonDocumentTypeChildNode プロパティ】Element implements NonDocumentTypeChildNode; W3C：Interface NonDocumentTypeChildNode (英語)
	?	previousElementSibling;	前の兄弟エレメント
	?	nextElementSibling;	次の兄弟エレメント
【メソッド】
【HTMLElement メソッド】W3C：interface HTMLElement (英語) HTML 5.1・HTML 5.2・WHATWG
void click();			クリック操作
void focus();			フォーカス設定操作
void forceSpellCheck();			スペルチェック
void blur();			フォーカス喪失操作
【Element メソッド】interface HTMLElement : Element W3C：Interface Element (英語)
? getAttribute( name);			属性取得
? getAttributeNS(? namespace, localName);			属性取得 (ネームスペース指定)
HTMLCollection getElementsByClassName( classNames);			エレメントコレクション取得 (クラス名指定)
HTMLCollection getElementsByTagName( localName);			エレメントコレクション取得 (タグ名指定)
HTMLCollection getElementsByTagNameNS(? namespace, localName);			エレメントコレクション取得 (ネームスペース・タグ名指定)
boolean hasAttribute( name);			属性チェック
boolean hasAttributeNS(? namespace, localName);			属性チェック (ネームスペース指定)
void removeAttribute( name);			属性削除
void removeAttributeNS(? namespace, localName);			属性削除 (ネームスペース指定)
void setAttribute( name, value);			属性設定
void setAttributeNS(? namespace, name, value);			属性設定 (ネームスペース指定)
【Node メソッド】 interface Element : Node W3C：Interface Node (英語)
Node appendChild(Node node);			子ノード追加
[NewObject] Node cloneNode(optional boolean deep = false);			クローンノード作成
unsigned short compareDocumentPosition(Node other);			他ノードとの位置比較 (DOCUMENT_POSITION_DISCONNECTED / DOCUMENT_POSITION_PRECEDING / DOCUMENT_POSITION_FOLLOWING / DOCUMENT_POSITION_CONTAINS / DOCUMENT_POSITION_CONTAINED_BY / DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC)
boolean contains(Node? other);			指定子孫ノードの存在有無
boolean hasChildNodes();			子ノードの存在有無
Node insertBefore(Node node, Node? child);			指定ノード前挿入
boolean isDefaultNamespace(? namespace);			デフォルトネームスペースチェック
boolean isEqualNode(Node? node);			同一ノードチェック
? lookupNamespaceURI(? prefix);			ネームスペースURI調査
? lookupPrefix(? namespace);			ネームスペースプリフィックス調査
void normalize();			標準化
Node removeChild(Node child);			子ノード削除
Node replaceChild(Node node, Node child);			子ノード置換
【ParentNode メソッド】Element implements ParentNode; W3C：Interface ParentNode (英語)
Element? querySelector( selectors);			指定セレクタ先頭エレメント取得
[NewObject] NodeList querySelectorAll( selectors);			指定セレクタノードリスト取得
【ChildNode メソッド】Element implements ChildNode; W3C：Interface ChildNode (英語)
void remove();			削除
};

H 省略可	HTMLで省略可能
	HTML5 で追加
	HTML5 で廃止
	HTML5 で変更
	HTML 5.1 で追加
	HTML 5.1 で廃止
	HTML 5.1 で変更
	HTML 5.2 で追加
	HTML 5.2 で廃止
	HTML 5.2 で変更
特記なし	WHATWG で定義 (特記なしの場合、上記の追加・廃止・変更に従う)
	WHATWG で廃止
	CSS3 準拠
Link	別リファレンスリンク
Link	外部リンク

<img>【画像 (Image)】

概要

メモ

例

CSS (一部)

関連要素

外部リンク

構文

DOMインタフェース (HTMLImageElement・HTMLElement)