HTMLImageElement

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

Свойства

Наследует свойства родителя, 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 Только для чтения Non-standard long The horizontal offset from the nearest layer. (Mimic an old Netscape 4 behavior)
y Только для чтения Non-standard 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);

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

Specification
HTML Standard
# htmlimageelement

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

BCD tables only load in the browser

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

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