На главную страницу
Форум

Статья :: window

Оглавление | Назад | Вперёд | Индекс

window

Окно или фрэйм в браузере. Это объект верхнего уровня для каждой группы объектов document, Location и History.

Клиентский объект

Реализован в

JavaScript 1.0

JavaScript 1.1: добавлены свойства closed, history и opener; добавлены методы blur, focus и scroll; добавлены обработчики onBlur, onError и onFocus.

JavaScript 1.2: добавлены свойства crypto, innerHeight, innerWidth, locationbar, menubar, offscreenBuffering, outerHeight, outerWidth, pageXOffset, pageYOffset, personalbar, screenX, screenY, scrollbars, statusbar и toolbar; добавлены методы atob, back, btoa, captureEvents, clearInterval, crypto.random, crypto.signText, disableExternalCapture, enableExternalCapture, find, forward, handleEvent, home, moveBy, moveTo, releaseEvents, resizeBy, resizeTo, routeEvent, scrollBy, scrollTo, setHotKeys, setInterval, setResizable, setZOptions и stop; не рекомендуется метод scroll.

Создание

Машина выполнения JavaScript создаёт объект window для каждого тэга BODY или FRAMESET. Она также создаёт объект window для представления каждого фрэйма, определённого тэгом FRAME. Кроме того, Вы можете создать другие окна, вызывая метод window.open. Детали определения окна см. в разделе open.

Обработчики событий

В JavaScript 1.1, на некоторых платформах, размещение обработчика onBlur или onFocus в тэге FRAMESET не даёт эффекта.

Описание

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

Для окна верхнего уровня свойства parent и top являются ссылками на само это окно. Для фрэйма - top ссылается на самое верхнее окно браузера, а parent ссылается на родительское окно текущего окна.
Для окна верхнего уровня установка свойства defaultStatus или status устанавливает текст status-строки браузера. Для фрэйма установка этих свойств устанавливает только текст статусной строки, когда курсор находится над фрэймом.
Метод close не используется для окон, которые являются фрэймами.
Для создания обработчика onBlur или onFocus для фрэйма Вы обязаны установить свойство onblur или onfocus и специфицировать его в нижнем регистре (нельзя специфицировать его в HTML).
Если тэг FRAME содержит атрибуты SRC и NAME, Вы можете обратиться к этому фрэйму из фрэйма-родственника через parent.frameName или parent.frames[index]. Например, если четвёртый фрэйм из набора фрэймов имеет атрибут NAME="homeFrame", фрэймы-родственники могут обратиться к этому фрэйму parent.homeFrame или parent.frames[3].

Для всех окон свойства self и window объекта window являются синонимами текущего окна, и Вы можете по выбору использовать их для обращения к текущему окну. Например, можно закрыть текущее окно, вызвав метод close в window или в self. Вы можете использовать эти свойства, чтобы сделать Ваш код более читабельным или чтобы отличить ссылку self.status от status. См. далее примеры для свойств и методов.

Поскольку принимается существование текущего окна, Вы не должны обращаться к имени окна при вызове его методов и присвоении значений свойств. Например, status="Jump to a new location" это верное присвоение свойства, а close() это верный вызов метода.

Однако, если Вы открываете или закрываете окно обработчиком события, Вы обязаны специфицировать window.open() или window.close() вместо open() или close(). Из-за видимости static-объектов в JavaScript, вызов close() без указания имени объекта эквивалентен document.close().

По некоторым причинам, если Вы обращаетесь к объекту location в обработчике события, Вы обязаны специфицировать window.location вместо location. Вызов location без специфицирования имени объекта эквивалентен document.location, что является синонимом document.URL.

Вы можете обратиться к объектам Frame окна в коде через использование массива frames. В окне с тэгом FRAMESET массив frames содержит вхождение для каждого фрэйма.

Окну нужны обработчики событий, пока HTML, который содержит тэг BODY или FRAMESET, не будет загружен в него.

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

Свойство	Описание
`closed`	Специфицирует, закрыто ли окно.
`crypto`	Объект, дающий доступ к возможностям шифрования Navigator'а.
`defaultStatus`	Отражает сообщение по умолчанию, выводимое в статусной строке.
`document`	Содержит информацию о текущем документе и предоставляет методы для отображения вывода HTML пользователю.
`frames`	Массив, отражающий все фрэймы окна.
`history`	Содержит информацию о URL, которые клиент посетил в данном окне.
`innerHeight`	Специфицирует вертикальные размеры в пикселах области содержимого окна.
`innerWidth`	Специфицирует горизонтальные размеры в пикселах области содержимого окна.
`length`	Количество фрэймов в окне.
`location`	Содержит информацию о текущем URL.
`locationbar`	Адресная строка окна браузера.
`menubar`	Строка меню окна браузера.
`name`	Уникальное имя, используемое для обращения к данному окну.
`offscreenBuffering`	Специфицирует, выполняются ли обновления окна во внеоконном буфере.
`opener`	Специфицирует имя окна вызывающего документа, если окно открывается методом `open.`
`outerHeight`	Специфицирует вертикальные размеры в пикселах внешней границы окна.
`outerWidth`	Специфицирует горизонтальные размеры в пикселах внешней границы окна.
`pageXOffset`	Предоставляет текущую x-позицию в пикселах просматриваемой страницы окна.
`pageYOffset`	Предоставляет текущую у-позицию в пикселах просматриваемой страницы окна.
`parent`	Синоним окна или фрэйма, чей frameset содержит текущий фрэйм.
`personalbar`	Представляет personal bar окна браузера (называемый также строкой директорий).
`screenX`	Специфицирует x-координату левого края окна.
`screenY`	Специфицирует у-координату верхнего края окна.
`scrollbars`	Полосы прокрутки окна браузера.
`self`	Синоним текущего окна.
`status`	Специфицирует приоритетное сообщение статусной строки окна.
`statusbar`	Статусная строка окна браузера.
`toolbar`	Строка утилит окна браузера.
`top`	Синоним наивысшего окна браузера.
`window`	Синоним текущего окна.

Методы. Резюме.

Метод	Описание
`alert`	Отображает диалоговое окно Alert с сообщением и кнопкой OK.
`atob`	Декодирует строку данных, кодированную с использованием кодировки base-64.
`back`	Отменяет последний шаг истории в любом фрэйме окна верхнего уровня.
`blur`	Убирает фокус со специфицированного объекта.
`btoa`	Создаёт строку с кодирование base-64.
`captureEvents`	Устанавливает захват окном или документом всех событий специфицированного типа.
`clearInterval`	Отменяет таймаут, установленный методом `setInterval`.
`clearTimeout`	Отменяет таймаут, установленный методом `setTimeout`.
`close`	Закрывает специфицированное окно.
`confirm`	Выводит диалог Confirm со специфицированным сообщением и кнопками OK и Cancel.
`crypto.random`	Возвращает псевдослучайную строку, длина которой равна специфицированному количеству байтов.
`crypto.signText`	Возвращает строку кодированных данных, которая представляет маркированный/помеченный объект.
`disableExternalCapture`	Отменяет захват внешних событий, установленный методом `enableExternalCapture`.
`enableExternalCapture`	Разрешает окну с фрэймами захватывать события в страницах, загружаемых с других серверов.
`find`	Находит специфицированную текстовую строку в содержимом специфицированного окна.
`focus`	Передаёт фокус специфицированному элементу.
`forward`	Загружает следующий URL из списка history.
`handleEvent`	Вызывает обработчик для специфицированного события.
`home`	Переводит браузер на URL, специфицированный в установках пользователя как домашняя страница.
`moveBy`	Перемещает окно на специфицированные величины.
`moveTo`	Перемещает верхний левый угол окна на специфицированные координаты экрана.
`open`	Открывает новое окно web-браузера.
`print`	Печатает содержимое текущего окна или фрэйма.
`prompt`	Выводит диалог Prompt с сообщением и полем для ввода.
`releaseEvents`	Устанавливает освобождение захваченных окном событий специфицированного типа, отправляя событие объектам далее по иерархии событий.
`resizeBy`	Изменяет размеры всего окна, перемещая нижний правый угол окна на специфицированные величины.
`resizeTo`	Изменяет размеры всего окна на специфицированные внешние высоту и ширину.
`routeEvent`	Передаёт захваченное событие по нормальной иерархии событий.
`scroll`	Прокручивает окно до специфицированной координаты.
`scrollBy`	Прокручивает область просмотра окна на специфицированную величину.
`scrollTo`	Прокручивает окно до специфицированной координаты, так что специфицированная точка становится левым верхним углом.
`setHotKeys`	Включает или отключает горячие клавиши окна, не имеющего меню.
`setInterval`	Вычисляет выражение или вызывает функцию всякий раз по истечении специфицированного количества миллисекунд.
`setResizable`	Специфицирует, может ли пользователь изменять размеры окна.
`setTimeout`	Вычисляет выражение или вызывает функцию всякий раз по истечении специфицированного количества миллисекунд.
`setZOptions`	Специфицирует z-order стэкирования в окне.
`stop`	Останавливает загрузку.

Кроме того, этот объект наследует методы watch и unwatch из Object.

Примеры

