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.

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

Пример

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
# htmlimageelement

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
HTMLImageElement
Image() constructor
align
Deprecated
alt
attributionSrc
Experimental
border
Deprecated
complete
crossOrigin
currentSrc
decode()
decoding
fetchPriority
height
hspace
Deprecated
isMap
loading
longDesc
Deprecated
lowsrc
Deprecated
name
Deprecated
naturalHeight
naturalWidth
referrerPolicy
no-referrer-when-downgrade
origin-when-cross-origin
unsafe-url
sharedStorageWritable
Experimental
sizes
auto value
src
srcset
useMap
vspace
Deprecated
width
x
y

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
Deprecated. Not for use in new websites.
See implementation notes.
Uses a non-standard name.
Has more compatibility info.

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

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