[Содержание] [Предыдущая] [Следующая] [Индекс]

---

document

Содержит информацию о текущем документе, и обеспечивает методы для отображения HTML.

Объект client-side
Реализовано в	Navigator 2.0 Navigator 3.0: добавлен синтаксис onBlur и onFocus; добавлены свойства applets, domain, embeds, forms, formName, images и plugins. Navigator 4.0: добавлено свойство layers; добавлены методы captureEvents, 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. Эти массивы содержат записи для каждого якоря, формы или ссылки в документе и свойства объекта document.

Не используйте location как свойство объекта document; вместо этого используйте свойство document.URL. Свойство document.location, которое является синонимом document.URL, будет удалено в будущих выпусках.

Резюме Свойств

alinkColor	Строка, которая определяет атрибут ALINK.
anchors	Массив, содержащий запись для каждого якоря в документе.
applets	Массив, содержащий запись для каждого апплета в документе.
bgColor	Строка, которая определяет атрибут BGCOLOR.
cookie	Определяет файл cookie.
domain	Определяет доменное имя сервера, который обслуживал документ.
embeds	Массив, содержащий запись для plug-in в документе.
fgColor	Строка, которая определяет аттрибут TEXT.
formName	Отдельное свойство для каждой именованной формы в документе.
forms	Массив, содержащий запись для каждой формы в документе.
images	Массив, содержащий запись для каждого изображения в документе.
lastModified	Строка, которая определяет дату последней модификации документа.
layers	Массив, содержащий запись для каждого уровня внутри документа.
linkColor	Строка, которая определяет аттрибут LINK.
links	Массив, содержащий запись для каждой ссылки в документе.
plugins	Массив, содержащий запись для каждого plug-in в документе.
referrer	Строка, которая определяет URL вызвавшего документа.
title	Строка, которая определяет содержание тэга TITLE.
URL	Строка, которая определяет полный URL документа.
vlinkColor	Строка, которая определяет атрибут VLINK.

Резюме Методов

captureEvents	Устанавливает фиксирование всех событий определенного типа для документа.
close	Закрывает поток вывода и вынуждает данные отобразиться.
getSelection	Возвращает строку, содержащую текущий выбранный текст.
handleEvent	Вызывает обработчик для указанного события.
open	Открывает поток, чтобы собрать вывод методов write или writeln.
releaseEvents	Освобождает зафиксированные события определенного типа для окна или документа, посылая событие к объектам далее по иерархии события.
routeEvent	Передает зафиксированное событие по нормальной иерархии события.
write	Записывает одно или большее количество выражений HTML в документ в определенном окне.
writeln	Записывает одно или большее количество выражений HTML в документу в определенном окне и следующий за ними символом новой строки.

Примеры

Следующий пример создает два кадра, каждый с одним документом. Документ в первом кадре содержит ссылки на якоря в документе второго кадра. Каждый документ определяет свои цвета.

doc0.html, который определяет кадры, содержит следующий код:

<HTML>
<HEAD>
<TITLE>Пример объекта document</TITLE>
</HEAD>
<FRAMESET COLS="30%,70%">
<FRAME SRC="doc1.html" NAME="frame1">
<FRAME SRC="doc2.html" NAME="frame2">
</FRAMESET>
</HTML>

doc1.html, который определяет содержание первого кадра, содержит следующий код:

<HTML>
<SCRIPT>
</SCRIPT>
<BODY
   BGCOLOR="antiquewhite"
   TEXT="darkviolet"
   LINK="fuchsia"
   ALINK="forestgreen"
   VLINK="navy">
<P><B>Некоторые ссылки</B>
<LI><A HREF="doc2.html#numbers" TARGET="frame2">Числа</A>
<LI><A HREF="doc2.html#colors" TARGET="frame2">Цвета</A>
<LI><A HREF="doc2.html#musicTypes" TARGET="frame2">Типы музыки</A>
<LI><A HREF="doc2.html#countries" TARGET="frame2">Страны</A>
</BODY>
</HTML>

doc2.html, который определяет содержание второго кадра, содержит следующий код:

<HTML>
<SCRIPT>
</SCRIPT>
<BODY
   BGCOLOR="oldlace" onLoad="alert('Привет, Мир.')"
   TEXT="navy">
