window NN 2   IE 3   DOM n/a

Объект window представляет собой окно браузера или фрейм, в котором отображено содержание документа. Объект window играет ключевую роль в создании сценария, когда тот должен обратиться к объектам документа, расположенным в других фреймах или подокнах. Internet Explorer 4 включает специальный вид подокна, называемый модальным диалоговым окном . Модальные диалоговые окна имеют много, но не все свойства и методы объекта window.

Ссылками top и parent можно воспользоваться, чтобы предотвратить воэможность отображения Вашего Web-узла внутри набора фреймов другого Web-узла. В этом поможет следующий сценарий:

<SCRIPT LANGUAGE="JavaScript">
if (top != self)
    top.location = location;
</SCRIPT>

Некоторые ошибки в NN2 приводят к проблемам при попытке доступа к переменным родительского окна из дочернего фрейма. Если документ в дочернем окне выгружается, значение переменной, определяемое в нём, исчезает.

 
 
Объектно-ориентированная модель
NN window
self
top
parent
IE window
self
top
parent

Свойства:

appCore, Components[ ], controllers[ ], prompter, sidebar NN 6
  Только чтение
 

NN6 обеспечивает сценариям доступ к различным службам из пакета xpConnect. Эти службы позволяют сценариям работать со свойствами COM-объектов и языка mozilla.org XUL (XML-based User Interface Language - Язык пользовательского интерфейса на основе XML). Документация по нему находится по адресу: http://www.mozilla.org/scriptable
clientInformation NN n/a  IE 4   DOM n/a
  Только чтение
 

Возвращает объект navigator. Объект navigator соответствует имени определенной марки браузера; свойство clientInformation - неочевидный путь доступа к важным переменным окружения, которые исторически были доступны через свойства и методы объекта navigator. В Internet Explorer Вы можете заменять window.clientInformation на любую ссылку, которая начинается с navigator.
 
Пример:

if (parseInt(window.clientInformation.appVersion) >= 4) { process code for IE 4 or later }
 
Возвращаемое значение:
Объект navigator.
 
Значение по умолчанию: Объект navigator.
clipboardData NN n/a  IE 5+ (кроме IE5/Mac)
  Чтение/Изменение
 

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

Объект clipboardData содержит три метода:

Метод Возвращаемое значение Описание
clearData([format]) Отсутствует Удаляет данные из буфера обмена. Если параметр формата не указан, происходит очистка всех данных. Параметром format могут быть одна или несколько опций: Text, URL, File, HTML, Image
GetData(format) Строка Извлекает данные из буфера обмена. Параметром format могут быть одна или несколько опций: Text, URL, File, HTML, Image. При получении данных очистка буфера обмена не происходит.
SetData(format, data) Булевого типа Сохраняет данные в буфере обмена. Параметром format могут быть одна или несколько опций: Text, URL, File, HTML, Image. Параметром data служит адрес URL к источнику (для нетекстовых форматов).
Метод возвращает true, если запись данных в буфер обмена прошла успешно.

Объект clipboardData нельзя использовать для обмена данными между страницами, источником которых послужили разные домены или протоколы.
 
 
 
Возвращаемое значение:
Объект clipboardData
 
Значение по умолчанию: Ничего
closed NN 3   IE 4   DOM n/a
  Только чтение
 

Булево значение, которое показывает, закрыто ли упомянутое окно. Значение true означает, что окно больше не доступно для ссылок на на его объекты или компоненты сценария. Это свойство часто используется, чтобы проверить, закрыл ли пользователь подокно, сгенерированное методом window.open()

 
Пример:

if (!newWindow.closed) { newWindow.document.write("<HTML><BODY><H1>Howdy!</H1></BODY></HTML>") newWindow.document.close( ) }
 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: Ничего.
crypto, pkcs11 NN 6
  Только чтение
 

Эти свойства содержат ссылки на объекты броузера, связанные с внутренними механизмами криптографии с открытым ключом. Документацию по ним можно найти по адресу: http://www.mozilla.org/projects/security
 
 
 
Возвращаемое значение:
Ссылка на объекты
 
Значение по умолчанию: Ничего.
defaultStatus NN 2   IE 3   DOM n/a
 Чтение/Изменение
 

Заданное по умолчанию сообщение, отображенное в строке состояния окна браузера, когда браузер не производит никаких действий. Большинство браузеров имеют проблемы с установкой свойства defaultStatus. Ожидайте странного поведения.

 
Пример:

window.defaultStatus = "Make it a great day!"

 
Возвращаемое значение:
Любое строковое значение.
 
Значение по умолчанию: Ничего.
dialogArguments NN n/a  IE 4   DOM n/a
 Только чтение
 

Строка или другой тип данных, пропущенный в качестве дополнительных параметров к модальному диалоговому окну , созданному методом showModalDialog().

 
Пример:

var allArgs = window.dialogArguments var firstArg = allArgs.substring(0, allArgs.indexOf(";"))

 
Возвращаемое значение:
Строка, число или массив.
 
Значение по умолчанию: Ничего.
dialogHeight, dialogWidth NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

Значения высоты и ширины модального диалогового окна, созданного методом showDialog(). Начальные значения установлены как параметры метода showDialog().

 
Пример:

var outerWidth = window.dialogWidth

 
Возвращаемое значение:
Строка включающая значение модуля.
 
Значение по умолчанию: Ничего.
dialogLeft, dialogTop NN n/a  IE 4   DOM n/a
  Чтение/Изменение
 