Пример 1. Окна, открывающие другие окна. Здесь документ верхнего окна открывает второе окно window2 и определяет push-кнопки, которые открывают окно с сообщением, записывает в окно сообщения, закрывает его и закрывает window2. Обработчики onLoad и onUnload документа, загруженного в window2, выводят предупреждающие сообщения при открытии и закрытии окна.

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

<HTML>
<HEAD>
<TITLE>window object example: Window 1</TITLE>
</HEAD>
<BODY BGCOLOR="antiquewhite">
<SCRIPT>
window2=open("win2.html","secondWindow",
   "scrollbars=yes,width=250, height=400")
document.writeln("<B>The first window has no name: " 
   + window.name + "</B>")
document.writeln("<BR><B>The second window is named: " 
   + window2.name + "</B>")
</SCRIPT>
<FORM NAME="form1">
<P><INPUT TYPE="button" VALUE="Open a message window"
   onClick = "window3=window.open('','messageWindow',
   'scrollbars=yes,width=175, height=300')">
<P><INPUT TYPE="button" VALUE="Write to the message window"
   onClick="window3.document.writeln('Hey there'); 
   window3.document.close()">
<P><INPUT TYPE="button" VALUE="Close the message window"
   onClick="window3.close()">
<P><INPUT TYPE="button" VALUE="Close window2"
   onClick="window2.close()">
</FORM>
</BODY>
</HTML>

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

<HTML>
<HEAD>
<TITLE>window object example: Window 2</TITLE>
</HEAD>
<BODY BGCOLOR="oldlace"
   onLoad="alert('Message from ' + window.name + ': Hello, World.')"
   onUnload="alert('Message from ' + window.name + ': I\'m closing')">
<B>Some numbers</B>
<UL><LI>one
<LI>two
<LI>three
<LI>four</UL>
</BODY>
</HTML>

Пример 2. Создание фрэймов. Создаются два окна, каждое из 4 фрэймов. В первом окне первый фрэйм содержит кнопки, которые изменяют цвет фона фрэймов в обоих окнах.

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

<HTML>
<HEAD>
<TITLE>Frames and Framesets: Window 1</TITLE>
</HEAD>
<FRAMESET ROWS="50%,50%" COLS="40%,60%" 
   onLoad="alert('Hello, World.')">
<FRAME SRC=framcon1.html NAME="frame1">
<FRAME SRC=framcon2.html NAME="frame2">
<FRAME SRC=framcon2.html NAME="frame3">
<FRAME SRC=framcon2.html NAME="frame4">
</FRAMESET>
</HTML>

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

<HTML>
<HEAD>
<TITLE>Frames and Framesets: Window 2</TITLE>
</HEAD>
<FRAMESET ROWS="50%,50%" COLS="40%,60%">
<FRAME SRC=framcon2.html NAME="frame1">
<FRAME SRC=framcon2.html NAME="frame2">
<FRAME SRC=framcon2.html NAME="frame3">
<FRAME SRC=framcon2.html NAME="frame4">
</FRAMESET>
</HTML>

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

<HTML>
<BODY>
<A NAME="frame1"><H1>Frame1</H1></A>
<P><A HREF="framcon3.htm" target=frame2>Click here</A>
   to load a different file into frame 2.
<SCRIPT>
window2=open("framset2.htm","secondFrameset")
</SCRIPT>
<FORM>
<P><INPUT TYPE="button" VALUE="Change frame2 to teal"
   onClick="parent.frame2.document.bgColor='teal'">
<P><INPUT TYPE="button" VALUE="Change frame3 to slateblue"
   onClick="parent.frames[2].document.bgColor='slateblue'">
<P><INPUT TYPE="button" VALUE="Change frame4 to darkturquoise"
   onClick="top.frames[3].document.bgColor='darkturquoise'">

<P><INPUT TYPE="button" VALUE="window2.frame2 to violet"
   onClick="window2.frame2.document.bgColor='violet'">
<P><INPUT TYPE="button" VALUE="window2.frame3 to fuchsia"
   onClick="window2.frames[2].document.bgColor='fuchsia'">
<P><INPUT TYPE="button" VALUE="window2.frame4 to deeppink"
   onClick="window2.frames[3].document.bgColor='deeppink'">
</FORM>
</BODY>
</HTML>

framcon2.html, где определяется содержимое остальных фрэймов, содержит следующий код:

<HTML>
<BODY>
<P>This is a frame.
</BODY>
</HTML>

framcon3.html, на который ссылается объект Link в framcon1.html, содержит следующий код:

<HTML>
<BODY>
<P>This is a frame. What do you think?
</BODY>
</HTML>

См. также

document, Frame

alert

Выводит диалог Alert с сообщением и кнопкой OK.

Метод из	`window`
Реализован в	JavaScript 1.0

Синтаксис

alert(message)

Параметр

message

Строка.

Описание

Диалог alert выглядит так:

Используйте метод alert для отображения сообщения, которое не требует принятия пользователем решения. Аргумент message специфицирует текст сообщения.

Вы не можете специфицировать заголовок окна alert, но можете использовать метод open для создания Вашего собственного диалога alert. См. open.

Пример

Функция testValue проверяет имя введённое пользователем в Text-объект формы, чтобы гарантировать, что оно имеет не более 8 символов. Этот пример использует метод alert для предупреждения пользователя.

function testValue(textElement) {
   if (textElement.length > 8) {
      alert("Please enter a name that is 8 characters or less")
   }
}

Можно вызвать функцию testValue в обработчике onBlur объекта Text, как здесь:

Name: <INPUT TYPE="text" NAME="userName"
   onBlur="testValue(userName.value)">

См. также

window.confirm, window.prompt

atob

Декодирует строку данных, которая была кодировано по методу base-64.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

atob(encodedData)

Параметр

encodedData

Строка данных, созданная методом кодирования base-64.

Описание

Этот метод декодирует строку данных, которая была кодирована с использованием base-64. Например, метод window.btoa принимает бинарную строку в качестве параметра и возвращает строку, кодированную в base-64.

Вы можете использовать метод window.btoa для кодирования и передачи данных, а затем воспользоваться методом window.atob для декодирования. Например, Вы можете закодировать, передать и декодировать символы, такие как ASCII-значения с 0 по 31.

Пример

Кодируется и декодируется строка "Hello, world".

// кодируется строка

encodedData = btoa("Hello, world");

// строка декодируется

decodedData = atob(encodedData);

См. также

window.btoa

back

Отменяет последний шаг истории в любом фрэйме окна верхнего уровня; эквивалентно нажатию кнопки Back в браузере.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

back()

Параметры

Отсутствуют.

Описание

Вызов метода back эквивалентен нажатию кнопки Back в браузере. То есть back отменяет последний шаг в любом месте окна верхнего уровня, был ли он сделан в этом же или в другом фрэйме дерева фрэймов, загруженного из окна верхнего уровня. По контрасту, метод back объекта history переводит текущую историю окна или фрэйма на один шаг назад.

Например, рассмотрим следующий сценарий. Находясь во фрэйме Frame A, Вы нажимаете кнопку Forward для изменения содержимого фрэйма Frame A. Затем Вы переходите во Frame B и нажимаете кнопку Forward для изменения содержимого фрэйма Frame B. Если Вы затем перейдёте обратно во Frame A и вызовете FrameA.back(), содержимое фрэйма Frame B изменится (нажатие кнопки Back даст тот же эффект).

Если Вы хотите перейти именно во фрэйме Frame A, используйте FrameA.history.back().

Пример

Следующие специальные кнопки выполняют ту же операцию, что и кнопка Back браузера:

<P><INPUT TYPE="button" VALUE="< Go Back"
   onClick="history.back()">
<P><INPUT TYPE="button" VALUE="> Go Back"
   onClick="myWindow.back()">

См. также

window.forward, History.back

blur

Убирает фокус со специфицированного объекта.

Метод из	`window`
Реализован в	JavaScript 1.0

Синтаксис

blur()

Параметры

Отсутствуют.

Описание

Метод blur используется для удаления фокуса со специфицированного окна или фрэйма. Удаление фокуса из окна переводит окно на задний план в большинстве оконных операционных систем.

См. также

window.focus

btoa

Создаёт ASCII-строку, кодированную по системе base-64, из строковых или двоичных данных.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

btoa(stringToEncode)

Параметр

stringToEncode

Произвольная строка.

Описание

Этот метод принимает двоичную строку ASCII в качестве параметра и возвращает другую ASCII-строку, кодированную с использованием base-64.

Вы можете использовать этот метод для кодирования данных, которые могут иначе вызвать коммуникационные проблемы, передать их, а затем использовать метод window.atob для декодирования данных. Например, Вы можете кодировать такие символы, как значения ASCII от 0 до 31.

Примеры

См. window.atob.

См. также

window.atob

captureEvents

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

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

captureEvents(eventType1 [|eventTypeN...])

Параметр

eventType1... eventTypeN

Тип захватываемого события. Допустимые типы событий рассматриваются в Главе 3 "Обработчики Событий".

Безопасность

Если окно с фрэймами должно захватывать события на страницах, загружаемых с разных серверов, Вы должны использовать captureEvents в маркированном скрипте и предварительно вызвать enableExternalCapture. Вы обязаны иметь привилегию UniversalBrowserWrite. Дополнительно см. enableExternalCapture. О безопасности см. книгу Клиентский JavaScript. Руководство.

