IMG , статичный объект Image и элемент формы image. NN 3   IE 4   DOM 1

IMG отражает элемент HTML IMG. Этот объект отличается от статического объекта Image. Последний существует только в памяти броузера, а первый - объект элемента HTML, показываемый на странице. При создании объекта Image он не будет показан на странице. Чтобы показать его на странице, самый простой и повсеместно использующийся способ - присвоить его свойство src свойству src объекта IMG. Если при этом ширина и высота заменяющего изображения не соответствуют ширине и высоте заменяемого, страница перезагружается с изменёнными размерами (IE4+, NN6+). Другие броузеры (NN 4, Opera) в этом случае интерполируют изображение под старые размеры. В этом случае может помочь следующий код:

//Macromedia function for resize browser (Модернизирована AnK)
<script language="JavaScript">
<!--
function reloadPage(init) {
//reloads the window if browser resized
    if (init == true) with (navigator) {
//Не пройдут условие только NN 6+ и IE 4+ (исключаются Opera и пр.)
        if (( !((appName == "Netscape") && (parseInt(appVersion) >= 6))||((appName == "Microsoft Internet Explorer") && (parseInt(appVersion) >= 4)))) {
            document.MM_pgW=innerWidth;
            document.MM_pgH=innerHeight;
            onresize = reloadPage;
            }
        }
    else if (innerWidth != document.MM_pgW || innerHeight != document.MM_pgH)
        location.reload();
}
reloadPage(true);
// -->
</script>

Броузеры старых версий не поддерживают объект Image. Кроме того, некоторые пользователи отключают возможность показа изображений в настройках броузера. Решить эту проблему помогает следующая инструкция:

if (document.images) { }

Большинство представленных ниже элементов интерфейса относятся к элементу IMG.

Элемент формы image (поддерживаемый броузерами NN6 и IE4+) похож на элемент button, но свойство и атрибут value последнего заменено в нём на свойство и атрибут src. В основном используются такие свойства этого элемента, как complete, form, name, src и type.

Общие свойства, методы и обработчики событий объекта IMG и элемента формы image перечислены в разделе "Все злементы HTML"

 
Эквивалент HTML объекта IMG

<IMG>, <IMAGE>

Эквивалент HTML элемента формы image

<INPUT TYPE=IMAGE SRC="..URL..">

Создание статичного объекта Image
imageName = new Image([ширина, высота])

Объектно-ориентированная модель для IMG (для элемента формы image см. button)
NN [window.]document.imageName
[window.]document.images[i]
IE [window.]document.imageName
[window.]document.images[i]
[window.]document.all.elementID
NN 6/IE5+ [window.]document.getElementById("elementID")

Свойства:


align NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

Определяет, как элемент выровнен относительно окружающего текстового содержания. Большинство значений устанавливает вертикальные отношения между элементом и окружающим текстом. Например, чтобы выровнять основание элемента по базовой линии окружающего текста, значение свойства должно быть baseline. Элемент может быть "floated" по левому или правому краю , чтобы позволить окружающему тексту обтекать элемент.

 
Пример:

document.logoImg.align = "absmiddle"

 
Возвращаемое значение:
Одна из следующих констант (как строка): absbottom | absmiddle | baseline | bottom | right | left | Ничего | texttop | top.
 
Значение по умолчанию: bottom

alt NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

Текст, который будет отображен там, где на странице появляется элемент IMG, когда браузер не загружает графику (или ожидает изображение, чтобы загрузить его). Текст - обычно краткое описание что это за изображение. Знайте, что размер изображения на странице может ограничивать количество текста, которое Вы можете назначать на свойство alt. Удостоверитесь, что описание читаемо.

 
Пример:

document.corpLogo.alt = "MegaCorp Logo"

 
Возвращаемое значение:
Любая строка символов в кавычках.
 
Значение по умолчанию: Ничего.

border NN 3   IE 4   DOM 1
  Чтение/Изменение (в IE)
 

Толщина границы вокруг элемента (в пикселах). В то время как Internet Explorer 4, когда Вы изменяете это свойство, рисует границу вокруг существующего изображения, в Navigator 4 - это свойство только для чтения .

 
Пример:

document.logoImage.border = 4

 
Возвращаемое значение:
Целочисленное значение. Установка нуля в Internet Explorer 4 удаляет границу полностью.
 
Значение по умолчанию: 0

complete NN 3   IE 4   DOM n/a
 Только чтение
 

Показывает, полностью ли загрузил браузер элемент IMG или элемент формы image. Обратите внимание, что Navigator 4 реализует свойство некорректно.

 
Пример:

if (document.logo.complete) { safe to process the image object }

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: false

dataFld NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

Используется с IE 4 для закрепления данных, чтобы привязать имя отдаленного столбца источника данных к значению SRC объекта IMG. Атрибут dataSrc уже должен быть установлен для элемента. Одновременная установка свойств и dataFld, и dataSrc для пустых строк нарушает закрепление между источником данных и элементом.

 
Пример:

