HTMLImageElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨июль 2015 г.⁩.

* Some parts of this feature may have varying levels of support.

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

must be a string

Свойства

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

Имя	Тип	Описание
`align`	`DOMString`	Указывает расположение картинки зависящее от окружающего контента. Возможные значения: `"left"`, `"right"`, `"justify"`, и `"center"`.
`alt`	`DOMString`	Повторяет атрибут HTML `alt` указывающий на запасной контекст картинки.
`border`	`DOMString`	Ширина рамки вокруг картинки. Устарело и вместо него следует использовать свойство CSS `border`.
`complete` Только для чтения	`Boolean`	Возвращает true, если браузер закончил загрузку картинки с ошибкой или успешно. Также возвращает true, когда не установлено значение `src`, во всех остальных случаях - false.
`crossOrigin`	`DOMString`	Является `DOMString`, с настройками CORS для этого элемента изображения. Дополнительная информация: Атрибуты настроек CORS.
`currentSrc`Только для чтения Экспериментальная возможность	`DOMString`	Возвращает `DOMString` с URL-адресом текущего изображения (что может измениться, например, в ответ на запросы мультимедиа).
`height`	`unsigned long`	Отражает атрибут `height` HTML, указывая визуализированную высоту изображения в пикселях CSS.
`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` Только для чтения	`unsigned long`	Intrinsic height of the image in CSS pixels, if it is available; otherwise, `0`.
`naturalWidth` Только для чтения	`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` Только для чтения Не стандартно	`long`	The horizontal offset from the nearest layer. (Mimic an old Netscape 4 behavior)
`y` Только для чтения Не стандартно	`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);

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

Specification
HTML # htmlimageelement

Совместимость с браузерами

Смотрите также

Элемент HTML, реализующий этот интерфейс: <img>

Help improve MDN

Learn how to contribute

This page was last modified on ⁨15 апр. 2025 г.⁩ by MDN contributors.

View this page on GitHub • Report a problem with this content