См. также

captureEvents работает в паре с releaseEvents, routeEvent и handleEvent. Дополнительно см. Клиентский JavaScript. Руководство.

clearInterval

Отменяет таймаут, установленный методом setInterval.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

clearInterval(intervalID)

Параметр

intervalID

Установка таймаута, которая была возвращена предыдущим вызовом метода setInterval.

clearTimeout

Отменяет таймаут, установленный методом setTimeout.

Метод из	`window`
Реализован в	JavaScript 1.0

Синтаксис

clearTimeout(timeoutID)

Параметр

timeoutID

Установка таймаута, которая была возвращена предыдущим вызовом метода setTimeout.

Описание

См. setTimeout.

Примеры

См. setTimeout.

См. также

window.clearInterval, window.setTimeout

close

Закрывает специфицированное окно.

Метод из

window

Реализован в

JavaScript 1.0: закрывает любое окно.

JavaScript 1.1: закрывает только окна, открытые JavaScript.

JavaScript 1.2: должны использоваться маркированные скрипты для безусловного закрытия окна.

Синтаксис

close()

Параметры

Отсутствуют.

Безопасность

Для безусловного закрытия окна Вы должны иметь привилегию UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

Описание

Метод close закрывает специфицированное окно. Если Вы вызываете close без специфицирования windowReference, JavaScript закрывает текущее окно.

Метод close закрывает только окна, открытые JavaScript с использованием метода open. Если Вы попытаетесь закрыть любое другое окно, генерируется диалог confirm, который предлагает подтвердить закрытие окна. Это сделано для предотвращения "mail bombs/почтовых бомб", содержащих self.close(). Однако, если окно содержит только один документ (текущий) в истории текущей сессии, метод close выполняется без подтверждения. Особый случай - с окнами one-off, которые должны открыть другие окна и только затем закрыться.

В обработчиках событий Вы обязаны специфицировать window.close() вместо close(). Учитывая область видимости static-объектов в JavaScript, вызов close() без специфицирования имени объекта эквивалентен document.close().

Примеры

Пример 1. Любая из следующих строк закрывает текущее окно:

window.close()
self.close()
close()

Пример 2: Закрытие главного окна браузера.

top.opener.close()

Пример 3. Здесь закрывается окно messageWin:

messageWin.close()

Предполагается, что окно было открыто примерно в такой манере:

messageWin=window.open("")

См. также

window.closed, window.open

closed

Специфицирует, закрыто ли окно.

Свойство из	`window`
Только для чтения
Реализовано в	JavaScript 1.1

Описание

Свойство closed это Булево значение, которое специфицирует, закрыто ли окно. Когда окно закрывается, объект window, представляющий его, продолжает существовать, и его свойство closed устанавливается в true.

Используйте метод closed для определения, открыто ли в данный момент окно, которое Вы ранее открыли и на которое Вы имеете ссылку (из return-значения метода window.open). Если окно закрыто, Вы не должны пытаться манипулировать им.

Примеры

Пример 1. Следующий код открывает окно win1, затем позже проверяет, было ли оно закрыто. Вызываемая функция зависит от того, закрыто ли окно win1.

win1=window.open('opener1.html','window1','width=300,height=300')
...
if (win1.closed)
   function1()
   else
   function2()

Пример 2. Определяется, закрыто ли окно, открывшее текущее окно, и вызывается соответствующая функция.

if (window.opener.closed)
   function1()
   else
   function2()

См. также

window.close, window.open

confirm

Отображает диалоговое окно Confirm со специфицированным сообщением и кнопками OK и Cancel.

Метод из	`window`
Реализован в	JavaScript 1.0

Синтаксис

confirm(message)

Параметр

message

Строка.

Описание

Диалог confirm выглядит так:

Используйте confirm для запроса у пользователя решения, которое требует OK/подтверждения или Cancel/отмены. Аргумент message специфицирует текст сообщения. Метод confirm возвращает true, если нажата кнопка OK, и false, если нажата Cancel.

Вы не можете специфицировать заголовок окна confirm, но можете использовать метод open для создания Вашего собственного диалога confirm. См. open.

Пример

Метод confirm в функции confirmCleanUp используется для подтверждения закрытия приложения. Если пользователь выбрал OK, специальная функция cleanUp закрывает приложение.

function confirmCleanUp() {
   if (confirm("Are you sure you want to quit this application?")) {
      cleanUp()
   }
}

Вы можете вызвать функцию confirmCleanUp в обработчике onClick кнопки, как показано в этом примере:

<INPUT TYPE="button" VALUE="Quit" onClick="confirmCleanUp()">

См. также

window.alert, window.prompt

crypto

Объект, дающий доступ к возможностям шифрования в Navigator'е.

Свойство из	`window`
Только для чтения
Реализовано в	JavaScript 1.2

Описание

Объект crypto доступен только как свойство объекта window; он предоставляет доступ к методам, которые поддерживают возможности шифровки в Navigator'е.

См. также

window.crypto.random, window.crypto.signText

crypto.random

Возвращает псевдослучайную строку, размер которой равен специфицированному количеству байтов.

Метод из	`window`
Static
Реализован в	JavaScript 1.2

Синтаксис

crypto.random(numberOfBytes)

Параметр

numberOfBytes

Количество байтов псевдослучайных данных, возвращаемых методом.

Описание

Этот метод генерирует произвольную строку данных, размер которой специфицируется параметром numberOfBytes.

Пример

Функция возвращает строку длиной 16 байт.

function getRandom() {
   return crypto.random(16)
}

См. также

Math.random

crypto.signText

Возвращает строку кодированных данных, которая представляет маркированный объект.

Метод из	`window`
Static
Реализован в	JavaScript 1.2

Синтаксис

crypto.signText
   (text, selectionStyle [, authority1 [, ... authorityN]])

Параметры

text

Строка, вычисляемая в текст, который пользователь должен промаркировать.

selectionStyle

Строка, вычисляемая в:

ask специфицирует, что диалоговое окно предоставит пользователю список доступных сертификатов.
auto специфицирует, что Navigator автоматически выбирает сертификат из диапазона authority1 до authorityN.

authority1... authorityN

Строки по выбору, вычисляемые в Certificate Authorities, принимаемые сервером с использованием маркированного текста.

Описание

Метод signText спрашивает пользователя о проверке строки text путём присоединения к ней цифровой подписи. Если параметр selectionStyle установлен в ask, signText выводит диалог, и пользователь обязан интерактивно выбрать сертификат для проверки текста. Если selectionStyle is установлен в auto, Navigator пытается автоматически выбрать сертификат.

Используйте метод signText для отправки кодированной подписи на сервер; сервер декодирует подпись и проверяет её. Если signText терпит неудачу, он возвращает один из следующих error-кодов:

error:noMatchingCert - пользовательский сертификат не соответствует ни одному из сертификатов, требуемых в диапазоне от authority1 до authorityN..
error:userCancel - пользователь отменил диалоговое окно подписи без отправки сертификата.
error:internalError - возникла внутренняя ошибка.

defaultStatus

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

Свойство из	`window`
Реализовано в	JavaScript 1.0

Безопасность

JavaScript 1.1. Это свойство разрушено/запорчено по умолчанию. О разрушении данных см. книгу Клиентский JavaScript. Руководство.

Описание

Сообщение defaultStatus появляется, если в статусной строке ничего больше нет. Не путайте свойство defaultStatus со свойством status. Свойство status отражает приоритетное или временной сообщение в статусной строке, такое как при возникновении события mouseOver при проведении указателя мыши над якорем.

Вы можете установить свойство defaultStatus в любое время. Вы обязаны возвращать true, если хотите устанавливать свойство defaultStatus в обработчиках onMouseOut или onMouseOver.

Пример

Функция statusSetter устанавливает свойства status и defaultStatus в обработчике onMouseOver:

function statusSetter() {
   window.defaultStatus = "Click the link for the Netscape home page"
   window.status = "Netscape home page"
}

<A HREF="http://home.netscape.com"
   onMouseOver = "statusSetter(); return true">Netscape</A>

Заметьте, что в это примере обработчик onMouseOver возвращает true. Вы обязаны возвращать true, если хотите устанавливать defaultStatus и status в обработчиках событий.

См. также

window.status

disableExternalCapture

Отменяет захват внешних событий, установленный методом enableExternalCapture.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

disableExternalCapture()

Параметры

Отсутствуют.

Описание

См. enableExternalCapture.

document

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

Свойство из	`window`
Реализовано в	JavaScript 1.0

Описание

Значением этого свойства является ассоциированный объект document окна.

enableExternalCapture

Позволяет окну с фрэймами захватывать события на страницах, загружаемых из других location (серверов).

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

enableExternalCapture()

Параметры

Отсутствуют.

Описание

Используйте этот метод в маркированном скрипте, запрашивающем привилегии UniversalBrowserWrite, и перед вызовом метода captureEvents.

Если Communicator видит дополнительные скрипты, которые ухудшают работу действующих принципалов контейнера, он отключает захват внешних событий. Дополнительные вызовы enableExternalCapture (после получения привилегии UniversalBrowserWrite при уменьшенном наборе принципалов) могут выполняться для возобновления захвата внешних событий.