document.myImage.dataFld = "linkURL"

 
Возвращаемое значение:
Чувствительный к регистру идентификатор столбца источника данных
 
Значение по умолчанию: Ничего.

dataSrc NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

Используется с IE 4 для закрепления данных, чтобы связать имя удаленного источника данных ODBC (типа Oracle или SQL Server database) с элементом. Содержание из источника данных определено через атрибут dataFld. Одновременная установка свойств и dataFld, и dataSrc для пустых строк нарушает закрепление между источником данных и элементом.

 
Пример:

document.myImage.dataSrc = "#DBSRC3"

 
Возвращаемое значение:
Чувствительный к регистру идентификатор источника данных.
 
Значение по умолчанию: Ничего.

dynsrc NN n/a  IE 4   DOM n/a
  Чтение/Изменение
 

URL видео файла, который будет отображен в контейнере IMG. Изменение этого свойства загружает новый файл видеозаписи в объект IMG.

 
Пример:

document.images[3].dynsrc = "snowman.avi"

 
Возвращаемое значение:
Полный или относительный URL как строка.
 
Значение по умолчанию: Ничего.

fileCreatedDate, fileModifiedDate, fileSize NN n/a  IE 4   DOM n/a
  Чтение/Изменение
 

Эти три свойства содержат информацию о файле, отображаемом в элементе IMG (в случаях статического и динамического содержимого). Первые два содержат даты создания и изменения файла. Последнее - его размер в байтах. IE 4 и 5 по разному форматируют возвращаемое значение даты.

 
 
 
Возвращаемое значение:
Строка (первые 2), целочисленное (последний).
 
Значение по умолчанию: Зависит от файла

form NN 6  IE 4
  Только чтение
 

Возвращает ссылку на элемент FORM, который содержит текущий элемент image. Эту ссылку наиболее часто используют как параметр для обработчика события, используя её значение, чтобы обратиться к текущему элементу управления формой.

 
Пример:

<INPUT TYPE="image" src="URL" onClick="doValidate(this.form)">

 
Возвращаемое значение:
Объектная ссылка.
 
Значение по умолчанию: Ничего.

height, width NN 3   IE 4   DOM 1
 Read/Write (IE)
 

Высота и ширина в пикселах элемента изображения. Изменение этих значений в Internet Explorer 4 немедленно отражается на содержании страницы. Знайте, что изображения масштабируются, чтобы приспособиться новому измерению.

 
Пример:

document.prettyPicture.height = 250

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего.

href NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

URL, указанный атрибутом src. Идентично свойству src.

 
Пример:

document.logoImage.href = "images/fancyLogo.gif"

 
Возвращаемое значение:
Строка полного или относительного URL.
 
Значение по умолчанию: Ничего.

hspace, vspace NN 3   IE 4   DOM 1
 Read/Write (IE)
 

Размер в пикселах горизонтальных и вертикальных краев, окружающих объект изображения. Свойство hspace затрагивает левые и правые грани элемента (одинаково); vspace затрагивает верхние и нижние грани элемента (одинаково). Эти края - не аналогичны краям, установленным таблицами стилей, но они имеют тот же самый визуальный эффект. Новые значения могут быть назначены на эти свойства только в Internet Explorer 4 и выше.

 
Пример:

document.logo.hspace = 5 document.logo.vspace = 8

 
Возвращаемое значение:
Целое число в пикселах.
 
Значение по умолчанию: 0

isMap NN 6  IE 4   DOM 1
 Чтение/Изменение
 

Активирован ли элемент IMG как серверная карта изображения. Чтобы изображение стало серверной картой изображения, оно должно быть вложено в элемент a, чей атрибут HREF указывает на URL программы CGI. Браузер добавляет в конец URL координатную информациютак же, как и метод формы GET добавляет в конец URL данные элемента form.

Более современные браузеры поддерживают клиентские карты изображения (см. свойство useMap), которые работают более быстро для пользователя, потому что нет никакой связи с сервером.

 
Пример:

document.navMap.isMap = true

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: false

loop NN n/a  IE 4   DOM n/a
  Чтение/Изменение
 

Если Вы определяете файл видеозаписи атрибутом DYNSRC,свойство loop устанавливает, сколько раз клип должен играться (сколько итераций цикла). Изменение на значение -1 равносильно непрерывному циклу.

 
Пример:

document.movieImg.loop = 3

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: 1

longDesc NN 6
  Чтение/Изменение
 

Это свойство - URL файла, который предназначен, чтобы представить детальное описание изображения, вставленного в атрибут IMG.

 
 
 
Возвращаемое значение:
Строка URL
 
Значение по умолчанию: Ничего

lowsrc NN 3   IE 4   DOM n/a
 Read/Write (IE)
 

