Клиентский JavaScript. Справочник

         

Описание


Используйте метод anchor с методами document.write или document.writeln для программного создания и вывода якоря документа. Создайте якорь методом anchor, а затем вызовите write или writeln для отображения этого якоря в документе. В серверном JavaScript используйте для этого функцию write.

В этом синтаксисе строка nameAttribute представляет атрибут NAME тэга A, а строка, вызывающая этот метод, это текст, видимый пользователю.

Якоря, созданные методом anchor, становятся элементами массива document.anchors.



Описание


Используйте метод big вместе с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте функцию write для отображения строки.



Описание


Используйте метод blink вместе с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте функцию write для отображения строки.



Описание




Используйте метод bold вместе с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте функцию write для отображения строки.



Описание


Символы строки индексируются слева направо. Индекс первого символа строки равен 0, а последнего (для строки с именем stringName) stringName.length - 1. Если предоставляемый Вами index выходит за пределы указанного диапазона, JavaScript возвращает пустую строку.



Описание


Unicode-значения в диапазоне от 0 до 65,535. Первые 128 Unicode-значений совпадают напрямую с набором символов ASCII. Об Unicode см. книгу Клиентский JavaScript. Руководство.



Описание


concat объединяет текст строк и возвращает новую строку. Изменения в тексте одной строки не влияют на другую.



Описание


Используйте метод fixed вместе с методами write или writeln для форматирования и отображения строки документа. В серверном JavaScript используйте функцию write для отображения строки.



Описание


Используйте метод fontcolor вместе с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте функцию write для отображения строки.

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

Метод fontcolor переопределяет значение, установленное в свойстве fgColor.



Описание


Используйте метод fontsize вместе с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте функцию write для отображения строки.

Если size специфицируется как целое число, Вы устанавливаете размер для stringName в один из 7 определённых размеров. Если size специфицируется как строка, такая как "-2", Вы настраиваете размер шрифта строки stringName относительно размера, установленного в тэге BASEFONT.



Описание


Этот метод возвращает строку, а не String-объект.

Поскольку fromCharCode это static-метод объекта String, Вы всегда записываете его String.fromCharCode(), а не как метод созданного Вами String-объекта.



Описание


Символы в строке индексируются слева направо. Индекс первого символа равен 0, а индекс последнего символа строки stringName равен stringName.length - 1.

"Blue Whale".indexOf("Blue") // возвращает 0
"Blue Whale".indexOf("Blute")   // возвращает -1
"Blue Whale".indexOf("Whale",0) // возвращает 5
"Blue Whale".indexOf("Whale",5) // возвращает 5
"Blue Whale".indexOf("",9)      // возвращает 9
"Blue Whale".indexOf("",10)     // возвращает 10
"Blue Whale".indexOf("",11)     // возвращает 10

Метод indexOf учитывает регистр. Например, следующее выражение возвращает -1:

"Blue Whale".indexOf("blue")



Описание


Используйте метод italics вместе с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте функцию write для отображения строки.



Описание


Символы в строке индексируются слева направо. Индекс первого символа равен 0, а индекс последнего символа равен stringName.length - 1.

"canal".lastIndexOf("a") // возвращает 3
"canal".lastIndexOf("a",2) // возвращает 1
"canal".lastIndexOf("a",0) // возвращает -1
"canal".lastIndexOf("x")   // возвращает -1

Метод lastIndexOf учитывает регистр символов. Например, следующее выражение возвратит -1:

"Blue Whale, Killer Whale".lastIndexOf("blue")



Описание


Для null-строки длина будет равна 0.



Описание


Используйте метод link для программного создания гиперссылки и последующего вызова write или writeln для отображения ссылки в документе. В серверном JavaScript используйте функцию write для отображения ссылки.

Ссылки, созданные методом link, становятся элементами массива links объекта document. См. document.links.



Описание


Если Вам нужно выполнить глобальный поиск совпадения или поиск с учётом регистра, включите в регулярное выражение флаги g (для глобального поиска) и i (для игнорирования регистра). Эти флаги могут использоваться вместе или по отдельности. Следующие два пример показывают, как использовать эти флаги вместе с match.

ПРИМЕЧАНИЕ: Если Вы выполняете поиск только для того, чтобы найти true или false, используйте String.search или метод test регулярного выражения.



Описание


Этот метод не изменяет String-объект, которым он вызывается; он просто возвращает новую строку.

