Свойство sidebar
Синтаксис: window.sidebar
Изменяемое: нет
Значением этого свойства является указатель на недокументированный объект с интерфейсом nsISidebar, соответствующий боковой панели обозревателя (его описание в Gecko DOM window Reference не соответствует действительности). Мы обнаружили, что этот объект лишен свойств, но имеет четыре метода:
| Метод | Описание |
|---|
| addPanel(panel) | Недокументировано. | | addSearchEngine(engineURI, iconURI, engineName, categoryName) | Запрашивает подтверждение на доавление к боковой панели поисковой системы. Аргументы: engineURI - URI поисковой системы, iconURI - URI ее иконки, engineName - имя, которое будет присвоено поисковой системе, categoryName - название категории поиска. | | QueryInterface(interfaceName) | Недокументировано. | | setWindow(windowFrame) | Недокументировано. |
Этот объект еще находится в стадии разработки, поэтому подробно мы опишем его позже. Пример добавления поисковой системы к боковой панели:
window.sidebar.addSearchEngine("http://www.mozilla.org/projects/search/mozilla.src",
"http://www.mozilla.org/projects/search/mozilla.gif", "mozilla.org", "Web");
Свойство status
Синтаксис: window.status
Изменяемое: да
Свойство status возвращает или устанавливает текст сообщения, выводимый в строке состояния, которая расположена в нижней части окна обозревателя. Не следует путать его со свойством defaultStatus, которое содержит текст, выводимый в строке состояния по умолчанию. Пример:
Свойство statusbar
Синтаксис: window.statusbar
Изменяемое: нет
Значением этого свойства является указатель на объект barProp, соответствующий строке состояния обозревателя. Этот объект имеет единственное свойство visible, доступное для чтения и записи и указывающее на состояние панели (true, если строка состояния видна, и false, если она скрыта). Для изменения этого свойства необходима привилегия UniversalBrowserWrite. Пример:
netscape.security.PrivilegeManager.enablePrivilege("UniversalBrowserWrite");
window.statusbar.visible = true;
Свойство title
Синтаксис: window.title
Изменяемое: да
Это свойство возвращает или задает заголовок окна. Если заголовок окна не был ранее задан, то оно возвращает undef. Текст заголовка хранится в данном свойстве, но нигде не отображается. Пример:
window.title = "Мое окно";
alert(window.title);
Свойство toolbar
Синтаксис: window.toolbar
Изменяемое: нет
Значением этого свойства является указатель на объект barProp, соответствующий панели кнопок обозревателя. Этот объект имеет единственное свойство visible, доступное для чтения и записи и указывающее на состояние панели (true, если она видна, и false, если она скрыта). Для изменения этого свойства необходима привилегия UniversalBrowserWrite. Пример:
netscape.security.PrivilegeManager.enablePrivilege("UniversalBrowserWrite");
window.toolbar.visible = true;
Свойство top
Синтаксис: window.top
Изменяемое: нет
Это свойство возвращает ссылку на первое окно в иерархии объектов window, т. е. на объект, у которого свойство parent равно самому объекту.
Свойство window
Синтаксис: window.window
Изменяемое: нет
Это свойство возвращает ссылку на текущий объект window, т. е. на самого себя (синоним свойства self).
Метод alert
Синтаксис: window.alert(текст?)
Аргументы: текст - строковое значение
Метод alert создает диалоговое окно сообщения и, если текст задан, выводит его в это окно. Например, оператор alert("Здравствуйте!") выведет на экран следующее окно:
Метод back
Синтаксис: window.back()
Метод back эквивалентен нажатию кнопки обозревателя Back (Назад). Он возвращает нас на один шаг в истории просмотра самого верхнего окна в иерархии окон, в отличие от метода history.back(), который делает шаг назад в истории просмотра текущего окна или фрейма.
Метод blur
Синтаксис: window.blur()
Метод blur заставляет окно потерять фокус и генерирует событие onblur. Это программный эквивалент удалению пользователем фокуса с текущего окна.
Метод captureEvents
Синтаксис: window.captureEvents(Event.тип)
Аргументы: тип - тип события
Метод captureEvents включает перехват заданным окном всех событий заданного типа. Тип события задается одним из следующих ключевых слов, набранных в любом регистре:
| abort | error | mousedown | reset | | blur | focus | mousemove | resize | | change | keydown | mouseout | select | | click | keypress | mouseover | submit | | dblclick | keyup | mouseup | unload | | dragdrop | load | move | |
События обычно проходят через обработчики событий окна и документа прежде, чем попасть к обработчику объекта, сгенерировавшему это событие. Данный метод перехватывает все события указанного типа и не пропускает их к следующим объектам в иерархии. Для того, чтобы восстановить обычный порядок распространения событий, необходимо вызывать метод releaseEvents. Пример перехвата всех щелчков мышью в окне:
<HTML>
<HEAD>
<SCRIPT>
function reg() {
window.captureEvents(Event.CLICK);
window.onclick = new Function("alert('hit')");
}
</SCRIPT>
</HEAD>
<BODY onload="reg()">
<BUTTON>Test</BUTTON>
</BODY>
</HTML>
Мы можем задать в вызове этого метода сразу несколько типов событий, разделяя их символом "|", например:
window.captureEvents(Event.KEYPRESS | Event.KEYDOWN | Event.KEYUP);
Метод clearInterval
Синтаксис: window.clearInterval(таймер)
Аргументы: таймер - целое значение
Этот метод останавливает таймер, созданный методом setInterval. См. подробности и пример в описании этого метода.
Метод clearTimeout
Синтаксис: window.clearTimeout(таймер)
Аргументы: таймер - целое значение
Этот метод останавливает таймер, созданный методом setTimeout. См. подробности и пример в описании этого метода.
Метод close
Синтаксис: window.close()
Метод close закрывает заданное окно обозревателя. Если окно было создано программно, то оно просто закрывается. Если же окно было создано обозревателем, то перед его закрытием выводится диалоговое окно, запрашивающее подтверждение действия. Если, однако, в истории просмотра окна только один документ (текущий), то окно закрывается без запроса подтверждения. Такое решение было принято для поддержки временных окон, которые открывают другие окна, а затем закрываются. Для того, чтобы закрывать любое окно без подтверждения, необходима привилегия UniversalBrowserWrite.
Пример:
netscape.security.PrivilegeManager.enablePrivilege("UniversalBrowserWrite");
self.close();
В обработчиках событий нужно полностью указывать вызов window.close, иначе будет вызван неявно подразумеваемый метод document.close.
Метод confirm
Синтаксис: window.confirm(текст?)
Аргументы: текст - строковое значение
Результат: логическое значение
Метод confirm создает диалоговое окно подтверждения и, если текст задан, выводит его в это окно. Он возвращает true, если пользователь нажал кнопку OK, и false, если пользователь нажал кнопку Cancel. Например, оператор confirm("Отформатировать системный диск?") выведет на экран следующее окно:
Метод disableExternalCapture
Синтаксис: window.disableExternalCapture()
Этот метод запрещает перехват внешних событий, разрешенных методом enableExternalCapture. См. подробности в описании этого метода.
Метод dump
Синтаксис: window.dump(текст)
Аргументы: текст - строковое значение
Утверждается, что этот метод выводит заданный текст в консоль JavaScript обозревателя и предназначен для вывода отладочных сообщений. Мне этого добиться не удалось: метод выполнялся без ошибки, но в консоль не выводил ничего.
Метод enableExternalCapture
Синтаксис: window.enableExternalCapture()
Этот метод используется в окнах, содержащих фреймы, для того, чтобы разрешить данному окну перехват событий, сгенерированных фреймами, в которые загружены документы с других серверов. Для перехвата внешних событий какого-либо типа вам нужно получить привилегию UniversalBrowserWrite, вызвать этот метод, а затем вызвать метод captureEvents, задав ему тип перехватываемых событий. Пример:
netscape.security.PrivilegeManager.enablePrivilege("UniversalBrowserWrite");
enableExternalCapture();
captureEvents(Event.CLICK);
Метод escape
Синтаксис: window.escape(строка)
Аргументы: строка - любое строковое выражение
Результат: новый строковый объект
Метод escape преобразует входную строку в шестнадцатеричную кодировку. При этом все символы, не являющиеся символами базовой латиницы, заменяются на их шестнадцатеричные escape-коды %xx в текущей кодировке операционной системы. Например, оператор document.write(escape("Строка")) выведет в русской версии Windows на экран обозревателя строку %D1%F2%F0%EE%EA%E0. Обратное преобразование строки производится методом unescape.
Обратите внимание, что этот метод перекрывает метод escape глобального объекта JavaScript, который кодирует символы шестнадцатеричными кодами Unicode.
Метод focus
Синтаксис: window.focus()
Метод focus заставляет окно получить фокус и генерирует событие onfocus. Учтите, что окно не может получить фокус, пока документ не будет полностью в него загружен.
Метод forward
Синтаксис: window.forward()
Метод forward эквивалентен нажатию кнопки обозревателя Forward (Вперед). Он переводит нас на один шаг вперед в истории просмотра самого верхнего окна в иерархии окон, в отличие от метода history.forward(), который делает шаг вперед в истории просмотра текущего окна или фрейма.
Метод GetAttention
Синтаксис: window.GetAttention()
Метод GetAttention вызвает мигание иконки обозревателя до тех пор, пока он не будет активизирован.
В Windows и Linux мигает иконка в панели задач, в MacOS - в правом верхнем углу системной панели. Пример:
setTimeout("window.GetAttention()", 3000);
Метод getSelection
Синтаксис: window.getSelection()
Этот метод возвращает указатель на недокументированный объект с интерфейсом nsISelection, соответствующий выделенному пользователем фрагменту документа. Если выбранный фрагмент является текстом, то возвращаемый объект автоматически преобразуется в строку. Пример:
alert(window.getSelection());
Метод home
Синтаксис: window.home()
Метод home загружает в окно домашнюю страницу пользователя, указанную в настройках обозревателя. Его вызов эквивалентен нажатию кнопки обозревателя Home (Домой).
Метод moveBy
Синтаксис: window.moveBy(x, y)
Аргументы: x, y - целые значения
Этот метод перемещает окно на x пикселей по горизонтали и y пикселей по вертикали. Пример: moveBy(10, -5).
1 2 3 4 5 6
8 8 8
| 
*
Обратная связь