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.

Пример
------


```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 with JavaScript enabled. Enable JavaScript to view data.

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

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