<P><A NAME="numbers"><B>Некоторые числа</B></A>
<UL><LI>один
<LI>два
<LI>три
<LI>четыре</UL>
<P><A NAME="colors"><B>Некоторые цвета</B></A>
<UL><LI>красный
<LI>оранжевый
<LI>желтый
<LI>зеленый</UL>
<P><A NAME="musicTypes"><B>Некоторые типы музыки</B></A>
<UL><LI>R&B
<LI>Джаз
<LI>Soul
<LI>Reggae</UL>
<P><A NAME="countries"><B>Некоторые страны</B></A>
<UL><LI>Афганистан
<LI>Бразилия
<LI>Канада
<LI>Финляндия</UL>
</BODY>
</HTML>

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

Frame, Window

Свойства

alinkColor

Строка, определяющая цвет активной ссылки (после того, как кнопка мыши нажата, но прежде чем кнопка мыши отпущена).

Свойство объекта	document
Реализовано в	Navigator 2.0

Описание

Свойство alinkColor выражено как шестнадцатеричное RGB значение или как один из строковых литералов, перечисленных в Приложении B, "Цветовые Значения," в Руководстве по JavaScript. Это свойство JavaScript реализация аттрибута ALINK тэга BODY. Вы не можете устанавливать это свойство после того, как HTML источник был размещен через уровень.

Если Вы выражаете цвет как шестнадцатеричное значение RGB, Вы должны использовать формат rrggbb. Например, шестнадцатеричные значения RGB для оранжево-розового red=FA, green=80 и blue=72, так что RGB значение для оранжево-розового равно "FA8072".

Примеры

Следующий пример устанавливает цвет активных ссылок, используя строковый литерал:

document.alinkColor="aqua"

Следующий пример устанавливает цвет активных ссылок в aqua, используя шестнадцатеричный триплет:

document.alinkColor="00FFFF"

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

document.bgColor, document.fgColor, document.linkColor, document.vlinkColor

anchors

Массив объектов, соответствующих именованным якорям в исходном порядке.

Свойство объекта	document
Только для чтения
Реализовано в	Navigator 2.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
Только для чтения
Реализовано в	Navigator 3.0

Описание

Вы можете обрщаться к апплетам в Вашем коде, используя массив 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]

bgColor

Строка, определяющая цвет фона документа.

Свойство объекта	document
Реализовано в	Navigator 2.0

Описание

Свойство bgColor выражается как шестнадцатеричное RGB значение или как один из строковых литералов, перечисленных в Приложении B, "Значения Цветов", в Руководстве по JavaScript. Это свойство JavaScript реализация аттрибута BGCOLOR тэга BODY. Значение по умолчанию этого свойства устанавливается пользователем в диалоговом окне свойств.

Если Вы выражаете цвет как шестнадцатеричное значение RGB, Вы должны использовать формат rrggbb. Например, шестнадцатеричное значения RGB для оранжево-розового red=FA, green=80 и blue=72, так что RGB значение для salmon равно "FA8072".

Примеры

Следующий пример устанавливает цвет фона документа в aqua, используя строковый литерал:

document.bgColor="aqua"

Следующий пример устанавливает цвет фона документа в aqua, используя шестнадцатеричный триплет:

document.bgColor="00FFFF"

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

document.alinkColor, document.fgColor, document.linkColor, document.vlinkColor

cookie

Строковое значение, представляющее все файлы cookie, связанные с этим документом.

Свойство объекта	document
Реализовано в	Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Файл cookie это маленький фрагмент информации, сохраненной web браузером в файле cookies.txt. Используйте методы объекта String, такие как substring, charAt, indexOf и lastIndexOf, чтобы определить значение, сохраненное в файле cookie. Смотрите Руководство по JavaScript для полной спецификации синтаксиса файла cookie.

Вы можете устанавливать свойство cookie в любое время.

Компонент "expires=" в файле cookie устанавливает дату окончания использования файла cookie, так что она сохраняется вне текущей сессии браузера. Эта строка даты форматируется следующим образом:

Wdy, DD-Mon-YY HH:MM:SS GMT

Этот формат представляет следующие значения:

• Wdy является строкой, представляющей полное имя дня недели.
• DD является целым числом, представляющим день месяца.
• Mon является строкой, представляющей трех-символьное сокращение месяца.
• YY является целым числом, представляющим последние две цифры года.
• HH, MM и SS двух-числовое представление часов, минут и секунд, соответственно.

Например, допустимая дата окончания использования файла cookie