Пример

Окно может захватывать все события Click, возникающие в его фрэймах.

<SCRIPT ARCHIVE="myArchive.jar" ID="2">
function captureClicks() {
   netscape.security.PrivilegeManager.enablePrivilege(
      "UniversalBrowserWrite"); 
   enableExternalCapture();
   captureEvents(Event.CLICK);
   ...
}
</SCRIPT>

См. также

window.disableExternalCapture, window.captureEvents

find

Находит специфицированную текстовую строку в содержимом специфицированного окна.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

find([string[, caseSensitive, backward]])

Параметры

string	Искомая текстовая строка.
caseSensitive	Булево значение. Если true, специфицирует поиск с учётом регистра символов. Если Вы предоставляете этот параметр, Вы обязаны также задать значение для `backward`.
backward	Булев. Если true, специфицирует поиск в обратном направлении (снизу вверх по документу). Если Вы предоставляете этот параметр, Вы обязаны также задать значение для `casesensitive`.

Возвращает

true, если строка найдена; иначе - false.

Описание

Когда string специфицирован, браузер выполняет поиск сверху вниз без учёта регистра символов. Если параметр string не специфицирован, метод выводит диалог Find, позволяющий пользователю ввести строку для поиска.

focus

Передаёт фокус специфицированному объекту.

Метод из	`window`
Реализован в	JavaScript 1.1

Синтаксис

focus()

Параметры

Отсутствуют.

Описание

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

В JavaScript 1.1, на некоторых платформах, метод focus передаёт фокус фрэйму, но этот фокус визуально не проявляется (например, рамка фрэйма не темнеет).

Примеры

Функция checkPassword подтверждает, что пользователь ввёл верный пароль. Если введён неправильный пароль, метод focus возвращает фокус объекту Password, а метод select выделяет его, чтобы пользователь мог повторно ввести пароль.

function checkPassword(userPass) {
   if (badPassword) {
      alert("Please enter your password again.")
      userPass.focus()
      userPass.select()
   }
}

Предполагается, что объект Password определён так:

<INPUT TYPE="password" NAME="userPass">

См. также

window.blur

forward

Переводит браузер к следующему URL в текущем списке history; эквивалентно нажатию кнопки Forward в браузере.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

history.forward()

forward()

Параметры

Отсутствуют.

Описание

Этот метод выполняет такое же действие, что нажатие кнопки Forward в браузере. Метод forward эквивалентен history.go(1).

При использовании с объектом Frame, forward работает так: во фрэйме Frame A вы нажимаете кнопку Back для изменения содержимого фрэйма Frame A. Затем переходите во фрэйм Frame B и нажимаете кнопку Back для изменения содержимого фрэйма Frame B. Если Вы перейдёте обратно в Frame A и вызовете FrameA.forward(), изменится содержимое фрэйма Frame B (нажатие кнопки Forward даст тот же эффект). Если Вы хотите перейти во фрэйме Frame A, используйте FrameA.history.forward().

Примеры

Следующая кнопка выполняет то же действие, что и кнопка Forward браузера:

<P><INPUT TYPE="button" VALUE="< Go Forth"
   onClick="history.forward()">
<P><INPUT TYPE="button" VALUE="> Go Forth"
   onClick="myWindow.forward()">

См. также

window.back

frames

Массив объектов, соответствующих дочерним фрэймам (созданных тэгами FRAME) в порядке расположения в исходном коде.

Свойство из	`window`
Только для чтения
Реализовано в	JavaScript 1.0

Вы можете обратиться к дочерним фрэймам окна, используя массив frames. Этот массив содержит вхождения для всех дочерних фрэймов (созданных тэгами FRAME) в окне, содержащем тэг FRAMESET; вхождения расположены в порядке исходного кода. Например, если окно содержит три фрэйма со значениями атрибутов NAME fr1, fr2 и fr3, Вы можете обратиться к этим объектам в массиве images так:

parent.frames["fr1"]
parent.frames["fr2"]
parent.frames["fr3"]

или так:

parent.frames[0]
parent.frames[1]
parent.frames[2]

Можно определить общее количество дочерних фрэймов окна через свойство length в самом window или в массиве frames.

Значение каждого элемента массива frames равно <object nameAttribute>, где nameAttribute это атрибут NAME данного фрэйма.

handleEvent

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

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

handleEvent(event)

Параметр

event

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

Описание

handleEvent работает в паре с captureEvents, releaseEvents и routeEvent. Дополнительно см. Клиентский JavaScript. Руководство.

history

Содержит информацию о URL, которые клиент посетил в окне.

Свойство из	`window`
Реализовано в	JavaScript 1.1

Описание

Значением этого свойства является ассоциированный объект History окна.

home

Переводит браузер на URL, специфицированный в настройках как домашняя страница пользователя; эквивалентно нажатию пользователем кнопки Home браузера.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

home()

Параметры

Отсутствуют.

Описание

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

innerHeight

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

Свойство из	`window`
Реализовано в	JavaScript 1.2

Описание

Для создания окна размером менее 100 x 100 пикселов установите это свойство в маркированном скрипте.

Безопасность

Для установки внутренней высоты окна размером менее 100 x 100 или больше, чем экран может вместить, Вам необходима привилегия UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

См. также

window.innerWidth, window.outerHeight, window.outerWidth

innerWidth

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

Свойство из	`window`
Реализовано в	JavaScript 1.2

Описание

Для создания окна размером менее 100 x 100 пикселов установите это свойство в маркированном скрипте.

Безопасность

Для установки внутренней ширины окна размером менее 100 x 100 или больше, чем экран может вместить, Вам необходима привилегия UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

См. также

window.innerHeight, window.outerHeight, window.outerWidth

length

Количество дочерних фрэймов окна.

Свойство из	`window`
Только для чтения
Реализовано в	JavaScript 1.0

Описание

Это свойство даст тот же результат, что и свойство length массива frames.

location

Содержит информацию о текущем URL.

Свойство из	`window`
Реализовано в	JavaScript 1.0

Описание

Значением этого свойства является ассоциированный объект Location окна.

locationbar

Представляет адресную строку окна браузера (область, содержащую области закладки и URL).

Свойство из	`window`
Реализовано в	JavaScript 1.2

Описание

Само значение свойства locationbar имеет свойство visible. Если оно true, адресная строка видна; если false, она скрыта.

Безопасность

Установка значения свойства visible адресной строки требует наличия привилегии UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

Пример

Следующий пример создаёт окно "chromeless" (в окне chromeless отсутствуют панель утилит, полосы прокрутки, статусные области и т.д., как в диалоговом окне), пряча большую часть панелей пользовательского интерфейса:

self.menubar.visible=false;
self.toolbar.visible=false;
self.locationbar.visible=false;
self.personalbar.visible=false;
self.scrollbars.visible=false;
self.statusbar.visible=false;

menubar

Представляет строку меню окна. Эта область содержит ниспадающие меню браузера, такие как File, Edit, View, Go, Communicator и т.д.

Свойство из	`window`
Реализовано в	JavaScript 1.2

Описание

Значение свойства menubar само имеет свойство visible. Если оно true, строка меню видна; если false, меню скрыто.

Безопасность

Установка значения свойства visible строки меню требует наличия привилегии UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

Примеры

self.menubar.visible=false;
self.toolbar.visible=false;
self.locationbar.visible=false;
self.personalbar.visible=false;
self.scrollbars.visible=false;
self.statusbar.visible=false;

moveBy

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

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

moveBy(horizontal, vertical)

Параметры

horizontal	Количество пикселов, на которое окно перемещается по горизонтали.
vertical	Количество пикселов, на которое окно перемещается по вертикали.

Описание

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

Безопасность

Выход за пределы одной из границ экрана (и скрытие части или всего окна) требует маркированного JavaScript, иначе окно не будет перемещаться за пределы экрана. Для этого необходимо иметь привилегию UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

Пример

Чтобы переместить текущее окно на 5 пикселов вверх (ось x) и на 10 пикселов вправо (ось у) от текущей позиции, используйте такой оператор:

self.moveBy(-5,10); // относительное позиционирование

См. также

window.moveTo

moveTo

Перемещает верхний левый угол окна на специфицированные координаты экрана.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

moveTo(x-coordinate, y-coordinate)

Параметры

x-coordinate	Левый край окна в координатах экрана.
y-coordinate	Верхний край окна в координатах экрана.

Описание

Этот метод перемещает окно в абсолютное положение, указанное его параметрами (в пикселах). Начало отсчёта по осям ведётся от абсолютной позиции (0,0); это верхний левый угол экрана монитора.

Безопасность

Пример

Для перемещения текущего окна на 25 пикселов от верхней границы экрана (ось x) и на 10 пикселов от левого края экрана (ось y) используйте такой оператор:

self.moveTo(25,10); // абсолютное позиционирование

См. также

window.moveBy

name

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

Свойство из	`window`
Только для чтения (2.0); Изменяемое (в более поздних версиях)
Реализовано в	JavaScript 1.0

Безопасность

Описание

В JavaScript 1.0 NAME было свойством только для чтения/read-only. В последующих версиях это свойство может изменяться Вашим кодом. Это даёт возможность присваивать имя окну верхнего уровня.

Пример

