HTMLImageElement

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

Свойства

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

Имя Тип Описание
align DOMString Указывает расположение картинки зависящее от окружающего контента. Возможные значения: "left", "right", "justify", и "center".
alt DOMString Повторяет атрибут HTML alt указывающий на запасной контекст картинки.
border DOMString Ширина рамки вокруг картинки. Устарело и вместо него следует использовать свойство CSS border.
complete Только для чтения Boolean (en-US) Возвращает true, если браузер закончил загрузку картинки с ошибкой или успешно. Также возвращает true, когда не установлено значение src (en-US), во всех остальных случаях - false.
crossOrigin DOMString Является DOMString, с настройками CORS для этого элемента изображения. Дополнительная информация: Атрибуты настроек CORS (en-US).
currentSrcТолько для чтения Экспериментальная возможность DOMString Возвращает DOMString с URL-адресом текущего изображения (что может измениться, например, в ответ на запросы мультимедиа).
height unsigned long Отражает атрибут height HTML, указывая визуализированную высоту изображения в пикселях CSS.
hspace long Space to the left and right of the image.
isMap Boolean (en-US) 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.

Пример

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

Совместимость

BCD tables only load in the browser

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

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