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>.

EventTarget Node Element HTMLElement HTMLImageElement

Свойства

Наследует свойства родителя, 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.

Пример

js
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);

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

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 9 апр. 2026 г. by MDN contributors.

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

HTML DOM API
HTMLImageElement
Конструктор
1. Image()
Свойства экземпляра
Методы экземпляра
1. decode()
Наследование
Похожие страницы для HTML DOM
Руководства
1. Using microtasks in JavaScript with queueMicrotask()
2. In depth: Microtasks and the JavaScript runtime environment

HTMLImageElement

In this article

Свойства

Методы

Пример

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

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

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

Help improve MDN