expires=Wednesday, 09-Nov-99 23:12:40 GMT

Формат даты файла cookie такой же, как дата, возвращенная toGMTString, со следующими исключениями:

• Добавляется черта между днем, месяцем и годом.
• Для файлов cookie год является двух-числовым значением.

Примеры

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

function RecordReminder(time, expression) {
   // Записывает cookie в форме "@<T>=<E>", чтобы отобразить 
   // <T> в миллисекундах начиная с периода, возвращенного
   // Date.getTime(), на закодированное выражение <E>
   // (закодированное, чтобы не содержать незаполненное
   // пространство, точку с запятой, или символы запятой)
   document.cookie = "@" + time + "=" + expression + ";"
   // Устанавливает время окончания использования файла cookie
   // к одному дню после времени напоминания
   document.cookie += "expires=" + cookieDate(time + 24*60*60*1000)
   // CookieDate - функция, которая форматирует дату 
   // согласно спецификациям файла cookie
}

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

Hidden

domain

Определяет доменное имя сервера, который обслуживал документ.

Свойство объекта	document
Реализовано в	Navigator 3.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Navigator 3.0: Свойство 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 содержит host-имя 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
Только для чтения
Реализовано в	Navigator 3.0

Описание

Вы можете ссылаться к внедренным объектам (созданным тэгом 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]

Элементы массива embeds могут иметь общие вызываемые функции, если они обращаются к plug-in, который использует LiveConnect. Смотрите Руководство по JavaScript.

Используйте элементы массива embeds, чтобы взаимодействовать с plug-in, который отображает внедренный объект. Если plug-in не доступен Java, Вы ничего не можете делать с элементом массива embeds. Поля и методы элементов массива embeds изменяются от plug-in к plug-in; смотрите документацию, обеспеченную изготовителем plug-in.

Когда Вы используете тэг EMBED, чтобы генерировать вывод из приложения plug-in, Вы не создаете объект Plugin.

Примеры

Следующий код включает звуковой plug-in в документ.

<EMBED SRC="train.au" HEIGHT=50 WIDTH=250>

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

Plugin

fgColor

Строка, определяющая цвет текста документа (основной тест).

Свойство объекта	document
Реализовано в	Navigator 2.0

Описание

Свойство fgColor выражается как шестнадцатеричное RGB значение или как один из строковых литералов, перечисленных в Приложении B, "Значения Цветов", в Руководстве по JavaScript. Это свойство JavaScript реализация аттрибута TEXT тэга BODY. Значение по умолчанию этого свойства устанавливается пользователем в диалоговом окне свойств. Вы не можете устанавливать это свойство после того, как HTML источник был размещен через уровень.

Если Вы выражаете цвет как шестнадцатеричное значение RGB, Вы должны использовать формат rrggbb. Например, шестнадцатеричные значения RGB для оранжево-розового равны red=FA, green=80 и blue=72, так что RGB значение salmon равно "FA8072".

Вы можете переназначить значение, установленное в свойстве fgColor, одним из следующих способов:

• Установкой аттрибута COLOR тэга FONT.
• Используя метод fontcolor.

formName

Свойство объекта	document
Реализовано в	Navigator 3.0

Объект document содержит отдельное свойство для каждой формы в документе. Имя этого свойства значение аттрибута NAME. Смотрите Form для информации об объекте Form. Вы не можете добавлять новые формы к документу, создавая новые свойства, но Вы можете изменять форму, изменяя этот объект.

forms

Массив, содержащий записи для каждой формы в документе.

Свойство объекта	document
Только для чтения
Реализовано в	Navigator 3.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита 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 формы.

images

Массив, содержащий записи для каждого изображения в документе.

Свойство объекта	document
Только для чтения
Реализовано в	Navigator 3.0

Вы можете обращаться к изображениям в документе, используя массив 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]

lastModified

Строка, представляющая дату последней модификации документа.

Свойство объекта	document
Только для чтения
Реализовано в	Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Свойство lastModified получается из HTTP заголовка, посланного с web сервера. Серверы вообще получают эту дату, исследуя дату изменения файла.

Дата последней модификации необязательная часть заголовка, и некоторые серверы не обеспечивают ее. Если сервер не возвращает информацию о последней модификации, JavaScript получает 0, который показывает ее как 1 января, 1970 GMT. Следующие проверки даты, возвращенные lastModified, соответствуют неизвестности.

