HTMLImageElement

Интерфейс HTMLImageElement предоставляет специальные свойства и методы (расширяя обычный интерфейс HTMLElement ) для управления версткой и отображением элемента <img>.

Свойства

Наследует свойства родителя, HTMLElement.

Имя	Тип	Описание
`align`	`DOMString`	Указывает расположение картинки зависящее от окружающего контента.
`alt`	`DOMString`	Повторяет аттрибут HTML `alt` указывающий на запасной контекст картинки.
`border`	`DOMString`	Ширина рамки вокруг картинки.
`complete` Read only	`Boolean`	Принимает значение true если браузер получил картинку,и она имеет supported image type , а так-же была декодирована без ошибок .
`crossOrigin`	`DOMString`	The CORS setting for this image element. See CORS settings attributes for details.
`height`	`unsigned long`	Reflects the `height` HTML attribute, indicating the rendered height of the image in CSS pixels.
`hspace`	`long`	Space to the left and right of the image.
`isMap`	`Boolean`	Reflects the `ismap` HTML attribute, indicating that the image is part of a server-side image map.
`longDesc`	`DOMString`	URI of a long description of the image.
`lowSrc`	`DOMString`	A reference to a low-quality (but faster to load) copy of the image.
`name`	`DOMString`
`naturalHeight` Read only	`unsigned long`	Intrinsic height of the image in CSS pixels, if it is available; otherwise, `0`.
`naturalWidth` Read only	`unsigned long`	Intrinsic width of the image in CSS pixels, if it is available; otherwise, `0`.
`src`	`DOMString`	Reflects the `src` HTML attribute, containing the URL of the image.
`srcset`
`useMap`	`DOMString`	Reflects the `usemap` HTML attribute, containing a partial URL of a map element.
`vspace`	`long`	Space above and below the image.
`width`	`unsigned long`	Reflects the `width` HTML attribute, indicating the rendered width of the image in CSS pixels.
`x` Read only	`long`	The horizontal offset from the nearest layer. (Mimic an old Netscape 4 behavior)
`y` Read only	`long`	The vertical offset from the nearest layer. (Mimic an old Netscape 4 behavior)

Методы

Наследует методы родителя, HTMLElement.

HTMLImageElement.Image(): The Image() constructor, taking two optional unsigned long, the width and the height of the resource, creates an instance of HTMLImageElement not inserted in a DOM tree.

Пример

var img1 = new Image(); // Конструктор HTML5
img1.src = 'image1.png';
img1.alt = 'alt';
document.body.appendChild(img1);

var img2 = document.createElement('img'); // Используем HTMLImageElement
img2.src = 'image2.jpg';
img2.alt = 'alt text';
document.body.appendChild(img2);

// выбираем первое изображение на странице
alert(document.images[0].src);

Спецификации

Спецификация	Статус	Комментарий
WHATWG HTML Living Standard Определение 'HTMLAnchorElement' в этой спецификации.	Живой стандарт	The following property has been added: `srcset`.
HTML5 Определение 'HTMLAnchorElement' в этой спецификации.	Рекомендация	A constructor (with 2 optional parameters) has been added. The following properties are now obsolete: `name`, `border`, `align`, `hspace`, `vspace`, and `longdesc`. The following properties are now `unsigned long`, instead of `long`: `height`, and `width`. The following properties have been added: `crossorigin`, `naturalWidth`, `naturalHeight`, and `complete`.
Document Object Model (DOM) Level 2 HTML Specification Определение 'HTMLImgElement' в этой спецификации.	Рекомендация	The `lowSrc` property has been removed. The following properties are now `long`, instead of `DOMString`: `height`, `width`, `hspace`, and `vspace`.
Document Object Model (DOM) Level 1 Specification Определение 'HTMLImgElement' в этой спецификации.	Рекомендация	Initial definition.

Свойство	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Общая поддержка	(Да)	1.0 (1.7 или ранее)	(Да)	(Да)	(Да)
`lowSrc`	?	?	?	?	?
`naturalWidth`, `naturalHeight`	?	?	?	?	?
`crossorigin`	?	(Да)	?	?	?
`complete`	?	?	?	?	?
`srcset`	Нет	Нет	Нет	Нет	Нет
`x` and `y`	(Да)	(Да) [1]	Нет	(Да)	(Да)

Свойство	Android	Firefox Mobile (Gecko)	IE Phone	Opera Mobile	Safari Mobile
Общая поддержка	(Да)	1.0 (1.0)	(Да)	(Да)	(Да)
`lowSrc`	?	?	?	?	?
`naturalWidth`, `naturalHeight`	?	?	?	?	?
`crossorigin`	?	(Да)	?	?	?
`complete`	?	?	?	?	?
`srcset`	Нет	Нет	Нет	Нет	Нет
`x` and `y`	(Да)	(Да) [1]	Нет	(Да)	(Да)

[1] The x and y properties were removed in Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4) but restored in Gecko 14.0 (Firefox 14.0 / Thunderbird 14.0 / SeaMonkey 2.11) for compatibility reasons.

См. также

The HTML element implementing this interface: <img>