Если изображение долго загружается, можно свойством lowsrc указать на URL изображения меньшего размера в байтах. Изображение lowsrc должно быть с тем же самым размером пиксела, как и первичное изображение SRC. Имеет смысл изменять свойство lowsrc, только если Вы собираетесь изменять свойство src. В NN6 следует писать свойство lowsrc в виде lowSrc.

 
Пример:

document.productImage.lowsrc = "images/widget43LoRes.jpg"

 
Возвращаемое значение:
Полный или относительный URL как строка.
 
Значение по умолчанию: Ничего.

name NN 2   IE 3   DOM 1
  Чтение/Изменение
 

Идентификатор, связанный с изображением для использования в ссылках на объект.

 
Пример:

var imgName = document.images[3].name

 
Возвращаемое значение:
Чувствительный к регистру идентификатор, который подчиняется правилам именования: не может содержать никаких пробелов, не может начинаться с цифры и не должен содержать пунктуационных символов кроме символа подчеркивания.
 
Значение по умолчанию: Ничего.

nameProp NN n/a  IE 5 (кроме IE5/Mac)
  Только чтение
 

Данное свойство возвращает часть URL файла, содержащую только путь и имя.

 
 
 
Возвращаемое значение:
Строка имени файла
 
Значение по умолчанию: Ничего.

protocol NN n/a  IE 4   DOM n/a
 Только чтение
 

Обычно это свойство возвращает компонент protocol URLа, связанного с элементом. Это свойство, которое работает только в Win32, кажется, не работает должным образом.

 
Возвращаемое значение: Строка.
 
Значение по умолчанию: Ничего.

prototype NN n/a  IE 4   DOM n/a
  Только чтение
 

Возвращает ссылку на статический объект Image, от которого созданы все образцы объектов изображения. Этот механизм обычно используется в объектах базового языка JavaScript. Факт, что это свойство является доступным только в Internet Explorer 4 для Macintosh, заставляет сомневается в его законности.

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: объект Image

readyState NN n/a  IE 4   DOM n/a
 Только чтение
 

Возвращает текущее состояние загрузки изображения. Это свойство обеспечивает наиболее градуированную шкалу значений. С изменением этого свойства система обрабатывает событие onReadyStateChange .

 
Пример:

if (document.contentsMap.readyState == "uninitialized") { statements for alternate handling }

 
Возвращаемое значение:
Одно из следующих значений (как строки): complete | interactive | loading | uninitialized. Некоторые элементы позволяют пользователю взаимодействовать с частичным содержанием.
 
Значение по умолчанию: Ничего.

src NN 3  IE 4   DOM n/a
  Только чтение
 

Представляет собой URL объекта изображения. Задание URL этому свойству объекта IMG или элемента формы image заставляет броузер загружать новое изображение на место старого. В случае статичного объекта Image новое изображение загружается в буфер броузера (часто используется в прелоадерах).

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: объект Image

start NN n/a  IE 4   DOM n/a
  Чтение/Изменение
 

Данное свойство задаётся для файлов видеоклипов, воспроизводимых в области элементов IMG. Когда значение свойства - fileopen, клип воспроизводится при загрузке элемента. Если оно равно, например, mouseover, то клип воспроизводится при наведении на него курсора.

 
Возвращаемое значение:
Cтрока.
 
Значение по умолчанию: fileopen

type NN 6  IE 4
  Только Чтение
 

Данное свойство задаётся для элемента формы image. Оно определяет тип элемента INPUT.

 
Возвращаемое значение:
Cтрока.
 
Значение по умолчанию: image

useMap NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

URL элемента MAP в документе, работающего на клиентской стороне. Значение включает метку hash, связанную с именем карты в атрибуте useMap элемента IMG .

 
Пример:

document.images[0].useMap = "#altMap"

 
Возвращаемое значение:
Строка, начинающаяся с hashmark и имени элемента MAP.
 
Значение по умолчанию: Ничего.

x, y только NN 4
 Только чтение
 

Горизонтальные и вертикальные координаты верхнего левого угла изображения относительно страницы. Они работают только Navigator и соответствуют свойствам offsetLeft и offsetTop Internet Explorer 4.

 
Пример:

var imageFromTop = document.logoImg.y

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего.

Методы:


blur( ) NN n/a  IE 4   DOM n/a

Удаляет фокус из текущего элемента и обрабатывает событие onBlur (в IE). Никакой другой элемент в результате не получает фокус (обязательно).

 
Возвращаемое значение
None.
 
Параметры
None.

focus( ) NN n/a  IE 4   DOM n/a

Дает фокус текущему элементу и обрабатывает событие onFocus (в IE). Если другой элемент имел фокус в то время, он получает событие onBlur.

 
Возвращаемое значение
None.
 
Параметры
None.

Определённые обработчики событий:




HIVE: All information for read only. Please respect copyright!
Hosted by hive КГБ: Киевская городская библиотека