Библиотека RTFM Начало / Программирование / Java/JavaScript / Клиентский JavaScript 1.3. Справочник. Александр Пирамидин Оглавление | Назад | Вперёд | Индекс document Содержит информацию о текущем документе и предоставляет методы для отображения HTML-вывода пользователю. Клиентский объект Реализован в JavaScript 1.0 JavaScript 1.1: добавлен синтаксис onBlur и onFocus; добавлены свойства applets, domain, embeds, forms, formName , images и plugins. JavaScript 1.2: добавлены свойства classes, ids, layers и tags; добавлены методы captureEvents, contextual, getSelection, handleEvent, releaseEvents и routeEvent. Создание HTML-тэгом BODY. Машина выполнения JavaScript создаёт объект document для каждой HTML-страницы. Каждый объект window имеет свойство document, значением которого является объект document. Для определения объекта document используйте стандартный синтаксис HTML для тэга BODY с дополнением обработчиками событий JavaScript. Обработчики событий Обработчики событий  onBlur, onFocus, onLoad и onUnload специфицируются в тэге BODY, но реально являются обработчиками событий объекта window. Вот обработчики событий объекта document: onClick onDblClick onKeyDown onKeyPress onKeyUp onMouseDown onMouseUp Описание Документ HTML состоит из тэгов HEAD и BODY. Тэг HEAD содержит информацию о заголовке и базе документа (абсолютном базовом URL, используемом для разрешения относительных URL-гиперссылок данного документа). Тэг BODY содержит тело документа, которое определяется текущим URL. Всё тело документа (все остальные элементы HTML данного документа) находится внутри тэгов BODY. Вы можете загружать новый документ, устанавливая свойство window.location. Вы можете очистить панель документа (и удалить текст, элементы формы и т.д., и они не будут больше отображаться) с помощью таких операторов: document.close(); document.open(); document.write(); Можно опустить вызов document.open, если Вы пишете текст или HTML, поскольку write выполняет неявное открытие MIME-типа, если поток документа закрывается. Вы можете обращаться к якорям/anchors, формам/forms и ссылкам/ links документа, используя массивы anchors, forms и links. Эти массивы содержат вхождения для каждого якоря, формы или ссылки документа и являются свойствами объекта document. Не используйте location как свойство объекта document; используйте вместо него свойство document.URL. Свойство document.location, которое является синонимом свойства document.URL, не рекомендуется применять. Свойства. Резюме. Свойство Описание alinkColor Строка, специфицирующая атрибут ALINK. anchors Массив, содержащий вхождение каждого якоря документа. applets Массив, содержащий вхождение каждого аплета документа. bgColor Строка, специфицирующая атрибут BGCOLOR. classes Создаёт объект Style, который может специфицировать стили тэгов HTML с атрибутом CLASS. cookie Специфицирует куку. domain Специфицирует имя домена сервера, обслужившего документ. embeds Массив, содержащий вхождение каждого plug-in документа. fgColor Строка, специфицирующая атрибут TEXT. formName Отдельное свойство для каждой именованной формы документа. forms Массив, содержащий вхождение каждой формы документа. height Высота документа в пикселах. ids Создаёт объект Style, который может специфицировать стиль отдельных тэгов HTML. images Массив, содержащий вхождение каждого изображения документа. lastModified Строка, специфицирующая дату последнего изменения документа. layers Массив, содержащий вхождение каждого слоя документа. linkColor Строка, специфицирующая атрибут LINK. links Массив, содержащий вхождение каждой гиперссылки документа. plugins Массив, содержащий вхождение каждого plug-in документа. referrer Строка, специфицирующая URL вызывающего документа. tags Создаёт объект Style, который может специфицировать стили тэгов HTML. title Строка, специфицирующая содержимое тэга TITLE. URL Строка, специфицирующая полный URL документа. vlinkColor Строка, специфицирующая атрибут VLINK. width Ширина документа в пикселах. Методы. Резюме. Метод Описание captureEvents Устанавливает захват документом всех событий специфицированного типа. close Закрывает поток вывода и форсирует отображение данных. contextual Использует контекстуальный отбор по критериям специфицирования объекта Style, который может устанавливать стиль отдельных тэгов HTML. getSelection Возвращает строку, содержащую текущий выбранный текст. handleEvent Вызывает обработчик специфицированного события. open Открывает поток сбора вывода методов write или writeln. releaseEvents Устанавливает освобождение объектами window или document захваченных событий специфицированного типа. routeEvent Передаёт захваченное событие по иерархии нормальных событий. write Записывает одно или более выражений HTML в документ в специфицированном окне. writeln Записывает одно или более выражений HTML и символ новой строки в документ в специфицированном окне. Помимо этого, данный объект наследует методы watch и unwatch объекта Object. Примеры Следующий пример создаёт два фрэйма, каждый с одним документом. Документ первого фрэйма содержит ссылки на якоря в документе второго фрэйма. Каждый документ определяет свой цвет. doc0.html, который определяет фрэймы, содержит следующий код: <HTML> <HEAD> <TITLE>Document object example</TITLE> </HEAD> <FRAMESET COLS="30%,70%"> <FRAME src="./clientref13/./doc1.html" NAME="frame1"> <FRAME src="./clientref13/./doc2.html" NAME="frame2"> </FRAMESET> </HTML> doc1.html, который определяет содержимое первого фрэйма, содержит следующий код: <HTML> <SCRIPT> </SCRIPT> <BODY    BGCOLOR="antiquewhite"    TEXT="darkviolet"    LINK="fuchsia"    ALINK="forestgreen"    VLINK="navy"> <P><B>Some links</B> <LI><A href="?f=./doc2.html#numbers" TARGET="frame2">Numbers</A> <LI><A href="?f=./doc2.html#colors" TARGET="frame2">Colors</A> <LI><A href="?f=./doc2.html#musicTypes" TARGET="frame2">Music types</A> <LI><A href="?f=./doc2.html#countries" TARGET="frame2">Countries</A> </BODY> </HTML> doc2.html, который определяет содержимое второго фрэйма, содержит следующий код: <HTML> <SCRIPT> </SCRIPT> <BODY    BGCOLOR="oldlace" onLoad="alert('Hello, World.')"    TEXT="navy"> <P><A NAME="numbers"><B>Some numbers</B></A> <UL><LI>one <LI>two <LI>three <LI>four</UL> <P><A NAME="colors"><B>Some colors</B></A> <UL><LI>red <LI>orange <LI>yellow <LI>green</UL> <P><A NAME="musicTypes"><B>Some music types</B></A> <UL><LI>R&B <LI>Jazz <LI>Soul <LI>Reggae</UL> <P><A NAME="countries"><B>Some countries</B></A> <UL><LI>Afghanistan <LI>Brazil <LI>Canada <LI>Finland</UL> </BODY> </HTML> См. также Frame, window alinkColor Строка, специфицирующая цвет активной гиперссылки (после нажатия кнопки мыши, но до её отпускания). Свойство из document Реализовано в JavaScript 1.0 Описание Свойство alinkColor выражается как 16-ричный триплет RGB или как строковой литерал (см. книгу Клиентский JavaScript. Руководство.). Это свойство является отражением в JavaScript атрибута ALINK тэга BODY. Если Вы выводите цвет как 16-ричный триплет RGB, Вы обязаны использовать формат rrggbb. Например, 16-ричное значение RGB цвета salmon будет red=FA, green=80 и blue=72, так что RGB-триплет для salmon будет "FA8072". Примеры В этом примере устанавливается цвет активной гиперссылки с использованием строкового литерала: document.alinkColor="aqua" Здесь устанавливается цвет активной ссылки aqua с использованием 16-ричного триплета: document.alinkColor="00FFFF" См. также document.bgColor, document.fgColor, document.linkColor, document.vlinkColor anchors Массив объектов, соответствующих именованным якорям в порядке размещения в исходном коде. Свойство из document Только для чтения Реализовано в JavaScript 1.0 Описание Вы можете обращаться к объектам Anchor в Вашем коде, используя массив anchors. Этот массив содержит вхождение для каждого тэга A, имеющего атрибут NAME; это вхождения в порядке расположения в исходном коде документа. Например, если документ содержит три именованных якоря  со значениями атрибута NAME anchor1, anchor2 и anchor3, Вы можете обратиться к этим якорям так: document.anchors["anchor1"] document.anchors["anchor2"] document.anchors["anchor3"] или так: document.anchors[0] document.anchors[1] document.anchors[2] Для получения количества якорей в документе используйте свойство length: document.anchors.length. Если документ содержит якоря, именованные в системном порядке натуральными числами, Вы можете использовать массив anchors и его свойство length для проверки имени якоря перед его использованием в операциях типа установки location.hash. applets Массив объектов-аплетов в порядке их появления в исходном коде документа. Свойство из document Только для чтения Реализовано в JavaScript 1.1 Описание Вы можете обращаться к аплетам через использование массива applets. Этот массив содержит вхождения для каждого объекта Applet (тэг APPLET) в документе; вхождения соответствуют порядку появления аплетов в исходном коде страницы. Например, если документ содержит три аплета со значениями атрибута NAME app1, app2 и app3, Вы можете обращаться к аплетам так: document.applets["app1"] document.applets["app2"] document.applets["app3"] или так: document.applets[0] document.applets[1] document.applets[2] Чтобы получить число аплетов в документе, используйте свойство length: document.applets.length. bgColor Строка, специфицирующая цвет фона документа. Свойство из document Реализовано в JavaScript 1.0 Описание Свойство bgColor выражается как 16-ричный RGB-триплет или как строковой литерал (см. книгу Клиентский JavaScript. Руководство). Это свойство является отражением в JavaScript атрибута BGCOLOR тэга BODY. По умолчанию значение этого свойства устанавливается пользователем в диалоговом окне настроек. Если Вы записываете цвет как 16-ричный RGB-триплет, Вы обязаны использовать формат rrggbb. Например, 16-ричные значения RGB для цвета salmon будут red=FA, green=80 и blue=72, так что RGB-триплет для salmon будет "FA8072". Примеры Здесь устанавливается цвет фона документа в aqua с использованием литерала: document.bgColor="aqua" А здесь - с использованием 16-ричного триплета: document.bgColor="00FFFF" См. также document.alinkColor, document.fgColor, document.linkColor, document.vlinkColor captureEvents Настраивает документ для отлова всех событий специфицированного типа. Метод из document Реализован в JavaScript 1.2 Синтаксис captureEvents(eventType) Параметры eventType Тип отлавливаемых событий. Допустимые типы перечислены в описании объекта event. Описание Если окно с фрэймами должно отлавливать события на страницах, загружаемых с разных серверов, Вам необходимо использовать window.captureEvents в помеченном скрипте с предшествующим window.enableExternalCapture. Информацию и пример см. в статье window.enableExternalCapture. captureEvents работает в паре с releaseEvents, routeEvent и handleEvent. О событиях см. дополнительно Клиентский JavaScript. Руководство. classes Создаёт объект Style, который может специфицировать стили тэгов HTML со специфическим атрибутом CLASS. Свойство из document Реализовано в JavaScript 1.2 Синтаксис document.classes.className.tagName Параметры className Значение с учётом регистра символов - атрибут CLASS тэга HTML, специфицированного в tagName.. tagName Значение без учёта регистра - имя HTML-тэга, такое как H1 или BLOCKQUOTE. Если значением tagName  является all, tagName  ссылается на все тэги HTML. Описание Используйте свойство classes для специфицирования стиля тэгов HTML, имеющих специфический атрибут CLASS. Например, Вы можете специфицировать, что цвет класса GreenBody тэгов P или BLOCKQUOTE будет зелёным. См. в объекте Style описание стилевых свойств, которые Вы можете специфицировать для classes. Если Вы используете свойство classes внутри тэга STYLE (а не внутри тэга SCRIPT), Вы можете по выбору опустить document в синтаксисе classes. Свойство classes всегда применяется к текущему объекту document. Примеры В этом примере в зелёный устанавливается цвет всех тэгов, использующих атрибут GreenBody CLASS: <STYLE TYPE="text/javascript">    classes.GreenBody.all.color="green" </STYLE> Заметьте, что Вы можете опустить указание объекта document внутри тэга STYLE. Внутри тэга SCRIPT Вы обязаны специфицировать объект document таким образом: <SCRIPT LANGUAGE="JavaScript1.2">    document.classes.GreenBody.all.color="green" </SCRIPT> В этом примере текст, появляющийся внутри одного из следующих тэгов, будет иметь зелёный цвет: <P CLASS="GreenBody"> <BLOCKQUOTE CLASS="GreenBody"> См. также document.contextual, document.ids, document.tags, Style close Закрывает поток вывода и форсирует отображение данных, отправленных для вывода. Метод из document Реализован в JavaScript 1.0 Синтаксис close() Параметры Отсутствуют. Описание Метод close закрывает поток, открытый методом document.open. Если поток был открыт для отображения, метод close форсирует отображение содержимого потока. Тэги стиля шрифта, такие как BIG и CENTER, автоматически очищают поток вывода. Метод close также останавливает "метеорный поток" в иконке Netscape и отображает Document: Done в статусной строке браузера. Примеры Следующая функция вызывает document.close для закрытия потока, который был открыт методом document.open. Метод document.close форсирует отображение в окне содержимого потока. function windowWriter1() {    var myString = "Hello, world!"    msgWindow.document.open()    msgWindow.document.write(myString + "<P>")    msgWindow.document.close() } См. также document.open, document.write, document.writeln contextual Использует контекстные критерии отбора для специфицирования объекта Style, который может устанавливать стиль отдельных тэгов HTML. Метод из document Реализован в JavaScript 1.2 Синтаксис contextual(context1, ...[contextN,] affectedStyle) Параметры context1, ...[contextN]> Объекты Style, описанные свойствами document.classes или document.tags, которые устанавливают контекст для объекта Style. affectedStyle Объект Style, стилевые свойства которого Вы хотите изменить. Описание Метод contextual предоставляет точный контроль над специфицированием стилей. Он даёт Вам возможность применять стиль к HTML-элементу, который появляется в очень специфическом контексте. Например, Вы можете специфицировать, что цвет текста внутри тэга EM, который находится внутри тэга H1, будет голубым/blue. Затем Вы можете уточнить выбор, специфицируя несколько контекстов. Например, Вы можете установить цвет любого тэга LI с двумя или более родительскими UL, специфицировав UL для первых двух контекстов. Примеры Пример 1. Здесь устанавливается голубой цвет текста внутри любого тэга EM, появляющегося в H1. <STYLE TYPE="text/javascript">    contextual(document.tags.H1, document.tags.EM).color="blue"; </STYLE> Обратите внимание, что можно опускать указание объекта document внутри тэга STYLE. Внутри тэга SCRIPT Вы обязаны специфицировать объект document таким образом: <SCRIPT LANGUAGE="JavaScript1.2"> document.contextual(document.tags.H1, document.tags.EM).color="blue"; </SCRIPT> В этом примере текст в тэге EM будет голубым: <H1 CLASS="Main">The following text is <EM>blue</EM></H1> Пример 2. Этот пример устанавливает цвет элемента LI с двумя или более родительскими UL в красный. <STYLE TYPE="text/javascript">    contextual(tags.UL, tags.UL, tags.LI).color="red"; </STYLE> См. также document.classes, document.tags, Style cookie Строковое значение, представляющее все куки, ассоциированные с данным документом. Свойство из document Реализовано в JavaScript 1.0 Безопасность JavaScript 1.1. Это свойство по умолчанию разрушено. Об искажении/разрушении данных см. книгу Клиентский JavaScript. Руководство. Описание Кука это небольшой блок информации, сохраняемый web-браузером в файле cookies.txt. Используйте string -методы, такие как substring, charAt, indexOf и lastIndexOf, для определения значения, хранимого в куке. См. в разделах Приложение C, "Куки Netscape" полную спецификацию синтаксиса кук. Вы можете установить свойство cookie в любое время. Компонент "expires=" в куки-файле устанавливает срок окончания действия куки, так что она может существовать по окончании текущей сессии браузера. Эта строка даты форматируется так: Wdy, DD-Mon-YY HH:MM:SS GMT Этот формат представляет следующие значения: Wdy - строка с полным названием дня недели. DD  - целое число - число месяца. Mon - строка - трёхбуквенная аббревиатура названия месяца. YY - целое число - последние две цифры года. HH, MM и SS это двухсимвольные представления часа, минут и секунд, соответственно. Например, верная дата окончания срока действия куки выглядит так: expires=Wednesday, 09-Nov-99 23:12:40 GMT Формат даты куки - тот же самый, что и у даты, возвращаемой методом toGMTString, со следующими исключениями: Между значениями дня, месяца и года добавляются тире. Год в куке это значение из двух цифр. Пример Следующая функция использует свойство cookie для записи напоминания пользователю приложения. Дата окончания работы куки устанавливается в один день после даты напоминания. function RecordReminder(time, expression) {    // Записывает куку в форме "@<T>=<E>" для отображения    // из <T> в миллисекундах,    // возвращаемых методом Date.getTime(), в кодированное выражение,    // <E> (кодировано с отсутствием символов пробелов, точки с запятой или запятой)    document.cookie = "@" + time + "=" + expression + ";"    // устанавливается время окончания работы куки в один день    // после дня напоминания    document.cookie += "expires=" + cookieDate(time + 24*60*60*1000)    // cookieDate это функция, которая форматирует дату    //в соответствии со спецификацией куки } См. также Hidden domain Специфицирует имя домена сервера, обслужившего документ. Свойство из document Реализовано в JavaScript 1.1 Безопасность JavaScript 1.1. Значение этого свойства по умолчанию разрушено. О разрушении данных см. книгу Клиентский JavaScript. Руководство. Описание JavaScript 1.1. Свойство domain даёт скриптам возможность совместно использовать свойства на нескольких серверах, когда разрушение данных не включено. Если разрушение отключено, скрипт, запущенный в одном окне, может читать свойства другого окна только тогда, когда оба окна получены от одного Web-сервера. Но на больших Web-сайтах с несколькими серверами может понадобиться совместно использовать свойства несколькими серверами. Например, скрипту на хосте www.royalairways.com может понадобиться использовать свойства совместно со скриптом на хосте search.royalairways.com. Если скрипты на двух разных серверах изменяют свои свойства domain таким образом, что оба скрипта имеют одно имя домена, оба скрипта могут использовать свойства совместно. Например, скрипт, загруженный с search.royalairways.com может установить своё свойство domain в "royalairways.com". Скрипт с www.royalairways.com, запущенный в другом окне, также может установить своё свойство domain в "royalairways.com". Затем, поскольку оба скрипта имеют домен "royalairways.com", они могут совместно использовать свойства, хотя они и не происходят с одного сервера. Вы можете изменить domain только с ограничениями. Сначала domain содержит hostname Web-сервера, с которого документ был загружен. Вы можете установить domain только в доменном суффиксе самого домена. Например, скрипт с search.royalairways.com не может установить свойство domain в "search.royalairways". А скрипт с IWantYourMoney.com не может установить свой домен в "royalairways.com". После изменения свойства domain Вы не можете вернуть его обратно в оригинальное значение. Например, если Вы изменяете domain с "search.royalairways.com" на "royalairways.com", Вы не можете восстановить его обратно в "search.royalairways.com". Пример Следующий оператор изменяет свойство domain в "braveNewWorld.com". Этот оператор верен только тогда, когда суффикс "braveNewWorld.com" является суффиксом текущего домена, такого как "www.braveNewWorld.com". document.domain="braveNewWorld.com" embeds Массив, содержащий вхождения каждого объекта, встроенного в документ. Свойство из document Только для чтения Реализовано в JavaScript 1.1 Описание Вы можете обратиться к встроенным объектам (созданных тэгом EMBED) в Вашем коде, используя массив embeds. Этот массив содержит вхождение для каждого тэга EMBED в документе в порядке их появления. Например, если документ содержит три внедрённых объекта с атрибутами NAME e1, e2 и e3, Вы можете обратиться к этим объектам так: document.embeds["e1"] document.embeds["e2"] document.embeds["e3"] или так: document.embeds[0] document.embeds[1] document.embeds[2] Для получения количества внедрённых объектов документа используйте свойство length: document.embeds.length. Элементы в массиве embeds могут иметь вызываемые public-функции, если они обращаются к plug-in'у, который использует LiveConnect. См. информацию по LiveConnect в книге Клиентский JavaScript. Руководство. Используйте элементы массива embeds для взаимодействия с plug-in, который отображает внедрённый объект. Если plug-in не работает с Java, Вы не сможете ничего сделать с его элементом в массиве embeds. Поля и методы элементов массива embeds отличаются от plug-in'а к plug-in'у; см. документацию, поставляемую изготовителем plug-in'а. Если вы используете тэг EMBED для генерирования вывода из plug-in-приложения, Вы не создаёте объект Plugin. Примеры Следующий код вставляет аудио plug-in в документ: <EMBED src="./clientref13/./train.au" HEIGHT=50 WIDTH=250> См. также Plugin fgColor Строка, специфицирующая цвет текста документа (foreground). Свойство из document Реализовано в JavaScript 1.0 Описание Свойство fgColor выражается как 16-ричный триплет RGB или как строковой литерал (см. книгу Клиентский JavaScript. Руководство.). Это свойство является отражением в JavaScript атрибута TEXT тэга BODY. По умолчанию значение этого свойства устанавливается пользователем в диалоговом окне настроек. Вы не можете установить это свойство после того как HTML-источник отображён. Если цвет выражается как 16-ричный RGB-триплет, Вы обязаны использовать формат rrggbb. Например, 16-ричные RGB-значения для цвета salmon будут red=FA, green=80 и blue=72, так что RGB-триплет для salmon будет "FA8072". Вы можете переопределить значение, установленное в свойстве fgColor, одним из следующих способов: Установив атрибут COLOR тэга FONT. Использовав метод fontcolor. formName Имя формы. Свойство из document Реализовано в JavaScript 1.1 Объект document имеет отдельное свойство для каждой формы документа. Имя этого свойства является значением атрибута NAME формы. См. в Hidden информацию об объектах Form. Вы не можете добавить новые формы в документ, создав новые свойства, но можете изменить форму, изменяя этот объект. forms Массив вхождений всех форм документа. Свойство из document Только для чтения Реализовано в JavaScript 1.1 Безопасность JavaScript 1.1. Это свойство по умолчанию разрушено. О разрушении данных см. книгу Клиентский JavaScript. Руководство. Описание Вы можете обратиться в Вашем коде к формам, использовав массив forms (Вы можете также использовать имя формы). Это массив содержит вхождение для каждого объекта Form (тэг FORM) документа; эти вхождения расположены в том же порядке, что и в исходном коде. Например, если документ содержит три формы со значениями атрибутов NAME form1, form2 и form3, Вы можете обратиться к объектам массива forms так: document.forms["form1"] document.forms[" form2"] document.forms["form3"] или так: document.forms[0] document.forms[1] document.forms[2] Дополнительно объект document имеет отдельное свойство для каждой именованной формы, так что Вы можете обратиться к этим формам таким образом: document.form1 document.form2 document.form3 Например, Вы можете обратиться к объекту Text  с именем quantity во второй форме: document.forms[1].quantity. Вы можете обратиться к свойству value этого объекта Text: document.forms[1].quantity.value. Значение каждого элемента в массиве forms это <object nameAttribute>, где nameAttribute это атрибут NAME формы. Для получения количества форм документа используйте свойство length: document.forms.length. getSelection Возвращает строку, содержащую текст текущего выделения. Метод из document Реализован в JavaScript 1.2 Синтаксис getSelection() Описание Этот метод работает только в текущем документе. Безопасность Вы не можете определить выбранные области в другом окне. Пример Если у Вас имеется форма со следующим кодом и Вы щёлкнули на кнопке, JavaScript отображает alert-диалог, содержащий текущий выделенный текст из окна, содержащего кнопку: <INPUT TYPE="BUTTON" NAME="getstring"    VALUE="Show highlighted text (if any)"    onClick="alert('You have selected:\n'+document.getSelection());"> handleEvent Вызывает обработчик для специфицированного события. Метод из document Реализован в JavaScript 1.2 Синтаксис handleEvent(event) Параметр event Имя события, для которого специфицированный объект имеет обработчик события. Описание Об обработчиках событий см. книгу Клиентский JavaScript. Руководство. height Высота документа в пикселах. Свойство из document Реализовано в JavaScript 1.2 См. также document.width ids Создаёт объект Style, который может специфицировать стиль отдельных тэгов HTML. Свойство из document Реализовано в JavaScript 1.2 Синтаксис document.ids.idValue Параметр idValue Нечувствительное к регистру значение атрибута ID любого тэга HTML. Описание Используйте свойство ids для специфицирования стиля любого тэга HTML, имеющего специфический атрибут ID. Например, Вы можете специфицировать, что цвет NewTopic ID - зелёный. См. в объекте Style описание стилевых свойств, которые Вы можете специфицировать для ids. Свойство ids используется, когда Вам нужно предоставить исключение для класса, определённого в свойстве document.classes. Если Вы используете свойство ids внутри тэга STYLE (вместо тэга SCRIPT), Вы можете по выбору исключить document из синтаксиса ids. Свойство ids всегда применяется к текущему объекту document. Примеры В этом примере атрибут Main CLASS устанавливается в 18-point bold green, но предоставляет исключение для тэгов, ID которых - NewTopic: <STYLE TYPE="text/javascript">    classes.Main.all.color="green"    classes.Main.all.fontSize="18pt"    classes.Main.all.fontWeight="bold"    ids.NewTopic.color="blue" </STYLE> Заметьте, что Вы можете опустить указание объекта document в тэге STYLE. В тэге SCRIPT Вы обязаны специфицировать объект document таким образом: <SCRIPT LANGUAGE="JavaScript1.2">    document.classes.Main.all.color="green"    document.classes.Main.all.fontSize="18pt"    document.classes.Main.all.fontWeight="bold"    document.ids.NewTopic.color="blue" </SCRIPT> В этом примере текст, появляющийся в следующем тэге, будет жирным, зелёным и будет иметь размер 18 пунктов: <H1 CLASS="Main">Green head</H1> Но текст в этом тэге будет 18-point bold blue: <H1 CLASS="Main" ID="NewTopic">Blue head</H1> См. также document.classes, document.contextual, document.tags, Style images Массив вхождений изображений в документе. Свойство из document Только для чтения Реализовано в JavaScript 1.1 Вы можете обращаться к изображениям в документе, используя массив images. Этот массив содержит вхождение каждого объекта Image (тэг IMG) документа; вхождения идут в порядке исходного кода. Изображения, созданные конструктором Image, не включаются в массив images. Например, если документ содержит три изображения с атрибутами NAME im1, im2 и im3, Вы можете обращаться к этим объектам в массиве images таким образом: document.images["im1"] document.images["im2"] document.images["im3"] или так: document.images[0] document.images[1] document.images[2] Для получения количества изображений в документе используйте свойство length: document.images.length. lastModified Строка с датой последнего изменения документа. Свойство из document Только для чтения Реализовано в JavaScript 1.0 Безопасность JavaScript 1.1. Это свойство по умолчанию разрушено. О разрушении данных см. книгу Клиентский JavaScript. Руководство. Описание Свойство lastModified происходит от даты шапки HTTP, высылаемой web-сервером. Серверы обычно получают эту дату, проверяя дату изменения файла. Дата последнего изменения не является необходимой частью шапки/header, и некоторые серверы её не предоставляют. Если сервер не возвращает информацию о дате последнего изменения, JavaScript получает 0, который отображается как January 1, 1970 GMT. Следующий код проверяет дату, возвращаемую свойством lastModified, и выводит значение, соответствующее неизвестной дате. lastmod = document.lastModified // получить строку с датой последнего изменения lastmoddate = Date.parse(lastmod)   // конвертировать модифицированную строку в дату if(lastmoddate == 0){               // дата не известна (или January 1, 1970 GMT)    document.writeln("Lastmodified: Unknown")    } else {    document.writeln("LastModified: " + lastmod) } Пример Здесь свойство lastModified используется в тэге SCRIPT в конце HTML-файла для отображения даты изменения страницы: document.write("This page updated on " + document.lastModified) layers Это массив, содержащий вхождение для каждого слоя документа. Свойство из document Реализовано в JavaScript 1.2 Описание Вы можете обращаться к слоям Вашего документа, используя массив layers. Этот массив содержит вхождение для каждого объекта Layer (тэг LAYER или ILAYER) документа; эти вхождения идут в порядке расположения в исходном коде. Например, если документ содержит три слоя с атрибутами NAME layer1, layer2 и layer3, Вы можете обратиться к этим объектам в массиве layers так: document.layers["layer1"] document.layers["layer2"] document.layers["layer3"] или так: document.layers[0] document.layers[1] document.layers[2] При доступе по целочисленному индексу массив элементов идёт в порядке z-order спереди назад, где 0 это самый нижний слой, а более высокие слои индексируются последующими целыми числами. Индекс слоя - не тот же, что его свойство zIndex, так как второе не обязательно перечисляет слои последовательными целыми числами. Смежные слои могут иметь одинаковые значения свойства zIndex. Вот правильные способы доступа к объектам слоёв: document.layerName document.layers[index] document.layers["layerName"] // пример использования свойства layers для доступа к вложенным слоям: document.layers["parentlayer"].layers["childlayer"] Элементы массива layers это JavaScript-объекты, которые не могут быть установлены операцией присвоения, хотя их свойства - могут. Например, оператор document.layers[0]="music" является неправильным (и игнорируется), так как он пытается изменить массив layers. Однако свойства объектов массива можно читать, а некоторые из них можно записывать. Например, оператор document.layers["suspect1"].left = 100; является верным. Он устанавливает позицию слоя по горизонтали в 100. В следующем примере цвет фона устанавливается в blue для слоя bluehouse, который вложен в слой houses. document.layers["houses"].layers["bluehouse"].bgColor="blue"; Для получения количества слоёв документа используйте свойство length: document.layers.length. linkColor Строка, специфицирующая цвет гиперссылок документа. Свойство из document Реализовано в JavaScript 1.0 Описание Свойство linkColor выражается как 16-ричный RGB-триплет или как строковой литерал (см. книгу Клиентский JavaScript. Руководство). Это свойство является отражением в JavaScript атрибута LINK тэга BODY. Значение по умолчанию этого свойства устанавливается пользователем в диалоговом окне установок браузера. Вы не можете установить это свойство после того как исходный код HTML отображён. При выражении цвета как 16-ричного RGB-триплета Вы обязаны использовать формат rrggbb. Например, 16-ричные значения RGB для цвета salmon будут red=FA, green=80 и blue=72, поэтому RGB-триплет для salmon будет "FA8072". Пример Здесь цвет гиперссылок документа устанавливается в aqua с использованием строкового литерала: document.linkColor="aqua" А здесь - с использованием 16-ричного триплета: document.linkColor="00FFFF" См. также document.alinkColor, document.bgColor, document.fgColor, document.vlinkColor links Массив объектов, соответствующий объектам Area и Link в порядке вхождения в исходном коде. Свойство из document Только для чтения Реализовано в JavaScript 1.0 Безопасность JavaScript 1.1. Это свойство по умолчанию разрушено. О разрушении данных см. книгу Клиентский JavaScript. Руководство. Описание Вы можете обращаться к объектам Area и Link в Вашем коде через использование массива links. Этот массив содержит вхождение для каждого объекта Area (тэг <AREA href="?f=./...">) и Link (<A href="?f=./...">) документа в порядке появления в исходном коде. Он также содержит ссылки, созданные методом link. Например, если в документе есть три ссылки, можно обратиться к ним так: document.links[0] document.links[1] document.links[2] Для получения общего количества ссылок в документе, используйте свойство length: document.links.length. open Открывает поток для сбора вывода методов write или writeln. Метод из document Реализован в JavaScript 1.0 JavaScript 1.1: добавлен параметр "replace"; document.open() или document.open("text/html") очищает текущий документ, если его загрузка закончена. Синтаксис open([mimeType, [replace]]) Параметры mimeType Строка, специфицирующая тип документа, в который Вы записываете. Если Вы не специфицировали mimeType, по умолчанию он будет text/html. replace Строка "replace". Если Вы предоставили этот параметр, mimeType обязан быть "text/html". Вызывает использование новым документом вхождения из history, использованного предыдущим документом. Описание Значения для mimeType: text/html специфицирует документ, содержащий ASCII-текст с форматированием HTML. text/plain специфицирует документ, содержащий обычный ASCII-текст с символами конца строки для разграничения отображаемых строк. image/gif специфицирует документ, кодирующий байты, образующие GIF-шарку и пикселные данные. image/jpeg специфицирует документ, кодирующий байты, образующие JPEG-шапку и пикселные данные. image/x-bitmap специфицирует документ, кодирующий байты, образующие битовую шапку и пикселные данные. plugIn загружает специфицированный plug-in и использует его как цель/назначение для методов write и writeln. Например, "x-world/vrml" загружает VR Scout VRML plug-in с Chaco Communications, а "application/x-director" загружает Macromedia Shockwave plug-in. MIME-типы рlug-in'ов верны только тогда, когда пользователь установил требуемое программное обеспечение для plug-in'а. Метод open открывает поток для сбора вывода методов write или writeln. Если mimeType это text или image, поток открывается для вывода; иначе поток открывается для plug-in'а. Если документ существует в целевом окне, метод open очищает его. Поток закрывается путём использования метода document.close. Метод close вызывает отображение текста или изображений, которые были посланы для вывода. После использования document.close вызовите document.open ещё раз, если Вам нужно начать другой поток вывода. В JavaScript 1.1 или позднее document.open или document.open("text/html") очищает текущий документ, если он закончил загрузку. Поэтому этот тип вызова open записывает по умолчанию тэг <BASE href="?f=./">, так что Вы можете генерировать относительные URL на основе базы документа, генерирующего скрипт. Ключевое слово "replace" вызывает повторное использование новым документом вхождения в history, использованного предыдущим документом. Если Вы специфицируете "replace" при открытии документа, размер истории/history не увеличивается, даже если Вы записали в окно и закрыли его. "replace" обычно используется в окне, в котором находится пустой документ или документ с URL "about:blank". После специфицирования "replace" метод write обычно генерирует HTML для окна, замещая вхождение в history для пустого URL. Будьте внимательны при использовании генерируемого HTML в окне с пустым/blank URL. Если Вы не специфицируете "replace", генерируемый HTML имеет своё собственное вхождение в history, и пользователь может, нажав кнопку Back, вернуться в пустой фрэйм. После выполнения document.open("text/html","replace")  history.current для целевого окна будет URL документа, который выполнил document.open. Примеры Пример 1. Здесь функция вызывает document.open для открытия потока перед использованием метода write: function windowWriter1() {    var myString = "Hello, world!"    msgWindow.document.open()    msgWindow.document.write("<P>" + myString)    msgWindow.document.close() } Пример 2. Эта функция вызывает document.open с ключевым словом "replace" для открытия потока перед использованием методов write. Код HTML в методах write записывается в msgWindow, замещая текущее вхождение в history. Размер истории/history окна msgWindow не увеличивается. function windowWriter2() {    var myString = "Hello, world!"    msgWindow.document.open("text/html","replace")    msgWindow.document.write("<P>" + myString)    msgWindow.document.write("<P>history.length is " +       msgWindow.history.length)    msgWindow.document.close() } Следующий код создаёт окно msgWindow и вызывает функцию: msgWindow=window.open('','',    'toolbar=yes,scrollbars=yes,width=400,height=300') windowWriter2() Пример 3. Здесь функция probePlugIn определяет, имеется ли у пользователя установленный Shockwave plug-in: function probePlugIn(mimeType) {    var havePlugIn = false    var tiny = window.open("", "teensy", "width=1,height=1")    if (tiny != null) {       if (tiny.document.open(mimeType) != null)          havePlugIn = true       tiny.close()    }    return havePlugIn } var haveShockwavePlugIn = probePlugIn("application/x-director") См. также document.close, document.write, document.writeln, Location.reload, Location.replace plugins Массив объектов, соответствующих объектам Plugin в порядке расположения в исходном коде. Свойство из document Только для чтения Реализовано в JavaScript 1.1 Вы можете обращаться к объектам Plugin в исходном коде, используя массив plugins. Этот массив содержит вхождение для каждого объекта Plugin документа в порядке расположения в исходном коде. Например, если в документе имеются три plugin'а, Вы можете обратиться к ним так: document.plugins[0] document.plugins[1] document.plugins[2] referrer Специфицирует URL вызывающего документа, когда пользователь щёлкает по ссылке. Свойство из document Только для чтения Реализовано в JavaScript 1.0 Безопасность JavaScript 1.1. Это свойство по умолчанию разрушено/запорчено. О разрушении данных см. книгу Клиентский JavaScript. Руководство. Описание Когда пользователь переходит к другому документу, щёлкая объект Link в исходном документе, свойство referrer содержит URL исходного документа. referrer является пустым, если пользователь ввёл URL в окне Location браузера и использовал какой-нибудь иной способ получения текущего URL. referrer является пустым также, если сервер не предоставляет информации о переменной окружения. Пример Здесь функция getReferrer вызывается из документа назначения. Она возвращает URL исходного документа. function getReferrer() {    return document.referrer } releaseEvents Заставляет документ освободить захваченные события специфицированного типа, отсылая события объектам, следующим далее по иерархии событий. Метод из document Реализован в JavaScript 1.2 ПРИМЕЧАНИЕ: Если целевым оригиналом события является окно, оно получает событие, даже если окно установлено для освобождения этого типа событий. Синтаксис releaseEvents(eventType) Параметры eventType Тип захватываемого события. Описание releaseEvents работает вместе с captureEvents, routeEvent и handleEvent. О событиях см. дополнительно книгу Клиентский JavaScript. Руководство. routeEvent Передаёт захваченное событие по нормальной иерархии событий. Метод из document Реализован в JavaScript 1.2 Синтаксис routeEvent(event) Параметры event Имя перенаправляемого события. Описание Если субобъект (document или layer) также захватывает событие, событие пересылается этому объекту. Иначе оно высылается оригинальному целевому объекту. routeEvent работает вместе с captureEvents, releaseEvents и handleEvent. О событиях см. дополнительно книгу Клиентский JavaScript. Руководство. tags Создаёт объект Style, который может специфицировать стили HTML-тэгов. Свойство из document Реализовано в JavaScript 1.2 Синтаксис document.tags.tagName Параметры tagName Нечувствительное у регистру имя любого тэга HTML, такого как H1 или BLOCKQUOTE. Описание Используйте свойство tags для специфицирования стиля HTML-тэгов. Например, Вы можете специфицировать, что цвет любого тэга H1 будет blue и что выравнивание тэгов H1 или H2 будет по центру. См. в объекте Style описание свойств, которые Вы можете специфицировать для тэгов HTML. Поскольку все элементы HTML наследуют от тэга BODY, Вы можете специфицировать стиль по умолчанию документа, установив стили тэга BODY. Если Вы используете свойство tags внутри тэга STYLE (а не внутри тэга SCRIPT), Вы можете по выбору опустить document в синтаксисе tags. Свойство tags всегда применяется к текущему объекту document. Примеры Пример 1. Цвет всех тэгов H1 устанавливается в blue: <STYLE TYPE="text/javascript">    tags.H1.color="blue" </STYLE> Обратите внимание, что Вы можете опустить указание объекта document в тэге STYLE. Внутри тэга SCRIPT Вы обязаны специфицировать объект document таким образом: <SCRIPT LANGUAGE="JavaScript1.2">    document.tags.H1.color="blue" </SCRIPT> Пример 2. Устанавливается универсальное левое поле документа: document.tags.Body.marginLeft="20pt" Поскольку все тэги HTML наследуют от BODY, этот пример устанавливает левое поле для всего документа в 20 пунктов. См. также document.classes, document.contextual, document.ids, Style title Строка, представляющая название документа. Свойство из document Только для чтения Реализовано в JavaScript 1.0 Безопасность JavaScript 1.1. Это свойство по умолчанию разрушено/запорчено. О разрушении данных см. книгу Клиентский JavaScript. Руководство. Описание Свойство title является отражением значения, специфицируемого между  начальным и конечным тэгами TITLE. Если документ не имеет названия/title, свойство title будет null. Пример Здесь значение свойства title присваивается переменной docTitle: var newWindow = window.open("http://home.netscape.com") var docTitle = newWindow.document.title URL Строка, специфицирующая полный URL документа. Свойство из document Только для чтения Реализовано в JavaScript 1.0 Безопасность JavaScript 1.1. Это свойство по умолчанию разрушено/запорчено. О разрушении данных см. книгу Клиентский JavaScript. Руководство. Описание URL это свойство со строковым значением, содержащее полный URL документа. Оно обычно совпадает с тем, что установлено в свойстве window.location.href при загрузке документа, но перенаправление может изменить location.href. Пример Выводится URL текущего документа: document.write("The current URL is " + document.URL) См. также Location.href vlinkColor Строка, специфицирующая цвет посещённых гиперссылок. Свойство из document Реализовано в JavaScript 1.0 Описание Свойство vlinkColor выражается как 16-ричный RGB-триплет или как строковой литерал (см. книгу Клиентский JavaScript. Руководство). это свойство является отражением в JavaScript атрибута VLINK тэга BODY. Значение по умолчанию этого свойства устанавливается пользователем в диалоге настроек браузера. Вы не можете установить это свойство после того как исходный HTML отображён. Если цвет выражается как 16-ричный триплет RGB, Вы обязаны использовать формат rrggbb. Например, 16-ричные RGB-значения для цвета salmon будут red=FA, green=80 и blue=72, так что RGB-триплет для salmon будет "FA8072". Примеры Здесь цвет посещённых ссылок устанавливается в aqua с использованием строкового литерала: document.vlinkColor="aqua" А здесь - с помощью 16-ричного триплета: document.vlinkColor="00FFFF" См. также document.alinkColor, document.bgColor, document.fgColor, document.linkColor width Ширина документа в пикселах. Свойство из document Реализовано в JavaScript 1.2 См. также document.height write Записывает одно или более выражений HTML в документ специфицированного окна. Метод из document Реализован в JavaScript 1.0 Синтаксис document.write(expr1[, ...,exprN]) Параметры expr1, ... exprN Любые выражения JavaScript. Описание Метод write отображает любое количество выражений в документе окна. Вы можете специфицировать любое выражение JavaScript методом write, включая числовые, строки или логические выражения. Метод write это такой же метод, что и writeln, за исключением того, что метод write не присоединяет символ новой строки в конец вывода. Используйте метод write внутри тэгов SCRIPT или в обработчиках событий. Обработчики событий выполняются после закрытия оригинального документа, поэтому метод write неявно открывает новый документ с типом mimeType text/html, если Вы не вызываете явно метод document.open в обработчике события. Можно использовать метод write для генерации HTML и кода JavaScript. Однако разборщик HTML читает генерируемый код так, как он написан, поэтому Вам может понадобиться использовать escape-кодирование некоторых символов. Например, следующий метод write генерирует комментарий и записывает его в окно window2: window2=window.open('','window2') beginComment="\<!--" endComment="--\>" window2.document.write(beginComment) window2.document.write(" Это текст комментария. ") window2.document.write(endComment) Печать, сохранение и просмотр сгенерированного HTML. В браузере Navigator 3.0 и позже пользователи могут печатать и сохранять генерируемый HTML, используя команды из меню File. Если Вы используете Page Source из меню View в Navigator или View Frame Source после щелчка правой кнопкой мыши и открытия дополнительного меню, web-браузер отображает содержимое HTML-файла со сгенерированным HTML. Если Вам нужно просмотреть исходный код HTML с кодом скриптов, генерирующих HTML (методами document.write и document.writeln), не используйте пункты меню Page Source или View Frame Source. Здесь нужно ввести view-source: протокол. Например, предположим, что файл file://c|/test.html содержит такой текст: <HTML> <BODY> Hello, <SCRIPT>document.write(" there.")</SCRIPT> </BODY> </HTML> Если загрузить этот URL в web-браузер, он отобразит: Hello, there. Если выбрать View Document Source, браузер отобразит: <HTML> <BODY> Hello,  there. </BODY> </HTML> Если загрузить view-source:file://c|/test.html, браузер отобразит: <HTML> <BODY> Hello, <SCRIPT>document.write(" there.")</SCRIPT> </BODY> </HTML> О специфицировании view-source: protocol в объекте location см. объект Location. Примеры Здесь метод write принимает несколько аргументов, в том числе строки, числа и переменную: var mystery = "world" // Выводится Hello world testing 123 msgWindow.document.write("Hello ", mystery, " testing ", 123) В следующем примере метод write принимает два аргумента. Первый - это выражение присвоения, а второй - строковой литерал. //Выводится Hello world... msgWindow.document.write (mystr = "Hello ", "world...") В следующем примере метод write принимает единственный аргумент, который является условным выражением. Если значение переменной age будет меньше 18, метод выведет "Minor." Если значение age будет больше или равно 18, метод выведет "Adult." msgWindow.document.write(status = (age >= 18) ? "Adult" : "Minor") См. также document.close, document.open, document.writeln writeln Записывает одно или более выражений HTML в документ в специфицированном окне с последующим символом новой строки. Метод из document Реализован в JavaScript 1.0 Синтаксис writeln(expr1[, ... exprN]) Параметры expr1, ... exprN Любые выражения JavaScript. Описание Метод writeln выводит любое количество выражений в документ окна. Вы можете специфицировать любое выражение JavaScript, включая числа, строки или логические выражения. Метод writeln это тот же метод, что и write, за исключением того, что метод writeln присоединяет символы новой строки в конец вывода. HTML игнорирует символы новой строки, за исключением некоторых тэгов, таких как PRE. Используйте метод writeln внутри тэгов SCRIPT или в обработчике событий. Обработчики событий выполняются после закрытия оригинального документа, поэтому метод writeln будет неявно открывать новый документ типа mimeType text/html, если Вы не вызываете явно метод document.open в обработчике события. В Navigator 3.0 и позднее пользователи могут печатать и сохранять сгенерированный HTML, используя команды меню File браузера. Примеры Все пример для метода write верны также и для метода writeln. См. также document.close, document.open, document.write Оглавление | Назад | Вперёд | Индекс Дата последнего обновления: 28 мая 1999 года. Copyright (c) 1999 Netscape Communications Corporation Если необходимая Вам документация отсутствует на нашем сайте, то вы можете заказать ее. Сообщите нам, и мы постараемся добавить ее как можно скорее. Сайт принадлежит группе Luksian group