Первый оператор создаёт окно netscapeWin. Второй оператор выводит значение "netscapeHomePage" в диалоге Alert, поскольку "netscapeHomePage" является значением аргумента windowName окна netscapeWin.

netscapeWin=window.open("http://home.netscape.com","netscapeHomePage")
alert(netscapeWin.name)

offscreenBuffering

Специфицирует, выполняются ли обновления окна в offscreen-буфере.

Свойство из	`window`
Реализовано в	JavaScript 1.2

Описание

По умолчанию Navigator автоматически определяет, выполняются ли обновления окна в offscreen-буфере, а затем отображаются в окне. Вы можете либо полностью отключить буферизацию, либо "потребовать" от Navigator'а буферизовать обновления, установив в offscreenBuffering значение false или true, соответственно.

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

open

Открывает новое окно web-браузера.

Метод из

window

Реализован в

JavaScript 1.0

JavaScript 1.2: добавлено несколько новых windowFeatures.

Синтаксис

open(URL, windowName[, windowFeatures])

Параметры

URL	Строка, специфицирующая URL для открытия в новом окне. См. в `Location` описание компонентов URL.
windowName	Строка, специфицирующая имя окна, используемое в атрибуте `TARGET` тэга `FORM` или `A`. `windowName` может содержать только алфавитные символы, цифры и знак подчёркивания (_).
windowFeatures	Строка, специфицирующая список (с разделёнием запятыми), в которой определяется, создавать или нет различные стандартные параметры окна. Эти опции рассматриваются в следующем разделе.

Описание

В обработчиках событий Вы обязаны специфицировать window.open() вместо open(). Из-за ограничений области видимости static-объектов JavaScript, вызов open() без специфицирования имени объекта эквивалентен document.open().

Метод open открывает новое окно Web-браузера на стороне клиенте, что аналогично выбору меню New->Navigator Window из File. Аргумент URL специфицирует URL - содержимое нового окна. Если URL это пустая строка, создаётся новое пустое окно.

Вы можете использовать метод open в существующем окне, и, если Вы передаёте в качестве URL пустую строку, Вы получите ссылку на существующее окно, но не загрузите в него ничего. Вы можете, например, найти свойства в окне.

windowFeatures это строка по выбору/optional, содержащая список разделённых запятыми опций нового окна (не включайте в список пробелы). После открытия окна вы не сможете использовать JavaScript для изменения windowFeatures. Вы можете специфицировать:

Таблица 1.4 Опции, специфицируемые для вновь открываемого окна

*windowFeatures*	Описание
alwaysLowered	(JavaScript 1.2) Если yes, создаётся новое окно, которое всплывает ниже других окон, независимо от того, активно оно или нет. Это секретная опция и она обязана устанавливаться в маркированных скриптах.
alwaysRaised	(JavaScript 1.2) Если yes, создаётся новое окно, которое всплывает выше других окон, независимо от того, активно оно или нет. Это секретная опция и она обязана устанавливаться в маркированных скриптах.
dependent	(JavaScript 1.2) Если yes, создаётся новое окно - потомок текущего окна. Зависимое окно закрывается, если закрывается его окно-родитель. На платформе Windows зависимое окно не появляется на панели задач.
directories	Если yes, создаются стандартные кнопки директорий браузера, такие как What's New и What's Cool.
height	(JavaScript 1.0 и 1.1) Специфицирует высоту окна в пикселах.
hotkeys	(JavaScript 1.2) Если no (или 0), отключает большинство горячих клавиш в новом окне, которое не имеет строки меню. Комбинации security и quit продолжают функционировать.
innerHeight	(JavaScript 1.2) Специфицирует высоту области содержимого окна в пикселах. Для создания окна размером менее 100 x 100 пикселов установите это свойство в маркированном скрипте. Это свойство заменило `height`, которое оставлено для обеспечения обратной совместимости.
innerWidth	(JavaScript 1.2) Специфицирует ширину области содержимого окна в пикселах. Для создания окна размером менее 100 x 100 пикселов установите это свойство в маркированном скрипте. Это свойство заменило `width`, которое оставлено для обеспечения обратной совместимости.
location	Если yes, создаёт поле ввода Location.
menubar	Если yes, создаёт строку меню в верхней части окна.
outerHeight	(JavaScript 1.2) Специфицирует размер по вертикали в пикселах внешней границы окна. Для создания окна размером менее 100 x 100 пикселов установите это свойство в маркированном скрипте.
personalbar	(JavaScript 1.2) Если yes, создаёт панель Personal Toolbar, которая отображает кнопки из пользовательской папки закладок Personal Toolbar.
resizable	Если yes, даёт пользователю возможность изменять размеры окна.
screenX	(JavaScript 1.2) Специфицирует расстояние, на котором новое окно помещается от левого края экрана. Для помещения окна за пределы экрана/offscreen установите эту опцию в помеченном скрипте.
screenY	(JavaScript 1.2) Специфицирует расстояние, на котором новое окно помещается от верха экрана. Для помещения окна за пределы экрана/offscreen установите эту опцию в помеченном скрипте.
scrollbars	Если yes, создаются вертикальная и горизонтальная полосы прокрутки, если Документ становится больше размеров окна.
status	Если yes, создаётся статусная строка внизу окна.
titlebar	(JavaScript 1.2) Если yes, создаётся окно со строкой заголовка. Для установки titlebar в no, установите эту опцию в маркированном скрипте.
toolbar	Если yes, создаётся стандартная панель браузера с кнопками, такими как Back и Forward.
width	(JavaScript 1.0 и 1.1) Специфицирует ширину окна в пикселах.
z-lock	(JavaScript 1.2) Если yes, создаётся новое окно, которое не перекрывает другие окна при его активации. Это секретная опция и она обязана устанавливаться в маркированных скриптах.

Многие из этих опций (как указано выше) могут иметь значение yes или no. Для этих опций можно использовать 1 вместо yes и 0 вместо no. Если Вы хотите включить опцию, Вы можете просто указать имя опции в строке windowFeatures.

Если windowName не специфицирует существующее окно и Вы не предоставляете параметр windowFeatures, все опции, имеющие выбор yes/no, устанавливаются по умолчанию в yes. Однако, если Вы предоставляете параметр windowFeatures, то опции titlebar и hotkeys останутся yes по умолчанию, но другие опции, имеющие выбор yes/no, будут по умолчанию no.

Например, все следующие операторы включают опцию toolbar и отключают все другие Булевы опции:

open("", "messageWindow", "toolbar")
open("", "messageWindow", "toolbar=yes")
open("", "messageWindow", "toolbar=1")

Следующий оператор включает опции location и directories и отключает все остальные Булевы опции:

open("", "messageWindow", "toolbar,directories=yes")

Однако поведение опций alwaysLowered, alwaysRaised и z-lock зависит от иерархии окон на конкретной платформе. Например, в Windows окно браузера alwaysLowered или z-locked находится ниже всех остальных окон всех приложений. В Macintosh окно браузера alwaysLowered находится ниже остальных окон, но не обязательно ниже окон других приложений. Аналогично для окон alwaysRaised.

Вы можете использовать open для открытия нового окна, а затем - в этом новом окне - для открытия другого окна, и так далее. Таким способом Вы можете составить цепочку открытых окон, каждое из которых имеет свойство opener, указывающее на окно, открывшее данное окно.

Communicator допускает максимум 100 открытых окон. Если Вы открыли окно window2 из окна window1 и затем завершили работу с window1, установите свойство opener окна window2 в null. Это позволит JavaScript убрать мусор - окно window1. Если Вы не установите свойство opener в null, объект window1 останется, даже если он реально уже не нужен.

Безопасность

Для выполнения следующих операций Вам нужно иметь привилегию UniversalBrowserWrite:

Для создания окна размером менее 100 x 100 пикселов или больше, чем экран может вместить, с помощью innerWidth, innerHeight, outerWidth и outerHeight.
Для перемещения окна за пределы экран с использованием screenX и screenY.
Для создания окна без строки заголовка/titlebar с использованием titlebar.
Для использования alwaysRaised, alwaysLowered или z-lock для любых установок.

О безопасности см. книгу Клиентский JavaScript. Руководство.

Примеры

Пример 1. Функция windowOpener открывает окно и использует методы write для вывода сообщения:

function windowOpener() {
   msgWindow=window.open("","displayWindow","menubar=yes")
   msgWindow.document.write
      ("<HEAD><TITLE>Message window</TITLE></HEAD>")
   msgWindow.document.write
      ("<CENTER><BIG><B>Hello, world!</B></BIG></CENTER>")
}

Пример 2. Это обработчик onClick, который открывает новое клиентское окно, выводя содержимое, специфицированное в файле sesame.html. Окно открывается со специфицированными установками опций; все другие опции будут false, поскольку не специфицированы.

<FORM NAME="myform">
<INPUT TYPE="button" NAME="Button1" VALUE="Open Sesame!"
   onClick="window.open ('sesame.html', 'newWin', 
   'scrollbars=yes,status=yes,width=300,height=300')">
</FORM>

См. также

window.close

opener

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

Свойство из	`window`
Реализовано в	JavaScript 1.1

Описание

Если исходный документ открывает целевое окно методом open, свойство opener специфицирует окно исходного документа. Вычисляйте свойство opener целевого окна.