Если Вы хотите выполнить глобальный поиск и замену или поиск без учёта регистра, включите флаги g (для глобального поиска) и i (игнорирование регистра) в регулярное выражение. Они могут быть включены вместе и отдельно. Следующие два примера показывают использование этих флагов вместе с replace.

Специфицирование функции в качестве параметра. Если Вы специфицируете функцию в качестве второго параметра, она вызывается после выполнения поиска совпадения. (Такое использование функции часто называется "лямбда-выражение".)

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

Вложенная функция может использовать совпавшие подстроки для определения новой строки (newSubStr), которая замещает найденную подстроку. Вы получаете совпавшие подстроки через параметры Вашей функции. Первый параметр Вашей функции содержит полностью совпавшую подстроку. Другие параметры могут использоваться для совпадений в скобках, для запоминания подсовпадений строк. Например, следующий метод replaceвозвращает XX.zzzz - XX , zzzz.

"XXzzzz".replace(/(X*)(z*)/,
function (str, p1, p2) {
                      return str + " - " + p1 + " , " + p2;
                   }
                )

Массив, возвращённый из метода exec RegExp-объекта и последующего совпадения доступен для Вашей функции. Вы можете использовать содержимое массива плюс свойства input и index (индекс совпадения в строке ввода) этого массива для выполнения дополнительных задач, перед тем как метод заменит подстроку.



Описание


При успешном выполнении, search возвращает индекс регулярного выражения в строке. Иначе возвращает -1.

Если Вы хотите знать, найден ли патэрн в строке, используйте search (аналогично методу test регулярного выражения); для получения большей информации (и более медленного выполнения) используйте match (аналогичный методу exec регулярного выражения).



Описание


slice извлекает текст из первой строки и возвращает новую строку. Изменения в одной строке не влияют на другую строку.

slice извлекает до endSlice не включительно.
string.slice(1,4) извлекает символы со второго по четвёртый (символы с индексами 1, 2 и 3).

Как отрицательный индекс endSlice указывает смещение от конца строки, не входящее в результат.
string.slice(2,-1) извлекает символы с третьего до конца строки.



Описание


Используйте метод small вместе с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте функцию write для отображения строки.



Описание


Метод split возвращает новый массив.

Если найден, separator удаляется из подстрок, возвращённых в массиве. Если separator опущен, массив содержит один элемент - всю строку целиком.

В JavaScript 1.2 split имеет следующие дополнения:

Он может принимать в качестве аргумента регулярное выражение, а также фиксированную строку, которой разделяется строка-объект. Если separator это регулярное выражение, любые включённые скобки вызывают включение подсовпадений в возвращаемый массив. Он может принимать limit-счётчик, поэтому результирующий массив не включает ведомые пустые элементы. Если LANGUAGE="JavaScript1.2" специфицирован в тэге SCRIPT, string.split(" ") делит при любом появлении 1 или более пробельных символов, включая space/пробел, tab\табуляцию, line feed/прогон строки и возврат каретки. Для этого LANGUAGE="JavaScript1.2" обязан быть специфицирован в тэге <SCRIPT>.



Описание


Используйте метод strike вместе с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте функцию write для отображения строки.



Описание


Используйте метод sub вместе с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте функцию write для генерации HTML.



Описание


start это индекс символа. Индекс первого символа равен 0, а индекс последнего символа меньше на 1, чем длина строки. substr начинает извлечение символов от start и извлекает length-количество символов.

Если start - положительное число, равное длине строки или более, substr не возвращает символов.

Если start - отрицательное число, substr использует его как индекс символа. начиная от конца строки.
Если start - отрицательное число и abs(start) больше длины строки, substr использует 0 как start-индекс.

Если length равна 0 или отрицательная, substr не возвращает символов.
Если значение length опущено, start извлекает символы до конца строки.



Описание


substring извлекает символы от indexA до indexB не включительно. Точнее:

Если indexA меньше 0, indexA рассматривается так, как если бы он был 0. Если indexB больше stringName.length, indexB рассматривается так, как если бы это было stringName.length. Если indexA равен indexB, substring возвращает пустую строку. Если indexB опущен, indexA извлекает символы до конца строки.

В JavaScript 1.2, используя LANGUAGE="JavaScript1.2" в тэге SCRIPT:

Если indexA больше indexB, JavaScript выдаёт ошибку времени выполнения (out of memory).

В JavaScript 1.2 без LANGUAGE="JavaScript1.2" в тэге SCRIPT:

Если indexA больше indexB, JavaScript возвращает подстроку, начинающуюся с indexB и заканчивающуюся на indexA - 1.



Описание