Расстояние смещения левой и верхней граней модального диалогового окна (созданного методом showDialog() ) относительно верхнего левого угла экрана. Начальные значения установлены как параметры метода showDialog().
 
Пример:

var outerLeft = window.dialogLeft
 
Возвращаемое значение:
Строка включающая значение модуля.
 
Значение по умолчанию: Ничего.
document JavaScript 1.0
  Только чтение
 

Объект document, загруженный в броузер или фрейм. см. объект document
 

 
 
Возвращаемое значение:
объект document
 
Значение по умолчанию: объект document
event NN n/a  IE 4   DOM n/a
  Только чтение
 

Модель событий Internet Explorer 4 генерирует объект event для каждого пользовательского или системного события. Этот объект event - свойство объекта window.
 
Пример:

if (event.altKey) { handle case of Alt key down }
 
Возвращаемое значение:
Ссылка на объект event
 
Значение по умолчанию: Ничего.
external NN n/a  IE 4 (кроме IE5/Mac)
  Только чтение
 

Это свойство полезно лишь тогда, когда окно броузера выступает компонентой другого приложения. Это свойство - своего рода шлюз между текущим окном броузера и приложением, действующим как хост для него.

Когда IE4+ действует как компонент операционной системы-хоста, свойством external можно воспользоваться для доступа к методам, управляющим поведением документа за пределами окна броузера.

Три самых полезных метода - addDesktopComponent(), addFavorite() и NavigateAndFind()

Метод Параметры Описание
addDesktopComponent("URL", "type"[, left,top,width,height])

URL - адрес ресурса

type - одно из 2 значений: website, image

Остальные параметры - целые числа

 Добавляет Web-узел или изображение на рабочий стол. Сопровождается диалоговым окном подтверждения.
addFavorite("URL"[, "title"])

URL - адрес ресурса

title - запись в списке меню

 Добавляет заданный URL в список избранного. Сопровождается диалоговым окном подтверждения.
NavigateAndFind("URL", "findString", target)

URL - адрес ресурса, к которому следует перейти

findString - строка, поиск которой осуществляется

target - целевой объект (_blank, _self и пр.)

 Переходит к указанному URL и выделяет найденный текстовый фрагмент.
 
 
 
Возвращаемое значение:
Объект
 
Значение по умолчанию: Объект.
frameElement NN n/a  IE 5.5
  Только чтение
 

Если текущее окно задаётся дескриптором <FRAME> или <IFRAME>, его свойство frameElement содержит ссылку на элемент, содержащийся в нём.
 
Пример:

var frameSetObj = self.frameElement.parentElement
 
Возвращаемое значение:
Объект FRAME или IFRAME
 
Значение по умолчанию: Ничего
frames JavaScript 1.0
  Только чтение
 

Содержит массив указателей на вложенные фреймы. см. frames
 
Пример:

var frameTitle = self.frames[i].document.title
 
Возвращаемое значение:
Массив фреймов
 
Значение по умолчанию: Ничего
history NN 2   IE 3   DOM n/a
 Только чтение
 

Содержит объект history текущего окна или фрейма. Для подробностей, см. обсуждение объекта history.

 
Пример:

if (self.history.length > 4) { ... }

 
Возвращаемое значение:
Ссылка на объект history
 
Значение по умолчанию: Текущий объект history.
innerHeight, innerWidth NN 4   IE n/a  DOM n/a
 Чтение/Изменение
 

Размер в пикселах высоты и ширины области содержания окна браузера или фрейма. Эта область - только та, где отображается документ

 
Пример:

window.innerWidth = 600 window.innerHeight = 400

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего.
length NN n/a  IE 4   DOM n/a
  Только чтение
 

Число фреймов (если есть), вложенных внутрь текущего окна. Это значение - то же, что и возвращенное window.frames.length. Когда никаких фреймов не определено, значение нулевое.
 
Пример:

if (window.length > 0) { ... }
 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: 0
loading только NN 4
  Только чтение
 

Это свойство, специфическое для броузера NN4, позволяет узнать, загружает ли окно содержимое. Т.е.: загружает - true, не загружает - false.
 
 
 
Возвращаемое значение:
Булево
 
Значение по умолчанию: Нет
location NN 2   IE 3   DOM n/a
 Чтение/Изменение
 

URL документа, загруженного в настоящее время в окне или фрейме. Чтобы переместиться к другой странице, назначьте URL на свойство location.href (или см. методы navigate() для IE-only).

 
Пример:

top.location = "index.html"

 
Возвращаемое значение:
Полный или относительный URL как строка.
 
Значение по умолчанию: URL Документа.
directories, locationbar, menubar, personalbar, scrollbars, statusbar, toolbar NN 4   IE n/a  DOM n/a
 Только чтение
 

Каждое свойство возвращает ссылку на объект с тем же самым именем. Эти объекты - индивидуальные компоненты окна ("панели инструментов"), чья видимость может быть откорректирована или при создании нового окна (методом window.open() ) или в любое другое время. Чтобы получить разрешение изменить видимость этих элементов окна, которое уже существует, необходимы подписанные сценарии.

Изменение этих параметров не сказывается на настройках броузера по умолчанию.

 
Пример:

window.personalbar.visibility = false

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: Ссылка на объект.
name NN 2   IE 3   DOM 1
 Чтение/Изменение
 

Имя, связанное с фреймом или подокном для использования его значения, назначенного на атрибуты TARGET или для ссылок сценария на фрейм/подокно. Для фрейма значение обычно назначается через атрибут NAME тэга FRAME, но оно может изменяться сценарием в случае необходимости. Имя подокна назначено как параметр для метода window.open(). Первичное окно браузера по умолчанию не имеет имени.

 
Пример:

if (parent.frames[1].name == "main") { ... }

 
Возвращаемое значение:
Чувствительный к регистру идентификатор, который подчиняется правилам именования: не может содержать никаких пробелов, не может начинаться с цифры и не должен содержать пунктуационных символов кроме символа подчеркивания.
 
Значение по умолчанию: Ничего.
navigator NN 6  IE 4   DOM n/a
 Только чтение
 

Возвращает ссылку на объект navigator. Internet Explorer обрабатывает объект navigator как свойство окна даже при том, что область объекта navigator покрывает все окна или фреймы, существующие в настоящее время в браузере. Так как ссылка через window весьма дополнительна, в Internet Explorer и Navigator синтаксис работает без ссылки на окно.

 
Пример:

var theBrowser = navigator.appName

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: Объект navigator.
offscreenBuffering NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 
Должен ли браузер использовать за кадром буферизацию, чтобы улучшить выполнение анимации. Это свойство применяется только к платформам операционной системы Windows 95/NT. Броузер IE заносит страницу в буфер (фрагмент памяти). Когда загружается документ, свойство установлено в auto. После этого сценарий может включать и выключать буферизацию, назначая Булево значение этому свойству.
 
Пример:

window.offscreenBuffering = "true"

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: auto
opener NN 3   IE 3   DOM n/a
 Чтение/Изменение
 

Ссылка на объект window (или frame) который сгенерировал текущее окно методом window.open(). Это свойство позволяет подокнам транслировать ссылки на объекты, переменные и функции в окно-родитель. Чтобы обращаться к объектам документа в окна-родителя, ссылка может начинаться с opener и проходить оттуда через всю иерархию объекта document, как показано в следующем примере. Отношения между этими двумя окнами не строго родительские-дочерние. Термин "родитель" имеет другие коннотации в сценарном окне и в ссылках фрейма.

 
Пример:

opener.document.forms[0].importedData.value = document.forms[0].entry.value

 
Возвращаемое значение:
Ссылка на объект window
 
Значение по умолчанию: Ничего.
outerHeight, outerWidth NN 4   IE n/a  DOM n/a
 Чтение/Изменение
 

Размер в пикселах высоты и ширины окна браузера или фрейма, включая (для верхнего окна) все панели инструментов, scollbars и т. п.

 
Пример:

window.outerWidth = 80 window.outerHeight = 600

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего.
pageXOffset, pageYOffset NN 4   IE n/a  DOM n/a
 Только чтение
 

Размер в пикселах содержания страницы, которое было прокручено вверх и/или налево. Например, если документ был прокручен так, что самые верхние 100 пикселов документа не видимы, потому что окно прокручено, значение pageYOffset для окна = 100. Когда документ не прокручен, оба значения нулевые.

 
Пример:

var vertScroll = self.pageYOffset

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: 0
parent NN 2   IE 3   DOM n/a
 Только чтение
 

Возвращает ссылку на родительский объект window, где находится объект frameset, в котором определен текущий фрейм. Используйте parent в формировании ссылки из дочернего фрейма к переменным или методам в родительском документе или к переменным, методам и объектам в другом дочернем фрейме. Например, если сценарий в одном дочернем фрейме должен сослаться на содержание элемента формы text в другом дочернем фрейме (названного "content"), ссылка была бы такая:

parent.content.document.forms[0].entryField.value

Для более глубоко вложенных фреймов, Вы можете обращаться к родителю родителя с синтаксисом типа: parent.parent.frameName.

 
Пример:

parent.frames[1].document.forms[0].companyName.value = "MegaCorp"

 
Возвращаемое значение:
Ссылка на объект window
 
Значение по умолчанию: Ничего.
returnValue NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

Значение, которое будет возвращено главному окну, когда IE закроет модальное диалоговое окно. Значение, назначенное на это свойство в сценарие, выполняющемся в окне диалога, возвращается как значение методу showModalDialog() в основном окне. Например, документ в модальном диалоговом окне может иметь инструкцию, которая устанавливает свойство returnValue с информацией от диалога:

window.returnValue = window.document.forms[0].userName.value

Диалог создан в основном документе следующей инструкцией :

var userName = showModalDialog("userNamePrompt.html")
 
Возвращаемое значение:
Любой скриптовый тип данных.
 
Значение по умолчанию: Ничего.
screen NN n/a  IE 4   DOM n/a
  Только чтение
 

Возвращает ссылку на объект screen. Internet Explorer обрабатывает объект screen как свойство объекта window даже при том, что область объекта screen превышает все окна или фреймы, существующие в настоящее время в браузере. Так как ссылка через window весьма дополнительна, в Internet Explorer и Navigator синтаксис работает без ссылки на окно.
 
Пример:

var howDeep = screen.availHeight
 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: Объект screen
screenLeft, screenTop NN n/a  IE 5+ (кроме IE5/Mac)
  Только чтение
 

Броузеры IE5+ поддерживают свойства screenLeft и screenTop объекта window, позволяющие получить расположения в пикселах (относительно верхнего левого угла монитора) элемента, который в терминологии Microsoft называется клиентской областью окна броузера. (та область, где отображается HTML-содержимое).
 

 
 
Возвращаемое значение:
Целочисленное
 
Значение по умолчанию: Зависит от положения
screenX, screenY NN 6
  Чтение/Изменение
 

Данные свойства используются в NN 6 для получения расположения внешней границы окна относительно левой верхней координаты монитора.
 

 
 