Это свойство существует до выгрузки документа в открытом окне.

Вы можете изменить свойство opener в любое время.

Можно использовать window.open для открытия нового окна, а затем использовать window.open для открытия другого окна, и так далее. Таким способом Вы можете составить цепочку открытых окон, каждое из которых имеет свойство opener, указывающее на окно, открывшее данное окно.

Примеры

Пример 1: Закрытие opener'а. Этот код закрывает окно, которое открыло текущее окно. Если opener-окно закрывается, opener остаётся без изменений. Однако window.opener.name вычисляется теперь в undefined.

window.opener.close()

Пример 2: Закрытие главного окна браузера.

top.opener.close()

Пример 3: Вычисление имени opener'а. Окно может определить имя своего opener'а так:

document.write("<BR>opener property is " + window.opener.name)

Пример 4: Изменение значения opener. Этот код изменяет значение свойства opener в null. После выполнения этого кода вы не сможете закрыть opener-окно так, как это делается в Примере 1.

window.opener=null

Пример 5: Изменение значения свойства через opener. Изменяется цвет фона окна, специфицированного свойством opener.

window.opener.document.bgColor='bisque'

См. также

window.close, window.open

outerHeight

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

Свойство из	`window`
Реализовано в	JavaScript 1.2

Описание

Внешняя граница включает полосы прокрутки, статусную строку, панели toolbars и другой "chrome" (элементы пользовательского интерфейса рамки окна). Для создания окна размером менее 100 x 100 пикселов, установите это свойство в маркированном скрипте.

См. также

window.innerWidth, window.innerHeight, window.outerWidth

outerWidth

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

Свойство из	`window`
Реализовано в	JavaScript 1.2

Описание

Внешняя граница включает полосы прокрутки, статусную строку, панели toolbar и другой "chrome" (элементы пользовательского интерфейса рамки окна). Для создания окна размером менее 100 x 100 пикселов, установите это свойство в маркированном скрипте.

См. также

window.innerWidth, window.innerHeight, window.outerHeight

pageXOffset

Предоставляет текущую x-позицию в пикселах видимой страницы окна.

Свойство из	`window`
Только для чтения
Реализовано в	JavaScript 1.2

Описание

Свойство pageXOffset предоставляет текущую x-позицию страницы относительно верхнего левого угла области содержимого окна. Это свойство используется, если Вам необходимо найти текущую позицию прокручиваемой страницы перед использованием scrollTo или scrollBy.

Пример

Этот пример возвращает x-позицию видимой страницы.

x = myWindow.pageXOffset

См. также

window.pageYOffset

pageYOffset

Предоставляет текущую у-позицию в пикселах видимой страницы окна.

Свойство из	`window`
Только для чтения
Реализовано в	JavaScript 1.2

Описание

Свойство pageYOffset предоставляет текущую у-позицию страницы относительно верхнего левого угла области содержимого окна. Это свойство используется, если Вам необходимо найти текущую позицию прокручиваемой страницы перед использованием scrollTo или scrollBy.

Пример

Этот пример возвращает у-позицию видимой страницы.

x = myWindow.pageYOffset

См. также

window.pageXOffset

parent

Свойство parent это окно или фрэйм, чей frameset/набор фрэймов содержит текущий фрэйм.

Свойство из	`window`
Только для чтения
Реализовано в	JavaScript 1.0

Описание

Это свойство имеет смысл только для фрэймов; то есть для окон, которые не являются окнами верхнего уровня.

Свойство parent ссылается на тэг FRAMESET окна фрэйма. Дочерние фрэймы в данном frameset ссылаются на родственные фрэймы через использование parent вместо имени окна одним из следующих способов:

parent.frameName
parent.frames[index]

Например, если четвёртый фрэйм набора имеет NAME="homeFrame", фрэймы-родственники могут ссылаться на этот фрэйм через использование parent.homeFrame или parent.frames[3].

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

Значением свойства parent является

<object nameAttribute>

где nameAttribute это атрибут NAME, если родитель является фрэймом, или внутренняя ссылка, если родителем является окно.

Примеры

См. примеры для Frame.

personalbar

Представляет персональную панель окна браузера (называемую также панелью директорий). Эту область пользователь может использовать для быстрого доступа к определённым закладкам.

Свойство из	`window`
Реализовано в	JavaScript 1.2

Описание

Значение свойства personalbar само имеет свойство visible. Если оно true, персональная панель отображается; если false, панель скрыта.

Безопасность

Установка значения свойства visible персональной панели требует наличия привилегии UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

Пример

Следующий пример делает окно, на которое ссылаются, "chromeless" (в chromeless-окнах нет панелей toolbars, полос прокрутки, статусной области и т.д., что делает их похожими на диалоговые окна), пряча большинство из панелей интерфейса пользователя:

self.menubar.visible=false;
self.toolbar.visible=false;
self.locationbar.visible=false;
self.personalbar.visible=false;
self.scrollbars.visible=false;
self.statusbar.visible=false;

print

Печатает содержимое окна.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

print()

Параметры

Отсутствуют.

prompt

Выводит диалог Prompt с сообщением и полем для ввода.

Метод из	`window`
Реализован в	JavaScript 1.0

Синтаксис

prompt(message[, inputDefault])

Параметры

message	Строка - текст сообщения.
inputDefault	Строка или целое число представляющее значение по умолчанию поля ввода.

Описание

Диалог prompt выглядит так:

Используйте метод prompt для вывода диалогового окна, принимающего ввод от пользователя. Если Вы не специфицируете начальное значение для inputDefault, диалог показывает <undefined>.

Вы не можете специфицировать заголовок диалога prompt, но можете использовать метод open для создания Вашего собственного prompt-диалога. См. open.

Примеры

prompt("Enter the number of cookies you want to order:", 12)

См. также

window.alert, window.confirm

releaseEvents

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

Метод из	`window`
Реализован в	JavaScript 1.2

ПРИМЕЧАНИЕ: Если первоначальной целью/target события является окно, это окно получает событие, даже если оно имеет установку освобождать события этого типа.

Синтаксис

releaseEvents(eventType1 [|eventTypeN...])

Параметр

eventType1... eventTypeN

Тип захватываемых событий. Типы событий рассматриваются в Главе 3, "Обработчики Событий".

Описание

releaseEvents работает вместе с captureEvents, routeEvent и handleEvent. Дополнительно см. Клиентский JavaScript. Руководство.

resizeBy

Изменяет размеры всего окна, перемещая нижний правый угол окна на специфицированные величины.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

resizeBy(horizontal, vertical)

Параметры

horizontal	Количество пикселов, на которое окно изменяет размер по горизонтали.
vertical	Количество пикселов, на которое окно изменяет размер по вертикали.

Описание

Этот метод изменяет размеры окна через установку свойств outerWidth и outerHeight. Верхний левый угол остаётся на месте, а нижний правый угол перемещается.
resizeBy перемещает окно, прибавляя или вычитая специфицированное количество пикселов к координатам текущей позиции правого нижнего угла.

Безопасность

Выход за любую границу экрана (для скрытия части или всего окна) требует маркированного JavaScript, иначе окно не будет перемещаться за пределы экрана. Кроме того, окна имеют форсированный минимальный размер 100 x 100 пикселов; изменение размеров окна меньше этого минимума требует маркированного JavaScript. Для этого Вам нужна привилегия UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

Пример

Чтобы сделать текущее окно на 5 пикселов уже и на 10 пикселов выше, используйте такой оператор:

self.resizeBy(-5,10); // относительное позиционирование

См. также

window.resizeTo

resizeTo

Изменяет размеры всего окна.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

resizeTo(outerWidth, outerHeight)

Параметры

outerWidth	Целое число - ширина окна в пикселах.
outerHeight	Целое число - высота окна в пикселах.

Описание

Этот метод изменяет размеры окна, устанавливая его свойства outerWidth и outerHeight. Верхний левый угол остаётся на месте, а правый нижний угол перемещается.
resizeBy перемещает на специфицированную позицию. Началом осей является абсолютная позиция (0,0); это левый верхний угол дисплея.

Безопасность

Примеры

Чтобы сделать окно шириной 225 пикселов и высотой 200 пикселов, используйте этот оператор:

self.resizeTo(225,200); // абсолютное позиционирование

См. также

window.resizeBy

routeEvent

Передаёт захваченное событие по нормальной цепи иерархии.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

routeEvent(event)

Параметр

event

Имя перенаправляемого события.

Описание

Если субобъект (document или layer) также захватывает событие, событие посылается этому объекту. Иначе оно посылается своей изначальной цели.

routeEvent работает вместе с captureEvents, releaseEvents и handleEvent. Дополнительно см. Клиентский JavaScript. Руководство.

screenX

Специфицирует x-координату левого угла окна.

Свойство из	`window`
Реализовано в	JavaScript 1.2

Безопасность

Установка значения свойства screenX требует наличия привилегии UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

См. также

window.screenY

screenY

Специфицирует y-координату верхнего угла окна.

Свойство из	`window`
Реализовано в	JavaScript 1.2

Безопасность

Установка значения свойства screenY требует наличия привилегии UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

См. также

window.screenX

scroll

Прокручивает окно до специфицированных координат.

Метод из