Используйте метод sup вместе с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте функцию write для генерации HTML.



Описание


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



Описание


Метод toSource возвращает следующие значения:

Для встроенного объекта String - метод toSource возвращает следующую строку, указывающую, что исходный код недоступен:function String() {
      [native code]
   } Для экземпляров объекта String или строковых литералов - метод toSource возвращает строку, представляющую исходный код.

Этот метод обычно вызывается внутренне в JavaScript, а не явно в коде.



Описание


Объект String переопределяет метод toString объекта Object; он не наследует Object.toString. Для String-объектов метод toString возвращает строку, представляющую объект.



Описание


Метод toUpperCase возвращает значение строки, конвертированное в верхний регистр. toUpperCase не влияет на значение самой строки.



Описание


Метод valueOf объекта String возвращает примитивное значение String-объекта как тип данных string. Это значение эквивалентно String.toString.

Этот метод обычно вызывается внутренне в JavaScript, а не явно в коде.



Описание


Объект Style даёт возможность динамически реализовать таблицы стилей HTML в JavaScript. Методы и свойства объекта Style реализуют свойства каскадных таблиц стилей HTML в JavaScript.

Полное описание таблиц стилей см. в книге Dynamic HTML in Netscape Communicator.



Описание


Метод borderWidths является удобной аббревиатурой для установки свойств ширины всех линий рамки одновременно.



Описание


Метод margins является удобной аббревиатурой для установки одновременной всех полей.



Описание


Метод paddings является удобной аббревиатурой для установки одновременной всех свойств заполнения/padding.



Описание


Объект Submit на форме выглядит так:

Объект Submit является элементом формы и обязан быть определён в тэге FORM.

Щелчок по кнопке submit отправляет форму по URL, специфицированному в свойстве action формы. Эта акция всегда загружает клиенту новую страницу; это может быть та же страница, что и текущая, если action это специфицирует или если не специфицирует.

Обработчик onClick кнопки submit не может предотвратить отправку формы; используйте вместо этого обработчика обработчик onSubmit или метод submit вместо объекта Submit. См. примеры для объекта Form.



Описание


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



Описание


Свойство name первоначально отражает значение атрибута NAME. Изменение свойства name переопределяет значение атрибута.

Не путайте свойство name с текстом, отображаемым на поверхности Submit-кнопки. Свойство value специфицирует текст на кнопке. Свойство name не выводится на экран; оно используется для программного обращения к кнопке.

Если несколько объектов на одной форме имеют одинаковые значения атрибута NAME, автоматически создаётся массив с данным именем. Каждый элемент этого массива представляет отдельный Form-объект. Элементы индексируются в порядке расположения в исходном коде, начиная с 0. Например, если два элемента Text и элемент Submit на одной форме имеют в своих атрибутах NAME значение "myField", создаётся массив из элементов myField[0], myField[1] и myField[2]. Вы должны знать о такой ситуации в Вашем коде и знать, ссылается ли myField на единственный элемент или на массив элементов.



Описание


Если атрибут VALUE специфицируется в HTML, свойство value будет содержать эту же строку, и она будет отображаться на поверхности кнопки. Если атрибут VALUE не специфицируется в HTML, свойство value кнопки будет иметь значение "Submit Query".

Не путайте свойство value со свойством name. Свойство name не отображается на экране; оно используется для программного обращения к кнопке.



Описание


Text-объект на форме выглядит так:

Text-объект это элемент формы и он обязан быть определён в тэге FORM.

Text-объекты могут быть обновлены (перерисованы) динамически через установку свойства value /(this.value).



Описание


Начальное значение defaultValue отражает значение атрибута VALUE. Установка defaultValue программно переопределяет начальную установку.

Вы можете установить свойство defaultValue в любое время. Вид соответствующего объекта не обновляется при установке свойства defaultValue, это происходит только при установке свойства value.



Описание


Метод focus используется для перехода к текстовому полю и для передачи ему фокуса ввода. Вы можете затем программно ввести значение в это поле или дать возможность пользователю сделать это. Если этот метод используется без метода select, курсор позиционируется в начале поля.



Описание


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



Описание


Свойство name первоначально отражает значение атрибута NAME. Изменение свойства name переопределяет это значение. Свойство name не выводится на экран; оно используется для программного обращения к объекту.