Возвращаемое значение:
Целочисленное
 
Значение по умолчанию: Зависит от положения
scrollX, scrollY NN 6
  Только чтение
 

Эти свойства позволяют определить положение горизонтальной и вертикальной полос прокрутки окна. Значения задаются в пикселах.
 
Пример:

var howDeep = screen.availHeight
 
Возвращаемое значение:
Целочисленное
 
Значение по умолчанию: 0
self NN 2   IE 3   DOM n/a
 Только чтение
 

Ссылка на текущее окно или фрейм. Это свойство синонимично с window, но иногда используется, чтобы улучшить ясность в сложном сценарие, который обращается ко многим окнам или фреймам. Никогда не используйте ссылку window.self, чтобы обратиться к текущему окну или фрейму.

 
Пример:

self.focus( )

 
Возвращаемое значение:
Ссылка на объект window
 
Значение по умолчанию: Текущее окно.
status NN 2   IE 3   DOM n/a
 Чтение/Изменение
 

Текст в строке состояния окна браузера. Установка некоторого сообщения в строке состояния рекомендуется только для временных сообщений, типа для одновременных нажатий клавиш мыши на картинках, картах или ссылках. Для показа двойных или одинарных кавычек в сообщении нужно использовать escape (\ '). Многие из пользователей не смотрят строку состояния, так что избегайте помещать там важную миссией информацию. Временные сообщения находятся в противоречии с управляемым браузером использованием строки состояния. Чтобы установить заданное по умолчанию сообщение строки состояния (когда все в покое), используйте свойство defaultStatus

 
Пример:

<...onMouseOver="window.status='Table of Contents';return true" onMouseOut = "window.status = '';return true">

 
Возвращаемое значение: Строка.
 
Значение по умолчанию: Empty string.
top NN 2   IE 3   DOM n/a
  Только чтение
 

Ссылка на окно браузера. Инструкции сценария вложенных фреймов могут обращаться к свойствам и методам окна браузера, или к переменным или функциям, сохраненным в документе, загруженном в самой верхней позиции. Не начинайте ссылку с window.top, только с top. Чтобы заменять frameset на новый документ, который займёт полное окно браузера, назначьте URL на свойство top.location.href.
 
Пример:

top.location.href = "tableOfContents.html"
 
Возвращаемое значение:
Ссылка на объект window
 
Значение по умолчанию: Окно браузера.
window NN 2   IE 3   DOM n/a
  Только чтение
 

Значение свойства window совпадает с объектом window. Однако нет необходимости использовать ссылки типа window.window. Это свойство служит для того, чтобы инструкции
window.свойство_или_метод;
и
свойство_или_метод;
были эквивалентны.
 
 
 
Возвращаемое значение:
объект window
 
Значение по умолчанию: Окно браузера.

Методы:

alert( ) NN 2   IE 3   DOM n/a

alert(message)

Отображает аварийное диалоговое окно с сообщением. Единственная кнопка позволяет пользователю закрывать диалог. Заголовок окна (и " JavaScript Alert" в более ранних версиях браузера) не может быть изменён сценарием.

 
Возвращаемое значение
None.
 
Параметры
message Любая строка
back( ) NN 4   IE n/a  DOM n/a

Отправляет на один шаг назад в списке хронологии окна или фрейма.

 
Возвращаемое значение
None.
 
Параметры
None.
blur( ) NN 3   IE 4   DOM n/a

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

 
Возвращаемое значение
None.
 
Параметры
None.
captureEvents( ) NN 4   IE n/a  DOM n/a

captureEvents(eventTypeList)

Инструктирует браузер перехватывать события определенного типа прежде, чем они достигают целевых объектов. Объекту, вызывающему этот метод должен быть определён обработчик события для данных типов событий.

 
Возвращаемое значение
None.
 
Параметры
eventTypeList Отделенный запятыми список типов событий с учетом регистра из доступных констант объекта Event: типа Event.CLICK или Event.MOUSEMOVE.
clearInterval( ) NN 4   IE 4   DOM n/a

clearInterval(intervalID)

Выключает интервальный цикл, упомянутый параметром intervalID . См. setInterval()

 
Возвращаемое значение
None.
 
Параметры
intervalID Целое число - возвращаемое значение метода setInterval()
clearTimeout( ) NN 2   IE 3   DOM n/a

clearTimeout(timeoutID)

Выключает счетчик задержки времени, упомянутый параметром timeoutID . См. setTimeout()

Пример:

function startTimer() {
    running = true
    now = new Date()
    now = now.getTime()
// change last multiple for the number of minutes
    endTime = now + (1000 * 60 * 1)
    showCountDown()
}

function showCountDown() {
    var now = new Date()
    now = now.getTime()
    if (endTime - now <= 0) {
        stopTimer()
        alert("Time is up. Put down your pencils.")
    }
    else {
        var delta = new Date(endTime - now)
        var theMin = delta.getMinutes()
        var theSec = delta.getSeconds()
        var theTime = theMin
        theTime += ((theSec < 10) ? ":0" : ":") + theSec
        document.forms[0].timerDisplay.value = theTime
        if (running) {
            timerID = setTimeout("showCountDown()",1000)
        }
    }
}

function stopTimer() {
    clearTimeout(timerID)
    running = false
    document.forms[0].timerDisplay.value = "0:00"
}

 
Возвращаемое значение
None.
 
Параметры
timeoutID Целое число - возвращаемое значение метода setTimeout( )
close( ) NN 2   IE 3   DOM n/a

Закрывает текущее окно. Navigator не позволяет основному окну быть закрытым из подокна без явного разрешения пользователя

 
Возвращаемое значение
None.
 
Параметры
None.
confirm( ) NN 2   IE 3   DOM n/a

confirm(message)

Отображает диалоговое окно с сообщением и двумя кнопками. Одна кнопка указывает на операцию Cancel; другая кнопка указывает на одобрение пользователя (OK или Yes). Текст кнопок - неизменяемый. Сообщение должно задать вопрос, к которому любая кнопка была бы логическим ответом. Щелчок кнопки Cancel возвращает значение false; щелчок кнопки OK возвращает значение true.

Поскольку этот метод возвращает Булево значение, Вы можете использовать этот метод внутри выражения условия:

if (confirm("Reset the entire form?")) { document.forms[0].reset( ) }
 
Возвращаемое значение
Булево значение: true | false.
 
Параметры
message Любая строка, обычно в форме вопроса.
createPopup( ) NN 2   IE 3   DOM n/a
Всплывающее окно в IE - прямоугольная область без элементов управления, появляющаяся поверх текущего окна. Содержимое такого окна полностью находится под управлением сценария. Это относится также к размеру и расположению окна. Генерирование такого объекта методом createPopup() лишь создаёт его в памяти броузера, не отображая на экране. Возвращаемая ссылка может быть использована для отображения, позиционирования и заполнения содержимым этого объекта.
 
Возвращаемое значение
Ссылка на объект popup
 
Параметры
Нет
disableExternalCapture( ), enableExternalCapture( ) NN 4   IE n/a  DOM n/a

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

 
Возвращаемое значение
None.
 
Параметры
None.
execScript( ) NN n/a  IE 4   DOM n/a

execScript(expressionList [, language])

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

window.execScript("var x = 3; alert(x * 3)")

Заданный по умолчанию язык сценария - JavaScript. Если Вы должны видеть результаты выполнения сценария, обеспечьте показ конечных данных в выражениях сценария. Сам метод execScript () не возвращает никакого значения.

 
Возвращаемое значение
None.
 
Параметры
expressionList Строковое значение, отражающее выражения сценария (через точку с запятой)
language Строковое значение языка сценариев: JavaScript | JScript | VBS | VBScript.
find( ) NN 4   IE n/a  DOM n/a

find(searchString [, matchCase[, searchUpward]])

Ищет в основном тексте документа строку и выбирает первую строку соответствия. Вы можете определить, должен ли поиск быть чувствительным к регистру или быть направленным вверх. С найденным выбранным текстом, Вы можете использовать метод document.getSelection(), чтобы захватить копию найденного текста. Вы , однако, не имеете почти динамических атрибутов содержания, предоставляемых в Internet Explorer 4 объектом TextRange (для Win32).

 
Возвращаемое значение
Булево значение:true, если соответствие было найдено; false, если нет.
 
Параметры
searchString Строка для поиска
matchCase Булево значение: true, чтобы искать только точное соответствие с учетом регистра; false (значение по умолчанию), чтобы использовать поиск без учета регистра.
searchUpward Булево значение: true, чтобы искать вверх от текущего выбора; false (значение по умолчанию), чтобы искать вперед от текущей позиции выбора.
focus( ) NN 3   IE 4   DOM n/a

Переносит окно вперёд всех окон браузера и обрабатывает событие onFocus (в IE). Если другое окно в то время имело фокус, оно получает событие onBlur

 
Возвращаемое значение
None.
 
Параметры
None.
forward( ) NN 4   IE n/a  DOM n/a

Переносит на один шаг вперед в хронологии окна или фрейма.
 
Возвращаемое значение
None.
 
Параметры
None.
GetAttention( ) NN 6

Хоть метод предназначен для использования программистами тем пользовательского интерфейса NN6, а не разработчиками сценариев, объектная модель документа делает его доступным и для последних. Целью объекта является привлечь внимание пользователя, когда броузер не является приложением переднего плана на рабочем столе. Каждая операционная система по-своему сигнализирует об этом.
 
Возвращаемое значение
None.
 
Параметры
None.
handleEvent( ) NN 4   IE n/a  DOM n/a

handleEvent(event)

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

 
Возвращаемое значение
None.
 
Параметры
event Объекты событий Navigator 4
home( ) NN 4   IE n/a  DOM n/a

Перемещается к URL, обозначенному как домашняя страница для браузера.

 
Возвращаемое значение
None.
 
Параметры
None.
moveBy( ) NN 4   IE n/a  DOM n/a

moveBy(deltaX, deltaY)

Удобный метод, который изменяет местоположение окна на указанные пикселы по обеим осям. Чтобы изменять только по одной оси, установите другое значение, на нуль. Положительные значения для deltaX перемещают окно направо; отрицательные значения налево. Положительные значения для deltaY перемещают окно вниз; отрицательные значения вверх.

 
Возвращаемое значение
None.
 
Параметры
deltaX Положительное или отрицательное значение в пикселах для горизонтали
deltaY Положительное или отрицательное значение в пикселах для вертикали
moveTo( ) NN 4   IE n/a  DOM n/a

moveTo(x, y)

Удобный метод, который изменяет местоположение текущего окна к определенной точке координат. Метод moveTo() использует координатную систему экрана

 
Возвращаемое значение
None.
 
Параметры
x Положительное или отрицательное значение в пикселах относительно вершины экрана.
y Положительное или отрицательное значение в пикселах относительно левой стороны экрана.
navigate( ) NN n/a  IE 3   DOM n/a

navigate(URL)

Загружает новый документ в окно или фрейм. Это специфический для IE путь назначения значений свойству window.location.href

 
Возвращаемое значение
None.
 
Параметры
URL Полный или относительный URL как строка.
open( ) NN 2   IE 3   DOM n/a

open(URL, windowName[, windowFeatures])

Открывает новое окно (без закрытия первоначального). Вы можете определить URL, который загрузится в это окно или оставить тот параметр пустым, чтобы позволить инструкции сценария document.write() писать в то новое окно. Параметр windowName позволяет Вам назначить имя, которое может использоваться атрибутами TARGET. Это имя не должно использоваться в ссылках сценария так же, как и имена фреймов. Вместо этого ссылка сценария на подокно должна быть ссылкой к объекту window, возвращенному методом window.open() . Поэтому, если ваши сценарии должны связаться с окном, открытый этим способом, лучшее сохранить возвращенное значение как глобальную переменную так, чтобы будущие инструкции могли это использовать .

Потенциальная проблема с подокнами состоит в том, что они могут быть спрятаны под основным окном, если пользователь щёлкает на основном окне (или сценарий даёт ему фокус). Любой сценарий, который открывает подокно, должен также включить для подокна метод focus() (в Navigator >= 3, и в IE >= 4 ). Последующие генерации метода window.open(), чей параметр windowName тот же самый, как и более ранний запрос, автоматически адресуют содержание в предварительно открытое окно, даже если оно ниже основного окна.

Дополнительный третий параметр дает Вам контроль над различными физическими атрибутами подокна. параметр windowFeatures - отдельная строка, состоящая из списка с разделителями-запятыми (без пробелов) между пунктами)пар attribute/value:

newWindow = window.open("someDoc.html","subWind", "statusbar,menubar,HEIGHT=400,WIDTH=300) newWindow.focus( )

Если для установки некоторых параметров в NN требуется подписанный (защищённый) сценарий, то их установку следует выполнять, установив сценарию дополнительные привилегии:

function supesSmallWindow() {
    netscape.security.PrivilegeManager.enablePrivilege("UniversalBrowserWrite");
    var newWindow = window.open("","","HEIGHT=20,WIDTH=20,AlwaysRaised");
    netscape.security.PrivilegeManager.disablePrivilege("UniversalBrowserWrite");
    }

 
Возвращаемое значение
Ссылка на объект Window.
 
Параметры
URL Полный или относительный URL как строка. Если пустая строка, никакого документа в окно не загружается
windowName Идентификатор для окна, которое нужно использовать. Оно отличается от атрибута TITLE документа, который загружается в окно.
windowFeatures Строка особенностей нового окна с разделителями-запятыми. Не помещайте пробелов после разделителей-запятых. Список возможных особенностей длинен, но множество их определено Navigator 4 как требующими подписанных сценариев, потому что они - потенциально секретны и причиняют беспокойство ничего не подозревающим пользователям. Особенности перечислены далее. Просто включите ее название без учета регистра в разделенном запятыми списке. Только атрибуты, определяющие измерения требуют, чтобы были назначены значения.
Атрибут NN IE Описание
alwaysLowered 4 - Всегда позади всех окон браузера. Требует подписанных сценариев.
alwaysRaised 4 - Всегда перед всеми окнами браузера. Требует подписанных сценариев.
channelMode 4 - Режим с переключателем каналов (по умолчанию - no)
copyhistory 2 3 Сохраняет список хронологии старого окна.
dependent 4 - Подокно закрывается, если окно, которое открыло его, также закрывается.
directories 2 3 Отображает директивные кнопки.
height 2 3 Высота окна в пикселах.
hotkeys 4 - Отключает горячую клавишу меню (кроме Quit из и Security Info).
innerHeight 4 - Высота области содержания. Подписанный сценарий требуется для очень маленьких размеров.
innerWidth 4 - Ширина области содержания. Подписанный сценарий требуется для очень маленьких размеров.
left - 4 Смещение левого края окна от левого края экрана.
location 2 3 Отображение строки ввода URL.
menubar 2 3 Показывать строку меню (строка меню всегда видима на Mac).
outerHeight 4 - Полная высота окна. Подписанный сценарий требуется для очень маленьких размеров.
outerWidth 4 - Полная ширина окна. Подписанный сценарий требуется для очень маленьких размеров.
resizable 2 3 Позволить изменять размеры окна (всегда позволяемо на Mac).
screenX 4 - Смещение левого края окна от левого края экрана. Подписанный сценарий требуется, чтобы переместить окно за экран.
screenY 4 - Смещение верхнего края окна от верхнего края экрана. Подписанный сценарий требуется, чтобы переместить окно за экран.
scrollbars 2 3 Показывать полосы прокрутки, если документ слишком большой.
status 2 3 Показывать строку состояния
titlebar 4 - Отображать titlebar. Требуется подписанный сценарий.
title 5 - Заголовок
toolbar 2 3 Показывать панель инструментов (с Back, Forward и другими кнопками).
top - 4 Смещение верхнего края окна от верхнего края экрана.
width 2 3 Ширина окна в пикселах.
z-lock 4 - Новое окно установлено ниже окон браузера. Требуется подписанный сценарий.
print( ) NN 4  IE 5.0  DOM n/a

Начинает процесс печати окна или фрейма. Пользователь все еще должен подтверждать диалоговое окно печати, чтобы послать документ принтеру. Этот метод такой же, как щелчок кнопки Print или выбора Print в меню File.

В IE4 хоть и недоступен метод window.print(), но запрограммировать печать из сценария можно с помощью встроенного объекта броузера. Для использования этого объекта ActiveX следует использовать следующий код:

<OBJECT ID="IEControl" WIDTH=0 HEIGHT=0 CLASSID="clsid:8856F961-340A-11D0-A96B-00C04FD705A2">
</OBJECT>

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

IEControl.ExecWB(6, 1)

Если второй параметр = 2, диалоговое окно печати не выводится. Если пользователь отменяет печать, возникает ошибка, которую следует перехватить.

 
Возвращаемое значение
None.
 
Параметры
None.
prompt( ) NN 2   IE 3   DOM n/a

prompt(message, defaultReply)

Отображает диалоговое окно с сообщением и двумя кнопками. Сообщение должно побудить пользователя выбрать определенный вид ответа. Одна кнопка указывает на операцию Cancel; другая кнопка указывает на одобрение пользователем текста, введенного в поле (OK или Yes). Текст кнопок неизменяем. Щелчок на кнопку Cancel возвращает значение 0; щелчок кнопки OK возвращает строку, которая находится в текстовом поле элемента (включая возможность пустой строки).

 
Возвращаемое значение
При щелчке кнопки OK - строка текстового поля элемента; при щелчке Cancel 0.
 
Параметры
message Любая строка
defaultReply Любая строка, которая предполагает ответ. Всегда снабжайите значением, даже если пустая строка.
releaseEvents( ) NN 4   IE n/a  DOM n/a

releaseEvents(eventTypeList)

Противоположность window.captureEvents(), этот метод выключает события на уровне окна для одно или более определенное событие, указанное как параметр.

 
Возвращаемое значение
None.
 
Параметры
eventTypeList Отделенный запятыми список типов событий с учетом регистра из доступных констант объекта Event: типа Event.CLICK или Event.MOUSEMOVE.
resizeBy( ) NN 4   IE n/a  DOM n/a

resizeBy(deltaX, deltaY)

Удобный метод, который изменяет размер окна на указанные пикселы по обеим осям. Чтобы изменять только по одной оси, установите другое значение, на нуль. Положительные значения для deltaX делают окно шире; отрицательные значения - уже. Положительные значения для deltaY делают окно выше; отрицательные значения - ниже

 
Возвращаемое значение
None.
 
Параметры
deltaX Положительное или отрицательное значение в пикселах горизонтального изменения размера
deltaY Положительное или отрицательное значение в пикселах вертикального изменения размера
resizeTo( ) NN 4   IE n/a  DOM n/a

resizeTo(x, y)

Удобный метод, который корректирует высоту и ширину окна к определенным размерам в пикселах. Верхние и левые грани окна остаются постоянными, в то время как нижние и правые грани двигаются

 
Возвращаемое значение
None.
 
Параметры
x Ширина окна в пикселах
y Высота окна в пикселах .
routeEvent( ) NN 4   IE n/a  DOM n/a

routeEvent(event)

Используется внутри функции обработчика события. Этот метод указывает Navigatorу чтобы позволять событию проходить к его целевому объекту.

 
Возвращаемое значение
None.
 
Параметры
event Объекты событий Navigator 4
scroll( ) NN 3   IE 4   DOM n/a

scroll(x, y)

Прокручивает документ внутри текущего окна или фрейма. Чтобы возвратить документ к его непрокрученной позиции, установите оба параметра на нуль.

 
Возвращаемое значение
None.
 
Параметры
x Горизонтальная мера прокрутки в пределах окна.
y Вертикальная мера прокрутки в пределах окна.
scrollBy( ) NN 4   IE 4   DOM n/a

scrollBy(deltaX, deltaY)

Прокручивает документ в окне на указанные пикселы по обеим осям. Чтобы корректировать по только одной оси, установите другое значение нулём. Положительные значения для deltaX прокручивают документ вверх (так что пользователь видит содержание нижней части документа); отрицательные значения прокручивают документ вниз. Положительные значения для deltaY прокручивают документ влево (так что пользователь видит содержание справа в документе); отрицательные значения прокручивают документ вправо. Прокрутка не продолжается после нулевых координатных точек (кроме Navigator 4 для Macintosh).

 
Возвращаемое значение
None.
 
Параметры
deltaX Горизонтальная мера прокрутки в пределах окна.
deltaY Горизонтальная мера прокрутки в пределах окна.
scrollTo( ) NN 4   IE n/a  DOM n/a

scrollTo(x, y)

Прокручивает документ в окне к определенной позиции.
 
Возвращаемое значение
None.
 
Параметры
x Горизонтальная позиция в пикселах
y Вертикальная позиция в пикселах
setCursor( ) NN 6

scrollTo("тип_указателя")

Этот метод в NN6 представляет собой альтернативу атрибуту cursor в CSS. Он изменяет внешний вид курсора.
 
Возвращаемое значение
None.
 
Параметры
тип_указателя

Строка с типом указателя. поддерживаются следующие типы:

alias
context-menu
count-up
default
grabbing
n-resize
pointer
spinning
w-resize		 auto
copy
count-up-down
e-resize
help
ne-resize
s-resize
sw-resize
wait		 cell
count-down
crosshair
grab
move
nw-resize
se-resize
text
setInterval( ) NN 4   IE 4   DOM n/a

setInterval(expression, msecs[, args | language])

Запускает таймер, который непрерывно вызывает выражение каждые msecs секунд. Другие сценарии могут работать в интервале между запросами к выражению. Этот метод полезен для последовательностей анимации, которые должны обновляться с определённой скоростью. Выражение может быть функцией, которая перемещает элемент на установленное расстояние в пикселах по одной оси. Функция будет вызываться в интервале, установленном параметром msecs. Этот метод возвращает ID, который должен быть сохранен как глобальная переменная и быть доступным как параметр для метода clearInterval(), чтобы остановить таймер выполнения цикла.

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

 
Возвращаемое значение
Целое число, действующее как идентификатор.
 
Параметры
expression Любое выражение сценария как строка, но, обычно, функция. Имя функции с круглыми скобками помещается внутри строки параметра в кавычках.
msecs Время в миллисекундах между повторениями выражения.
args Дополнительный список параметров с разделителями-запятыми, которые нужно пропустить в функцию, используемую как параметр выражения.
language Дополнительное определение языка сценариев выражения (значение по умолчанию - JavaScript).
setTimeout( ) NN 2   IE 3   DOM n/a

setTimeout(expression, msecs[, args | language])

Запускает одноразовый таймер, который вызывает выражение после задержки msecs. Другие сценарии могут работать в то время, когда браузер ждет вызова выражение. Этот метод возвращает ID, который должен быть сохранен как глобальная переменная и быть доступным как параметр для метода clearTimeout(), чтобы остановить таймер прежде, чем время истечет и вызовет выражение.

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

Метод setTimeout() может вести себя в некоторых конструкцияхподобно методу setInterval(). Если Вы размещаете setTimeout() метод как последнюю инструкцию функции и направляете его вызвать ту же самую функцию, Вы можете создать цикл с установленной задержкой времени. Это необходимо для старых версий браузеров

 
Возвращаемое значение
Целое число, действующее как идентификатор.
 
Параметры
expression Любое выражение сценария как строка, но, обычно, функция. Имя функции с круглыми скобками помещается внутри строки параметра в кавычках.
msecs Время в миллисекундах между повторениями выражения.
args Дополнительный список параметров с разделителями-запятыми, которые нужно пропустить в функцию, используемую как параметр выражения.
language Дополнительное определение языка сценариев выражения (значение по умолчанию - JavaScript).
showHelp( ) NN n/a  IE 4   DOM n/a

showHelp(URL)

Отображает окно WinHelp с документом, указанным как параметр URL. Этот метод работает только в версии Windows Internet Explorer

 
Возвращаемое значение
None.
 
Параметры
URL Полный или относительный URL как строка.
showModalDialog( ) NN n/a  IE 4   DOM n/a

showModalDialog(URL[, arguments[, features]])

Отображает специальное окно, которое остается поверх всех окнон браузера, пока пользователь явно не закрывает окно диалога. Этот тип окна отличается от окон браузера, сгенерированных методом window.open(). Модальный диалог не имеет никаких отношений с родительским окном. Все значения, необходимые для отображающегося содержания должны быть в документе HTML, который загружается в окно, или проходить как параметр. Модальный диалог может иметь сценарий только тогда, когда устанавливают его свойство returnValue, которое становится значением, возвращаемым первоначальной инструкции сценария, которая открыла модальное диалоговое окно (как возвращенное значение метода showModalDialog()).

Вы можете передавать параметры модальному диалогу. Для единственного значения, сделайте строку. Для множественных значений Вы можете создать строку с уникальным разделителем между значениями, или создать массив и определять массив как второй параметр для метода showModalDialog(). Сценарий в документе, загруженном в модальный диалог может исследовать свойство window.dialogArguments и анализировать его параметры тогда, когда необходимо для сценария. См. свойство dialogArguments для примера.

Третий дополнительный параметр позволяет Вам устанавливать физические характеристики окна диалога. Эти характеристики определены в синтаксисом CSS. Измерения для dialogWidth, dialogHeight, dialogLeft, и dialogTop должны быть определены в пикселах. Пример запроса к модальному диалогу:

var answer = window.showModalDialog("subDoc.html",argsVariable, "dialogWidth:300px; dialogHeight:200px; center:yes")

Ни одна из третьих характеристик параметра не признана версией Macintosh Internet Explorer 4, который создает полноразмерный модальный диалог.

 
Возвращаемое значение
Значение (если есть), назначенное на свойство window.returnValue в документе, загруженном в модальное диалоговое окно.
 
Параметры
URL Полный или относительный URL как строка.
arguments Данные как число, строка, или массив, которые нужно пропустить к сценариям в документе, загруженном в модальный диалог.
features Строка разграниченных точкой с запятой атрибутов стиля и их значений для установки физических характеристик модального диалога. Доступные атрибуты: center, dialogHeight, dialogLeft, dialogTop, dialogWidth, help, resizable, status. Значения для атрибута: yes | no | 1 | 0.
sizeToContent( ) NN 6

Метод sizeToContent() в NN6 оказывается полезным при проверке размера окна на оптимальное отображение его содержимого. Однако при его использовании следует проявлять осторожность. Выполнение этого метода приводит к изменению размера окна таким образом, чтобы всё его содержимое было максимально видимым на экране.
 
Возвращаемое значение
None.
 
Параметры
None.
stop( ) NN n/a  IE 4   DOM n/a

Останавливает загрузку внешних данных любого вида. Этот метод равносилен щелчку кнопки браузера Stop.
 
Возвращаемое значение
None.
 
Параметры
None.

Динамические коллекции:

frames[ ] NN 2   IE 3   DOM n/a

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

 
Синтаксис

parent.frames(index).objectPropertyOrMethod top.frames(index).objectPropertyOrMethod

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


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