window

Реализован в

JavaScript 1.1

JavaScript 1.2: не рекомендуется.

Описание

В JavaScript 1.2, scroll больше не используется и заменён на scrollTo.
scrollTo расширяет возможности метода scroll.
scroll оставлен для обеспечения обратной совместимости.

scrollbars

Представляет вертикальную и горизонтальную полосы прокрутки окна браузера для области документа.

Свойство из	`window`
Реализовано в	JavaScript 1.2

Описание

Значение свойства scrollbars само имеет свойство visible. Если оно true, видны обе полосы прокрутки; если false, они скрыты.

Безопасность

Установка значения свойства visible полос прокрутки требует наличия привилегии UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

Примеры

Следующий пример делает окно, на которое ссылаются, "chromeless" (в chromeless-окнах нет панелей toolbar, полос прокрутки, статусной области и т.д., что делает их похожими на диалоговые окна), пряча большинство из панелей интерфейса пользователя:

self.menubar.visible=false;
self.toolbar.visible=false;
self.locationbar.visible=false;
self.personalbar.visible=false;
self.scrollbars.visible=false;
self.statusbar.visible=false;

scrollBy

Прокручивает область просмотра окна на специфицированную величину.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

scrollBy(horizontal, vertical)

Параметры

horizontal	Количество пикселов, на которое область просмотра прокручивается по горизонтали.
vertical	Количество пикселов, на которое область просмотра прокручивается по вертикали.

Описание

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

Чтобы этот метод работал, свойство visible для опции window.scrollbars обязано быть true.

Пример

Для прокрутки текущего окна на 5 пикселов влево и на 30 пикселов вниз от текущей позиции, используйте:

self.scrollBy(-5,30); // относительное позиционирование

См. также

window.scrollTo

scrollTo

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

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

scrollTo(x-coordinate, y-coordinate)

Параметры

x-coordinate	Целое число, представляющее x-координату области просмотра в пикселах.
y-coordinate	Целое число, представляющее у-координату области просмотра в пикселах.

Описание

scrollTo заменил scroll. scroll оставлен для обеспечения обратной совместимости.

Метод scrollTo прокручивает содержимое окна, если имеются невидимые части за пределами окна. Чтобы этот метод работал, свойство visible для опции window.scrollbars обязано быть true.

Примеры

Пример 1: Прокрутка текущей области просмотра. Для прокрутки окна к левой границе и на 20 пикселов вниз от верха окна, используйте этот оператор:

self.scrollTo(0,20); // абсолютное позиционирование

Пример 2: Прокрутка другой области просмотра. Это код, расположенный в одном фрэйме, прокручивает область просмотра другого фрэйма. Два объекта Text дают пользователю возможность специфицировать координаты x и y. если пользователь щёлкает по кнопке Go, документ в frame2 прокручивается на специфицированные координаты.

<SCRIPT>
function scrollIt(form) {
   var x = parseInt(form.x.value)
   var y = parseInt(form.y.value)
   parent.frame2.scrollTo(x, y)
}
</SCRIPT>
<BODY>

<FORM NAME="myForm">
<P><B>Specify the coordinates to scroll to:</B>
<BR>Horizontal:
<INPUT TYPE="text" NAME=x VALUE="0" SIZE=4>
<BR>Vertical:
<INPUT TYPE="text" NAME=y VALUE="0" SIZE=4>
<BR><INPUT TYPE="button" VALUE="Go"
   onClick="scrollIt(document.myForm)">
</FORM>

См. также

window.scrollBy

self

Свойство self это синоним текущего окна.

Свойство из	`window`
Только для чтения
Реализовано в	JavaScript 1.0

Описание

Свойство self ссылается на текущее окно. То есть значение этого свойства является синонимом самого объекта.

Используйте свойство self для устранения неоднозначности свойства window при вызове из формы или элемента формы с тем же именем. Вы можете также использовать свойство self, для того чтобы сделать Ваш код более читабельным.

Значением свойства self является

<object nameAttribute>

где nameAttribute это атрибут NAME, если self ссылается на фрэйм, или внутренняя ссылка, если self ссылается на окно.

Пример

В этом примере self.status используется для установки свойства status текущего окна. Такое использование устраняет неоднозначность свойства status текущего окна при вызове из формы или элемента формы с названием status внутри текущего окна.

<A HREF=""
   onClick="this.href=pickRandomURL()"
   onMouseOver="self.status='Pick a random URL' ; return true">
Go!</A>

setHotKeys

Включает или отключает "горячие клавиши" в данном окне, которое не имеет меню.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

setHotKeys(trueOrFalse)

Параметр

trueOrFalse

Булево значение, специфицирующее включение горячих клавиш:

true включает
false отключает

Безопасность

Для включения/отключения горячих клавиш Вам нужно иметь привилегию UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

Описание

По умолчанию горячие клавиши отключены в окне, в котором отсутствует меню. С помощью метода setHotKeys вы можете явным образом включать/отключать все горячие клавиши, за исключением security и quit, которые всегда включены.

Можно также специфицировать включение горячих клавиш во время создания окна, если используется метод window.open.

См. также

window.open

setInterval

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

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

setInterval(expression, msec)
setInterval(function, msec[, arg1[, ..., argN]])

Параметры

function	Любая функция.
expression	Строка, содержащая выражение JavaScript. Это выражение обязано быть заключено в кавычки; иначе `setInterval` вызывает его немедленно. Например, `setInterval("calcnum(3, 2)", 25)`.
msec	Числовое значение или строка цифр, в миллисекундах.
arg1, ..., argn	Аргументы, если имеются, передаваемые в `function`.

Описание

Таймаут работает до момента уничтожения ассоциированного окна или фрэйма или до отмены интервала методом clearInterval.

setInterval не нарушает выполнение скрипта. Скрипт продолжается сразу после выполнения метода (не ожидая повторения интервала). Его вызов просто откладывает будущее событие.

Пример

Этот код отображает текущее время в объекте Text. В функции startclock вызов метода setInterval заставляет вызывать функцию showtime каждую секунду для обновления показаний часов. Заметьте, что функция startclock и метод setInterval вызываются только один раз каждый.

<SCRIPT LANGUAGE="JavaScript">
var timerID = null
var timerRunning = false

function stopclock(){
   if(timerRunning)
      clearInterval(timerID)
   timerRunning = false
}

function startclock(){
   // Убедиться, что часы остановлены
   stopclock()
   timerID = setInterval("showtime()",1000)
   timerRunning = true
}

function showtime(){
   var now = new Date()
   var hours = now.getHours()
   var minutes = now.getMinutes()
   var seconds = now.getSeconds()
   var timeValue = "" + ((hours > 12) ? hours - 12 : hours)
   timeValue += ((minutes < 10) ? ":0" : ":") + minutes
   timeValue += ((seconds < 10) ? ":0" : ":") + seconds
   timeValue += (hours >= 12) ? " P.M." : " A.M."
   document.clock.face.value = timeValue
}
</SCRIPT>

<BODY onLoad="startclock()">
<FORM NAME="clock" onSubmit="0">
   <INPUT TYPE="text" NAME="face" SIZE=12 VALUE ="">
</FORM>
</BODY>

См. также

window.clearInterval, window.setTimeout

setResizable

Специфицирует, может ли пользователь изменять размеры окна.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

setResizable(trueOrFalse)

Параметр

trueOrFalse

Булево значение, специфицирующее, может ли пользователь изменять размеры окна:

true разрешает
false запрещает

Описание

По умолчанию новое окно Navigator'а может менять размеры. Методом setResizable Вы можете явно разрешить или запретить пользователю изменять размеры окна. Не все операционные системы поддерживают этот метод.

Вы можете также специфицировать, может ли окно изменять размеры во время создания, если используется метод window.open.

См. также

window.open

setTimeout

Вычисляет выражение или вызывает функцию по истечении специфицированного количества миллисекунд.

Метод из

window

Реализован в

JavaScript 1.0: вычисляется выражение.

JavaScript 1.2: вызывается функция.

Синтаксис

setTimeout(expression, msec)
setTimeout(function, msec[, arg1[, ..., argN]])

Параметры

expression	Строка, содержащая выражение JavaScript. Выражение обязано быть заключено в кавычки; иначе `setTimeout` вызывает его немедленно. Например, `setTimeout("calcnum(3, 2)", 25)`.
msec	Числовое значение или строка цифр, в миллисекундах.
function	Любая функция.
arg1, ..., argN	Аргументы, если имеются, передаваемые в `function`.

Описание

Метод setTimeout вычисляет выражение или вызывает функцию по истечении специфицированного количества времени. Он не выполняется повторно. Например, если метод setTimeout специфицирует 5 секунд, через пять секунд вычисляется выражение или вызывается функция, но не каждые пять секунд. Для выполнения повторяющихся таймаутов используйте метод setInterval.

setTimeout не нарушает выполнение скрипта. Скрипт продолжается сразу после выполнения метода (не ожидая повторения интервала). Его вызов просто откладывает будущее событие.

Примеры

Пример 1. Сообщение alert выводится через 5 секунд (5,000 миллисекунд) после щелчка пользователя по кнопке. Если пользователь щёлкает вторую кнопку до вывода сообщения, таймаут отменяется и alert не отображается.