lastmod = document.lastModified // получает строку даты последней модификации
lastmoddate = Date.parse(lastmod)   // преобразует эту строку в дату
if(lastmoddate == 0){               // неизвестная дата (или 1 июля, 1970 GMT)
   document.writeln("Lastmodified: Неизвестна")
   } else {
   document.writeln("LastModified: " + lastmod)
}

Примеры

В следующем примере, свойство lastModified используется в тэге SCRIPT в конце файла HTML для отображения даты модификации страницы:

document.write("Эта страница модифицирована " + document.lastModified)

layers

Свойство layers это массив, содержащий записи для каждого уровня внутри документа.

Свойство объекта	document
Реализовано в	Navigator 4.0

Описание

Вы можете ссылаться к уровням в Вашем коде, используя массив 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-порядке от последнего к первому, где 0 - самый нижний уровень, и более высокие уровни индексированы последовательными целыми числами. Индекс уровня не тоже самое, что его свойство zIndex, поскольку последнее не обязательно перечисляет уровни с последовательными целыми числами. Смежные уровни могут иметь одинаковое значение свойства zIndex.

Это допустимые способы доступа к объектам уровня:

document.layerName 
document.layers[Индекс] 
document.layers["layerName"] 
// пример использования свойства уровней для обращения ко вложенным уровням:
document.layers["parentlayer"].layers["childlayer"]

Элементы массива уровней это объекты JavaScript, которые не могут быть установлены присваиванием, хотя их свойства могут быть установлены. Например, выражение

document.layers[0]="music"

является недопустимым (и игнорируется), потому что оно пытается изменить массив layers. Однако, свойства объектов в массиве, читаемы и некоторые перезаписываемы. Например, выражение

document.layers["suspect1"].left = 100;

является допустимым. Оно устанавливает горизонтальную позицию уровня в 100. Следующий пример устанавливает цвет фона синим для уровня bluehouse, который вложен в уровень houses.

document.layers["houses"].layers["bluehouse"].bgColor="blue";

linkColor

Строка, определяющая цвет гиперссылок документа.

Свойство объекта	document
Реализовано в	Navigator 2.0

Описание

Свойство linkColor выражается как шестнадцатеричное RGB значение или как один из строковых литералов, перечисленных в Руководство по JavaScript. Это свойство JavaScript реализация аттрибута LINK тэга BODY. Значение по умолчанию этого свойства устанавливается пользователем в диалоговом окне свойств. Вы не можете устанавливать это свойство после того, как HTML источник был размещен через уровень.

Если Вы выражаете цвет как шестнадцатеричное значение RGB, Вы должны использовать формат rrggbb. Например, шестнадцатеричные значения RGB для оранжево-розового равны red=FA, green=80 и blue=72, так что RGB значение оранжево-розового равно "FA8072".

Примеры

Следующий пример устанавливает цвет ссылок документа в aqua, используя строковый литерал:

document.linkColor="aqua"

Следующий пример устанавливает цвет ссылок документа в aqua, используя шестнадцатеричный триплет:

document.linkColor="00FFFF"

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

document.alinkColor, document.bgColor, document.fgColor, document.vlinkColor

links

Массив объектов, соответствующих объектам Area и Link в исходном порядке.

Свойство объекта	document
Только для чтения
Реализовано в	Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Вы можете ссылаться к объектам Area и Link в Вашем коде, используя массив links. Этот массив содержит запись для каждого объекта Area (тэг <AREA HREF="...">) и Link (тэг <A HREF="...">) в документе в исходном порядке. Он также содержит ссылки, созданные методом link. Например, если документ содержит три ссылки, Вы можете обратиться к ним как:

document.links[0]
document.links[1]
document.links[2]

plugins

Массив объектов, соответствующих объектам Plugin в исходном порядке.

Свойство объекта	document
Только для чтения
Реализовано в	Navigator 3.0

Вы можете ссылаться к объектам Plugin в Вашем коде, используя массив plugins. Этот массив содержит запись для каждого объекта Plugin в документе в исходном порядке. Например, если документ содержит три plugin, Вы можете обратиться к ним как:

document.plugins[0]
document.plugins[1]
document.plugins[2]

referrer

Определяет URL вызвавшего документа, когда пользователь щелкает по ссылке.

Свойство объекта	document
Только для чтения
Реализовано в	Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Когда пользователь перемещается к адресуемому документу, щелкая по объекту Link в исходном документе, свойство referrer содержит URL исходного документа.

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