Если несколько объектов на одной форме имеют одинаковые значения своих атрибутов NAME, автоматически создаётся массив с этим именем. Каждый элемент массива представляет отдельный объект Form. Элементы индексируются в порядке расположения в коде, начиная с 0. Например, если два элемента Text и элемент Textarea на одной форме имеют в своих атрибутах NAME значение "myField", создаётся массив из элементов myField[0], myField[1] и myField[2]. Вы должны знать о возможности возникновения такой ситуации в Вашем коде и знать, ссылается myField на единственный элемент или на массив элементов.



Описание


Используйте метод select для выделения области ввода текстового поля. Можно использовать метод select вместе с методом focus для выделения поля и позиционирования в нём курсора. Это даст пользователю возможность быстро заменить весь текст поля.



Описание


Свойство value это строка. первоначально отражающая значение атрибута VALUE. Эта строка выводится в текстовом поле. Значение этого свойства изменяется, если пользователь или программа модифицируют это поле.

Вы можете установить свойство value в любое время. Вид Text-объекта обновляется сразу после установки свойства value.



Описание


Объект Textarea на форме выглядит так:

Объект Textarea это элемент формы, который обязан быть определён в тэге FORM.

Textarea-объекты могут обновляться (перерисовываться) динамически через установку свойства value/(this.value).

Для перехода на новую строку в Textarea-объекте Вы можете использовать символ новой строки. Хотя этот символ отличается для разных платформ (на Unix это \n, на Windows это \r, на Macintosh это \n), JavaScript проверяет все символы новой строки перед установкой строки-значения свойства и трансляцией его для конкретной платформы. Можно вводить символы новой строки программно -- один из способов это проверить свойство navigator.appVersion для определения текущей платформы, затем установить соответствующий символ новой строки. См. примеры в navigator.appVersion.



Описание


Начальное значение defaultValue отражает значение, специфицированное между начальным и конечным тэгами TEXTAREA. Установка свойства defaultValue программно переопределяет начальное значение.

Вы можете установить свойство defaultValue в любое время. Вид объекта не обновляется при установке свойства defaultValue, это делается только при установке свойства value.



Описание


Метод focus используется для перехода к полю textarea и передачи ему фокуса. Затем можно программно ввести значение поля или дать пользователю возможность сделать это. Если Вы используете этот метод без метода select, курсор позиционируется в начале поля.



Описание


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



Описание


Свойство name первоначально отражает значение атрибута NAME. Изменение свойства name переопределяет это значение. Свойство name не выводится на экран; оно используется для программного обращения к объекту.

Если несколько объектов на одной форме имеют одно значение атрибута NAME, автоматически создаётся массив с данным именем. Каждый элемент массива представляет отдельный объект Form. Элементы индексируются в порядке появления в коде, начиная с 0. Например, если два элемента Text и элемент Textarea на одной форме имеют в атрибуте NAME значение "myField", создаётся массив из элементов myField[0], myField[1] и myField[2]. Вы должны знать о возможности возникновения такой ситуации в Вашем коде и знать, ссылается myField на единственный элемент или на массив элементов.



Описание


Используйте метод select для выделения области ввода поля textarea. Вы можете использовать метод select вместе с методом focus для выделения поля и позиционирования в нём курсора. Это облегчает замену всего текста поля.



Описание


Эта строка отображается в поле textarea. Значение этого свойства изменяется, если пользователь программы изменяет текст поля.

Вы можете установить свойство value в любое время. Вид Textarea-объекта обновляется сразу после установки Вами значения свойства value.



Описание


Объект 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, не будет загружен в него.



Описание


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

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

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



Описание


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

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



Описание


Вызов метода 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().



Описание


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



Описание


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

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



Описание


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

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

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



Описание


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

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



Описание


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

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

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



Описание


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



Описание


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



Описание


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

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

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



Описание


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

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



Описание


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

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



Описание


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



Описание


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

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



Описание


Этот метод выполняет такое же действие, что нажатие кнопки 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().



Описание


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



Описание


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



Описание


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



Описание


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



Описание


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



Описание


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



Описание


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



Описание


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



Описание


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



Описание


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



Описание


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



Описание


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



Описание


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

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



Описание


В обработчиках событий Вы обязаны специфицировать 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 останется, даже если он реально уже не нужен.



Описание


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

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

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

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

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



Описание


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



Описание


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



Описание


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



Описание


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



Описание


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

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

parent.frameName
parent.frames[index]

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

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

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

<object nameAttribute>

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



Описание


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



Описание


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

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

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



Описание


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



Описание


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



Описание


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



Описание


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

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



Описание


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



Описание


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



Описание


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

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



Описание


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

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



Описание


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

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

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

<object nameAttribute>

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