<SCRIPT LANGUAGE="JavaScript">
function displayAlert() {
   alert("5 seconds have elapsed since the button was clicked.")
}
</SCRIPT>
<BODY>
<FORM>
Click the button on the left for a reminder in 5 seconds; 
click the button on the right to cancel the reminder before 
it is displayed.
<P>
<INPUT TYPE="button" VALUE="5-second reminder"
   NAME="remind_button"
   onClick="timerID=setTimeout('displayAlert()',5000)">
<INPUT TYPE="button" VALUE="Clear the 5-second reminder"
   NAME="remind_disable_button"
   onClick="clearTimeout(timerID)">
</FORM>
</BODY>

Пример 2. Выводится текущее время в объекте Text. Функция showtime, вызываемая рекурсивно, использует метод setTimeout для обновления значения каждую секунду.

<HEAD>
<SCRIPT LANGUAGE="JavaScript">
<!--
var timerID = null
var timerRunning = false
function stopclock(){
   if(timerRunning)
      clearTimeout(timerID)
   timerRunning = false
}
function startclock(){
   // Убедиться, что часы остановлены
   stopclock()
   showtime()
}

function showtime(){
   var now = new Date()
   var hours = now.getHours()
   var minutes = now.getMinutes()
   var seconds = now.getSeconds()
   var timeValue = "" + ((hours > 12) ? hours - 12 : hours)
   timeValue += ((minutes < 10) ? ":0" : ":") + minutes
   timeValue += ((seconds < 10) ? ":0" : ":") + seconds
   timeValue += (hours >= 12) ? " P.M." : " A.M."
   document.clock.face.value = timeValue 
   timerID = setTimeout("showtime()",1000)
   timerRunning = true
}
//-->
</SCRIPT>
</HEAD>

<BODY onLoad="startclock()">
<FORM NAME="clock" onSubmit="0">
   <INPUT TYPE="text" NAME="face" SIZE=12 VALUE ="">
</FORM>
</BODY>

См. также

window.clearTimeout, window.setInterval

setZOptions

Специфицирует поведение z-order стэкирования окна.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

setZOptions(windowPosition)

Параметр

windowPosition

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

alwaysRaised создаёт новое окно, которое всплывает поверх всех других окон, независимо от того, активно оно или нет.
alwaysLowered создаёт новое окно, которое всплывает ниже всех других окон, независимо от того, активно оно или нет.
z-lock создаёт новое окно, которое не всплывает поверх других окон при активации.

Безопасность

Для установки этого свойства необходимо обладать привилегией UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

Описание

По умолчанию окно Navigator'а переходит наверх в порядке z-order при активации и переходит вниз в порядке z-order при активации других окон. С помощью метода setZOptions Вы можете явно специфицировать положение окна в порядке z-order.

Если Вы не специфицируете аргумент для setZOptions, этот метод восстанавливает стэкирование z-order по умолчанию окна Navigator'а.

Вы можете также специфицировать поведение порядка стэкирования окна во время его создания при использовании метода window.open.

См. также

window.open

status

Специфицирует приоритетное сообщение статусной строки окна, такое как сообщение появляющееся при возникновении события mouseOver в якоре.

Свойство из	`window`
Реализовано в	JavaScript 1.0

Безопасность

Описание

Не путайте свойство status со свойством defaultStatus. Свойство defaultStatus отражает сообщение по умолчанию, выводимое в статусной строке/status bar.

Вы можете установить свойство status в любое время. Вы обязаны возвращать true, если хотите установить свойство status в обработчике onMouseOver.

Примеры

Предположим, Вы создали функцию JavaScript под названием pickRandomURL, которая даёт возможность выбрать произвольный URL. Вы можете использовать обработчик onClick в якоре для динамического специфицирования значения атрибута HREF этого якоря и обработчик onMouseOver - для специфицирования специального сообщения для окна - в свойстве status:

<A HREF=""
   onClick="this.href=pickRandomURL()"
   onMouseOver="self.status='Pick a random URL'; return true">
Go!</A>

Здесь свойство status окна присваивается свойству self окна таким образом: self.status.

См. также

window.defaultStatus

statusbar

Представляет строку статуса/status bar окна. Это область, содержащая индикатор security, статус браузера и т.п.

Свойство из	`window`
Реализовано в	JavaScript 1.2

Описание

Значение свойства statusbar само имеет свойство visible. Если оно true, статусная строка отображается; если false, она скрыта.

Безопасность

Установка значения свойства visible статусной строки требует наличия привилегии UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

Примеры

self.menubar.visible=false;
self.toolbar.visible=false;
self.locationbar.visible=false;
self.personalbar.visible=false;
self.scrollbars.visible=false;
self.statusbar.visible=false;

stop

Останавливает загрузку.

Метод из	`window`
Реализован в	JavaScript 1.2

Синтаксис

stop()

Параметры

Отсутствуют.

Определение

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

toolbar

Представляет панель toolbar окна браузера, содержащую кнопки навигации, такие как Back, Forward, Reload, Home и т.п.

Свойство из	`window`
Реализовано в	JavaScript 1.2

Описание

Значение свойства toolbar само имеет свойство visible. Если оно true, toolbar отображается; если false, панель скрыта.

Безопасность

Установка значения свойства visible панели toolbar требует наличия привилегии UniversalBrowserWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

Пример

Следующий пример делает окно, на которое ссылаются, "chromeless" (в chromeless-окнах нет панели toolbar, полос прокрутки, статусной области и т.д., что делает их похожими на диалоговые окна), пряча большинство из панелей интерфейса пользователя:

self.menubar.visible=false;
self.toolbar.visible=false;
self.locationbar.visible=false;
self.personalbar.visible=false;
self.scrollbars.visible=false;
self.statusbar.visible=false;

top

Свойство top это синоним самого верхнего окна браузера, которое является окном документа или окном web-браузера.

Свойство из	`window`
Только для чтения
Реализовано в	JavaScript 1.0

Описание

Свойство top ссылается на самое верхнее окно, содержащее фрэймы или вложенные наборы фрэймов/frameset. Используйте свойство top для обращения к этому окну-предку.

Значением этого свойства является

<object objectReference>

где objectReference это внутренняя ссылка.

Примеры

Оператор top.close() закрывает самое верхнее окно иерархии окон .

Оператор top.length специфицирует количество фрэймов, содержащихся внутри самого верхнего окна. Если самый верхний предок определён так, top.length возвращает 3:

<FRAMESET COLS="30%,40%,30%">
<FRAME SRC=child1.htm NAME="childFrame1">
<FRAME SRC=child2.htm NAME="childFrame2">
<FRAME SRC=child3.htm NAME="childFrame3">
</FRAMESET>

Следующий пример устанавливает цвет фона фрэйма myFrame в red.

myFrame это потомок самого верхнего окна-предка.

top.myFrame.document.bgColor="red"

window

Свойство window это синоним текущего окна или фрэйма.

Свойство из	`window`
Только для чтения
Реализовано в	JavaScript 1.0

Описание

Свойство window ссылается на текущее окно или фрэйм. То есть значение этого свойства является синонимом самого объекта.

Хотя можно использовать свойство window как синоним текущего фрэйма, Ваш код будет лучше читаться, если вы будете использовать свойство self. Например, window.name и self.name оба специфицируют имя текущего фрэйма, но self.name легче понять (поскольку фрэйм не отображается как отдельное окно).

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

Значением свойства window является

<object nameAttribute>

где nameAttribute это атрибут NAME, если window ссылается на фрэйм, или внутренняя ссылка, если window ссылается на окно.

Пример

Здесь window.status используется для установки свойства status текущего окна. Такое использование устраняет неоднозначность свойства status текущего окна при обращении к текущему окну из формы, которая называется "status", в текущем окне.

<A HREF=""
   onClick="this.href=pickRandomURL()"
   onMouseOver="window.status='Pick a random URL' ; return true">
Go!</A>

См. также

window.self

Оглавление | Назад | Вперёд | Индекс

Дата последнего обновления: 28 мая 1999 года.
Copyright (c) 1999 Netscape Communications Corporation

window
страницы в данном разделе
> ancor	> applet
> area.htm	> array
> Индекс	> Boolean
> button	> Checkbox
> Классы, Конструкторы и Методы Java	> Значения Цветов
> Оглавление	> Куки Netscape
> date.htm	> document
> event	> FileUpload
> form.htm	> Frame
> Function	> Обработчики Событий
> Hidden	> History
> Image	> Оглавление
> java.htm	> JavaArray
> JavaClass	> JavaObject
> JavaPackage	> Приложение A. Зарезервированные Слова
> Layer	> JSException
> JSObject	> Plugin
> link.htm	> Location
> math.htm	> MimeType
> navigator	> netscape
> Number	> Object
> Объекты, Методы и Свойства	> Операции
> Option	> Packages
> Приложения	> Справочник по Классам LiveConnect
> Элементы Языка	> Объекты. Справочник.
> Password	> Plugin
> Об Этой Книге	> Radio
> RegExp	> Reset
> screen	> Select
> Операторы	> String
> Style	> Submit
> sun.htm	> text.htm
> Textarea	> toc.htm
> Свойства и Функции Верхнего Уровня	> Новые Возможности в Этой Версии
> window	>