Примеры

В следующем примере, функция getReferrer вызывается из текущего документа. Она возвращает URL исходного документа.

function getReferrer() {
   return document.referrer
}

title

Строка, представляющая заголовок документа.

Свойство объекта	document
Только для чтения
Реализовано в	Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Свойство title отражает значение, определенное между начальным и конечным тэгами TITLE. Если документ не имеет заголовка, свойство title равно null.

Примеры

В следующем примере, значение свойства title присваивается пременной, названной docTitle:

var newWindow = window.open("http://home.netscape.com")
var docTitle = newWindow.document.title

URL

Строка, определяющая полный URL документа.

Свойство объекта	document
Только для чтения
Реализовано в	Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

URL строковое свойство, содержащее полный URL документа. Оно обычно соответствует тому, во что устанавливается window.location.href, когда Вы загружаете документ, но переадресация может изменить location.href.

Примеры

Следующий пример показывает URL текущего документа:

document.write("Текущий URL " + document.URL)

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

Location.href

vlinkColor

Строка, определяющая цвет посещенных ссылок.

Свойство объекта	document
Реализовано в	Navigator 2.0

Описание

Свойство vlinkColor выражается, как шестнадцатеричное RGB значение или как один из строковых литералов, перечисленных в Руководстве по JavaScript. Это свойство JavaScript реализация аттрибута VLINK тэга BODY. Значение по умолчанию этого свойства устанавливается пользователем в диалоговом окне свойств. Вы не можете устанавливать это свойство после того, как HTML источник был размещен через уровень.

Если Вы выражаете цвет как шестнадцатеричное значение RGB, Вы должны использовать формат rrggbb. Например, шестнадцатеричные значения RGB для оранжево-розового равны red=FA, green=80 и blue=72, так что RGB значение оранжево-розового равно "FA8072".

Примеры

Следующий пример устанавливает цвет посещенных ссылок в aqua, используя строковый литерал:

document.vlinkColor="aqua"

Следующий пример устанавливает цвет активных ссылок в aqua, используя шестнадцатеричный триплет:

document.vlinkColor="00FFFF"

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

document.alinkColor, document.bgColor, document.fgColor, document.linkColor

Методы

captureEvents

Устанавливает фиксирование всех событий определенного типа для документа.

Метод объекта	document
Реализовано в	Navigator 4.0

Синтаксис

captureEvents(eventType)

Параметры

eventType

Тип события, которое будет зафиксировано. Допустимые типы событий перечислены в описании объекта event.

Описание

Когда окно с кадрами хочет фиксировать события в страницах, загруженных из различных мест (серверов), Вы должны использовать Window.captureEvents в подписанном сценарии перед Window.enableExternalCapture. Для подробной информации и примеров, смотрите Window.enableExternalCapture. captureEvents работает в тандеме с releaseEvents, routeEvent и handleEvent. Для подробной информации, смотрите "События в Navigator 4.0".

close

Закрывает поток вывода и вынуждает данные отобразиться.

Метод объекта	document
Реализовано в	Navigator 2.0

Синтаксис

close()

Параметры

Нет.

Описание

close закрывает поток, открытый методом document.open. Если поток был открыт к размещению, метод close вынуждает содержание потока отобразиться. Тэги стиля шрифта, типа BIG и CENTER, автоматически выводят поток размещения.

Метод close также останавливает "движение метеора" в пиктограмме Netscape и показывает "Document: Done" в строке состояния.

Примеры

Следующая функция вызывает document.close, чтобы закрыть поток, который был открыт document.open. Метод document.close вынуждает содержание потока отобразиться в окне.

function windowWriter1() {
   var myString = "Привет, Мир!"
   msgWindow.document.open()
   msgWindow.document.write(myString + "<P>")
   msgWindow.document.close()
}

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

document.open, document.write, document.writeln

getSelection

Возвращает строку, содержащую текущий выбранный текст.

Метод объекта	document
Реализовано в	Navigator 4.0

Синтаксис

getSelection()

Описание

Этот метод работает только в текущем документе.

Защита

Вы не можете определить выбранные области в другом окне.

Примеры

Если Вы имеете форму со следующим кодом, и Вы нажимаете на кнопку, JavaScript показывает окно предупреждения, содержащее в настоящее время выбранный текст из окна, содержащего кнопку:

<INPUT TYPE="BUTTON" NAME="getstring" 
   VALUE="Show highlighted text (if any)" 
   onClick="alert('Вы выбрали:\n'+document.getSelection());">

handleEvent

Вызывает обработчик для указанного события.

Метод объекта	document
Реализовано в	Navigator 4.0

Синтаксис

handleEvent(event)

Параметры

event

Имя события, для которого определенный объект имеет обработчик события.

Описание

Для информации об обработке событий, смотрите "Общая Информация о Событиях".

open

Открывает поток, чтобы собрать вывод методов write или writeln.

Метод объекта	document
Реализовано в	Navigator 2.0 Navigator 3.0: добавлен параметр "replace"; document.open() или document.open("text/html") очищают текущий документ, если он закончил загрузку

Синтаксис

open(mimeType, replace)

Параметры

mimeType	(Факультативный) Строка, определяющая тип документа, в который Вы записываете. Если Вы не определяете mimeType, берется значение по умолчанию text/html.
replace	(Факультативный) Строка "replace". Если Вы обеспечиваете этот параметр, mimeType должен быть "text/html". Заставляет новый документ многократно использовать запись истории, которую использовал предыдущий документ.

Описание

Типовые значения для 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 типы plug-in доступны только, если пользователь установил требуемое программное обеспечение plug-in.

Метод open открывает поток, чтобы собрать вывод методов write или writeln. Если mimeType равен text или image, поток открыт к размещению; иначе, поток открыт к plug-in. Если документ существует в целевом окне, метод open очистит его.

Закройте поток, используя метод document.close. Метод close заставляет текст или изображения, которые были посланы размещению, отобразиться. После использования document.close, вызовите document.open снова, когда Вы хотите начать другой поток вывода.

В Navigator 3.0 и в более поздних, document.open или document.open("text/html") очищают текущий документ, если он закончил загружаться. Потому что этот тип вызова open записывает заданный по умолчанию тэг <BASE HREF=>, так что Вы можете генерировать относительные URL, основанные на генерирующейся сценарием базе документа.

Ключ "replace" заставляет новый документ многократно использовать запись истории хронологии, которую использовал предыдущий документ. Когда Вы определяете "replace" при открытии документа, длина хронологии целевого окна не увеличивается даже после того, как Вы записываете и закрываете.

"replace" обычно используется окном, которое имеет пустой документ или "about:blank" URL. После того, как "replace" определен, метод write обычно генерирует HTML для окна, заменяя запись истории для пустого URL. Соблюдайте осторожность при использовании сгенерированного HTML в окне с пустым URL. Если Вы не определяете "replace", сгенерированный HTML имеет собственную запись истории, и пользователь может нажимать кнопку "Назад" и переходить назад, пока кадр не пуст.

После выполнения document.open("text/html","replace"), history.current для целевого окна равно URL документа, который выполнил document.open.

Примеры

Пример 1. Следующая функция вызывает document.open для открытия потока перед выдачей метода write:

function windowWriter1() {
   var myString = "Привет, Мир!"
   msgWindow.document.open()
   msgWindow.document.write("<P>" + myString)
   msgWindow.document.close()
}

Пример 2. Следующая функция вызывает document.open с ключевым словом "replace" для открытия потока перед выдачей методов write. HTML код в методах write записывается в msgWindow, заменяя текущую запись истории. Длина истории msgWindow не увеличивается.

