Image

Image DOM Level 2 HTML   изображение в HTML#документе Node→Element→HTMLElement→Image
Конструктор                         new Image(integer ширина, integer высота)
Аргументы                            ширина, высота
Ширина и высота изображения; могут не задаваться.
Свойства
String name   Это свойство определяет имя объекта изображения. Когда тег <img> имеет атрибут name, обратиться к соответствующему ему объекту Image можно как к одноименному свойству объекта Document.
String src
Доступная для чтения и для записи строка, указывающая URLадрес изображе
ния, отображаемого в броузере. Начальное значение этого свойства задается атри
бутом src тега <img>. Если установить это свойство равным URLадресу нового изо
бражения, броузер загрузит и отобразит новое изображение. Это свойство может
применяться для изменения внешнего вида страниц в ответ на действия пользова
теля, а также для создания простой анимации.
В дополнение к этим свойствам объекты Image поддерживают следующие свойства,
которые просто отражают HTMLатрибуты:
Свойство Атрибут Описание
String align (устаревшее) align Выравнивание относительно содержимого
String alt alt Текст, который выводится при невозможности ото
бразить изображение
String border (устаревшее) border Толщина рамки, окружающей изображение
long height height Высота изображения в пикселах
long hspace (устаревшее) hspace Ширина левого и правого полей в пикселах

boolean isMap ismap Признак использования карты изображений на
стороне сервера
String longDesc longdesc URI подробного описания изображения
String useMap usemap Определяет карту изображений на стороне клиента
long vspace (устаревшее) vspace Ширина верхнего и нижнего полей в пикселах
long width width Ширина изображения в пикселахОбработчики событий
Изображение наследует обработчики событий от объекта HTMLElement и дополнитель
но определяет следующие обработчики:
onabort Вызывается, если пользователь прерывает загрузку изображения.
onerror Вызывается, если происходит ошибка при загрузке изображения.
onload Вызывается при успешном завершении загрузки изображения.
Синтаксис HTML
Объект Image создается с помощью стандартного HTMLтега <img>. Некоторые атрибу
ты <img> в приведенном синтаксисе отсутствуют, т. к. в JavaScript они недоступны:
<img src="url" // Отображаемое изображение
width="пикселы" // Ширина изображения
height="пикселы" // Высота изображения
alt="описание" // Краткое описание изображения
[ onload="обработчик" ] // Вызывается, когда изображение полностью загружено
[ onerror="обработчик" ] // Вызывается в случае ошибки загрузки
[ onabort="обработчик" ] // Вызывается, если пользователь прерывает загрузку
>
ОписаниеОбъекты Image встраиваются в HTMLдокумент в виде тегов <img>. Изображения, при
сутствующие в документе, собираются в виде массива document.images[]. Изображе
ния, у которых установлен атрибут name, доступны также в виде одноименных свойств
объекта Document, например:
document.images[0] // Первое изображение в документе
document.banner // Изображение с атрибутом name="banner"
Свойство src объекта Image представляет наибольший интерес. Когда вы устанавлива
ете это свойство, броузер загружает и показывает изображение, заданное новым зна
чением. Это позволяет создавать такие эффекты, как смена изображений и анима
ция. Соответствующие примеры приводятся в главе 22.
Объекты Image можно динамически создавать в JavaScriptкоде с помощью функции
конструктора Image(). Обратите внимание: этот конструктор не имеет аргумента, за
дающего загружаемое изображение. Как и для изображений, созданных с помощью
HTMLкода, можно заставить броузер загрузить изображение, явно установив свой
ство src для любого созданного вами изображения. Нет возможности отобразить
в вебброузере созданный таким способом объект Image. Можно лишь заставить объ
ект Image загрузить изображение с помощью свойства src. Однако это может быть
удобно, поскольку при этом изображение попадает в кэш броузера. Позднее, если тотже URLадрес изображения указывается для одного из изображений в теге <img>, то
оно, будучи загруженным заранее, выводится быстро.
См. также Глава 22
Image.onabort DOM Level 2 Events
обработчик, вызываемый при прерывании загрузки изображения
Синтаксис
Function onabort
Описание
Свойство onabort объекта Image определяет функциюобработчик события, которая
вызывается, когда пользователь прерывает загрузку страницы (например, щелкнув
на кнопке Остановить) до того, как изображение успеет загрузиться.
Image.onerror DOM Level 2 Events
обработчик, вызываемый, когда в процессе загрузки
изображения возникает ошибка
Синтаксис
Function onerror
Описание
Свойство onerror объекта Image определяет функциюобработчик события, которая
вызывается, когда в процессе загрузки изображения возникает какаялибо ошибка.
Image.onload DOM Level 2 Events
обработчик, вызываемый по окончании загрузки изображения
Синтаксис
Function onload
Описание
Свойство onload объекта Image определяет функциюобработчик события, которая вы
зывается, когда загрузка изображения благополучно завершается. Подробности см.
в справочной статье об обработчике Window.onload.