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 optionalunsigned
long
, the width and the height of the resource, creates an instance ofHTMLImageElement
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>