function windowWriter2() {
   var myString = "Привет, Мир!"
   msgWindow.document.open("text/html","replace")
   msgWindow.document.write("<P>" + myString)
   msgWindow.document.write("<P>history.length равно " + 
      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

releaseEvents

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

Метод объекта	document
Реализовано в	Navigator 4.0

Обратите внимание

Если первоначальный адресат события окно, оно получит событие, даже если этот тип события выпущен.

Синтаксис

releaseEvents(eventType)

Параметры

eventType

Тип события, которое будет зафиксировано.

Описание

releaseEvents работает в тандеме с captureEvents, routeEvent и handleEvent. Для подробной информации, смотрите "События в Navigator 4.0".

routeEvent

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

Метод объекта	document
Реализовано в	Navigator 4.0

Синтаксис

routeEvent(event)

Параметры

event

Имя события, которое будет передано.

Описание

Если подобъект (документ или уровень) также фиксирует событие, событие посылается этому объекту. Иначе, оно посылается первоначальному адресату.

routeEvent работает в тандеме с captureEvents, releaseEvents и handleEvent. Для подробной информации, смотрите "События в Navigator 4.0".

write

Записывает одно или более выражений HTML в документ в определенном окне.

Метод объекта	document
Реализовано в	Navigator 2.0 Navigator 3.0: пользователи могут печатать и сохранять сгенерированный HTML, используя команды в меню "Файл"

Синтаксис

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 читает сгенерированный код, как он был записан, так что Вам может быть придется избегать некоторых символов. Например, следующий метод write генерирует комментарий и записывает его в window2:

window2=window.open('','window2')
beginComment="\<!--"
endComment="--\>"
window2.document.write(beginComment)
window2.document.write(" Это некоторый текст внутри комментария. ")
window2.document.write(endComment)

Печать, сохранение и просмотр сгенерированного HTML

В Navigator 3.0 и более поздних, пользователи могут печатать и сохранять сгенерированный HTML, используя команды меню "Файл".

Если Вы выбираете "Источник Документа" или "Источник Рамки" из меню "Вид", web браузер показывает содержимое файла HTML со сгенерированным HTML. (Тоже, что было бы отображено при использовании wysiwyg: URL.)

Если Вы взамен хотите просмотреть источник HTML, показывающий сценарии, которые генерируют HTML (с использованием методов document.write и document.writeln), не используйте пункты меню "Источник Документа" или "Источник Кадра". В этом случае, используйте протокол view-source:.

Например, примите, что файл file://c|/test.html содержит этот текст:

<HTML>
<BODY>
Привет, 
<SCRIPT>document.write(" там.")</SCRIPT>
</BODY>
</HTML>

Если Вы загружаете этот URL в web браузер, показывается следующее:

Привет, там.

Если Вы выбираете "Просмотр Источника Документа", браузер показывает:

<HTML>
<BODY>
Привет, 
 там.
</BODY>
</HTML>

Если Вы загружаете view-source:file://c|/test.html, браузер показывает:

<HTML>
<BODY>
Привет, 
<SCRIPT>document.write(" там.")</SCRIPT>
</BODY>
</HTML>

Для информации об определении протокола view-source: в объекте location, смотрите описание объекта Location.

Примеры

В следующем примере, метод write принимает отдельные параметры, включая строки, число и переменную:

var mystery = "мир"
// Отображает "Привет мир, тест 123"
msgWindow.document.write("Привет ", mystery, " тест ", 123)

В следующем примере, объект write принимает два параметра. Первый параметр это выражение, и второй параметр это строковый литерал.

//Отображает "Привет мир...
msgWindow.document.write(mystr = "Привет ", "мир...")

В следующем примере, метод write берет один параметр, который является условным выражением. Если значение переменной age меньше чем 18, метод показывает "Маленький." Если значение age больше чем или равно 18, метод показывает "Взрослый."

msgWindow.document.write(status = (age >= 18) ? "Взрослый" : "Маленький")

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

document.close, document.open, document.writeln

writeln

Записывает один или большее количество выражений HTML в документ в определенном окне и следущий за ними символом новой строки.

Метод объекта	document
Реализовано в	Navigator 2.0 Navigator 3.0: пользователи могут печатать и сохранять сгенерированный HTML, используя команды меню "Файл"

Синтаксис

writeln(expr1, ... exprN)

Параметры

expr1, ... exprN

Любые выражения JavaScript.

Описание

Метод writeln показывает любое число выражений в окне документа. Вы можете определить любое выражение JavaScript, включая числовые, строковые или логические выражения.

Метод writeln тоже самое, что и метод write, за исключением того, что метод writeln добавляет символ новой строки к концу вывода. HTML игнорирует символ новой строки, за исключением внутри некоторых тэгов типа тэга PRE.

Используйте метод writeln внутри любого тэга SCRIPT или внутри обработчика события. Обработчики событий выполняются после того, как оригинал документа закрывается, так метод writeln неявно откроет новый документ с mimeType равным text/html, если Вы явно не зададите тип в методе document.open в обработчике события.

Примеры

Все примеры, используемые для метода write также допустимы для метода writeln.

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

document.close, document.open, document.write

---

[Содержание] [Предыдущая] [Следующая] [Индекс]

Последняя Модификация: 10/31/97 12:30:56

---

Права © 1997 Netscape Communications Corporation

---

Все мессаги сюда:yanich@inbox.ru