This page was translated from English by the community. Learn more and join the MDN Web Docs community.
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>.
Свойства
Наследует свойства родителя, 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 optionalunsignedlong, the width and the height of the resource, creates an instance ofHTMLImageElementnot 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 |
Совместимость с браузерами
Enable JavaScript to view this browser compatibility table.
Смотрите также
- Элемент HTML, реализующий этот интерфейс:
<img>