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

         

Описание


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

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



Описание


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

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



Описание


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

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



Описание




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

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



Описание


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

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

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



Описание


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

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



Описание


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



Описание


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

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

<object objectReference>

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



Описание


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

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

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

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

<object nameAttribute>

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



Описание эта строка отображается...


Эта функция вычисляет значение свойства value группы кнопок и выводит его в окне msgWindow:

function valueGetter() {
var msgWindow=window.open("")
   msgWindow.document.write("submitButton.value is " +
      document.valueTest.submitButton.value + "<BR>")
   msgWindow.document.write("resetButton.value is " +
      document.valueTest.resetButton.value + "<BR>")
   msgWindow.document.write("helpButton.value is " +
      document.valueTest.helpButton.value + "<BR>")
   msgWindow.document.close()
}

Будут выведены следующие значения:

Query Submit
Reset
Help

В предыдущем примере предполагается, что кнопки были определены так:

<INPUT TYPE="submit" NAME="submitButton">
<INPUT TYPE="reset" NAME="resetButton">
<INPUT TYPE="button" NAME="helpButton" VALUE="Help">



Option


Опция в списке выбора.

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

Реализован в

JavaScript 1.0

JavaScript 1.1: добавлено свойство defaultSelected; в свойство text добавлена возможность изменять текст опции.



Options


Массив, соответствующий опциям Select-объекта в порядке их появления в исходном коде.

Свойство из Select

Только для чтения
Реализовано вJavaScript 1.0



Outerheight


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

Свойство из window

Реализовано вJavaScript 1.2



Outerwidth


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

Свойство из window

Реализовано вJavaScript 1.2



Packages


Объект верхнего уровня, используемый для доступа к Java-классам из кода JavaScript.

Объект ядра

Реализован в

JavaScript 1.1, NES 2.0



Paddingbottom


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

Свойство из Style

Реализовано вJavaScript 1.2



Paddingleft


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

Свойство из Style

Реализовано вJavaScript 1.2



Paddingright


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

Свойство из Style

Реализовано вJavaScript 1.2



Paddings


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

Метод из Style

Реализован вJavaScript 1.2



Paddingtop


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

Свойство из Style

Реализовано вJavaScript 1.2



Pagex


Число, специфицирующее горизонтальную позицию курсора в пикселах относительно страницы.

Свойство из event

Реализовано вJavaScript 1.2



Pagex


Позиция слоя в пикселах по горизонтали относительно страницы.

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



Pagexoffset


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

Свойство из window

Только для чтения
Реализовано вJavaScript 1.2



Pagey


Число, специфицирующее вертикальную позицию курсора в пикселах относительно страницы.

Свойство из event

Реализовано вJavaScript 1.2



Pagey


Позиция слоя в пикселах по вертикали относительно страницы.

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



Pageyoffset


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

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



Параметр


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



Параметр


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



Параметр


parameterList

Необязательный список параметров, специфицированный конструктором в Java-классе.



Параметр


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



Параметр


aLayerСлой, поверх которого помещается текущий слой.



Параметр


aLayerСлой, ниже которого помещается текущий слой.



Параметр


eventType Тип захватываемого события.



Параметр


eventПередаваемое событие.



Параметр


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



Параметр


forceGet Если вы задаёте значение true, форсирует безусловный HTTP GET документа с сервера. Он не должен использоваться, пока Вы не убедитесь, что кэши диска и памяти не исчерпаны и не нарушены или что сервер не имеет новую версию документа (например, если он генерируется с помощью CGI при каждом запросе).



Параметр


URL Строка, специфицирующая URL для загрузки.



Параметр


value Числовое значение создаваемого объекта.



Параметр


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



Параметр


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



Параметр


string Любая строка.



Параметр


nameAttribute Строка.



Параметр


index Целое число в диапазоне от 0 до числа, меньшего длины строки на 1.



Параметр


index Целое число в диапазоне от 0 до числа, меньшего длины строки на 1. По умолчанию имеет значение 0.



Параметр


color Строка, выражающая цвет как 16-ричный RGB-триплет или как строковой литерал. Строковые литералы - названия цветов перечислены в книге Клиентский JavaScript. Руководство.



Параметр


size Целое число в диапазоне от 1 до 7; строка, представляющая целое число со знаком в диапазоне от 1 до 7.



Параметр


num1, ..., numN Последовательность чисел, которые являются Unicode-значениями.



Параметр


hrefAttribute Любая строка, специфицирующая атрибут HREF тэга A; это должен быть правильный URL (относительный или абсолютный).



Параметр


regexp Имя регулярного выражения. Это может быть имя переменной или литерал.



Параметр


regexp Имя регулярного выражения. Это может быть имя переменной или литерал.



Параметр


styleObject Объект Style.

Не путайте align с textAlign, который специфицирует выравнивание содержимого текстовых элементов.

Свойство align является отражением свойства float каскадных таблиц стилей.



Параметр


styleObject A Style object.

Свойство clear является отражением свойства clear каскадных таблиц стилей.



Параметр


styleObject A Style object.

Свойство whiteSpace является отражением свойства white-space каскадных таблиц стилей.



Параметр


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



Параметр


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



Параметр


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



Параметр


message Строка.



Параметр


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



Параметр


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



Параметр


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



Параметр


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



Параметр


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



Параметр


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



Параметр


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



Параметр


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



Параметр


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



Параметр


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

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



Параметр


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

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



Параметр


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

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



Параметры


arrayLengthНачальный размер массива. Вы можете получить доступ к этому значению через свойство length. Если специфицировано не-число, создаётся массив размером length 1 с первым элементом, имеющим специфицированное значение.
Максимальный допустимый размер массива 4,294,967,295.
elementN Список значений элементов массива. Если специфицирована эта форма, массив инициализируется специфицированными значениями как элементами массива, а свойство length содержит количество аргументов.



Параметры


arrayName2...
arrayNameN
Массивы, объединяемые в данный массив.



Параметры


element1, ...,
elementN
Элементы, добавляемые в конец массива.



Параметры


beginИндекс с базой 0, начиная с которого выполняется извлечение.

endИндекс с базой 0, с которого извлечение прекращается:

slice извлекает элементы до end, не включительно. slice(1,4) извлекает элементы со второго по четвёртый (элементы с индексами 1, 2 и 3) Если задан отрицательный индекс, end указывает смещение от конца массива. slice(2,-1) извлекает элементы с третьего и до последнего. Если end отсутствует, slice извлекает до конца последовательности.



Параметры


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



Параметры


indexИндекс начала изменения массива.

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

element1, ...,
elementN
Элементы, добавляемые к массиву. Если Вы не специфицируете элементы, splice просто удаляет элементы из массива.



Параметры


element1,...,
elementN
Элементы, добавляемые в начало массива.



Параметры


valueНачальное значение объекта Boolean. Значение конвертируется в boolean, если необходимо. Если значение опущено или равно 0, -0, null, false, NaN, undefined, или это пустая строка (""), объект имеет начальное значение false. Все другие значения, включая любой объект или строку "false", создают объект с начальным значением true.



Параметры


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



Параметры


milliseconds Целочисленное значение - количество миллисекунд после даты 1 января 1970 года, 00:00:00.

dateString Строковое значение - дата. Строка должна иметь формат, распознаваемый методом Date.parse.
yr_num, mo_num,
day_num
Целочисленные значения, представляющие части даты. Месяц это числа от 0 до 11, 0=January, 11=December.

hr_num, min_num,
sec_num, ms_num
Целочисленное значение - часть даты.



Параметры


yearValue Целое число - год, например, 1995.
monthValue Целое число от 0 до 11 - месяц от January до December.

dayValueЦелое число от 1 до 31 день/число месяца. Если Вы специфицируете параметр dayValue, Вы обязаны также специфицировать и monthValue.



Параметры


hoursValueЦелое число от 0 до 23 - час.

minutesValue Целое число от 0 до 59 - минуты.
secondsValue Целое число от 0 до 59 - секунды. Если Вы специфицируете параметр secondsValue, Вы обязаны также специфицировать и minutesValue.
msValue Число от 0 до 999 - миллисекунды. Если вы специфицируете параметр msValue, Вы обязаны также специфицировать minutesValue и secondsValue.



Параметры


minutesValueЦелое число от 0 до 59 - минуты.

secondsValueЦелое число от 0 до 59 - секунды. Если Вы специфицировали параметр secondsValue, Вы обязаны также специфицировать и minutesValue.
msValue Число от 0 до 999 - миллисекунды. Если вы специфицировали параметр msValue, Вы обязаны также специфицировать minutesValue и secondsValue.



Параметры


monthValue Целое число от 0 до 11 (месяцы с January до December).

dayValue Целое число от 1 до 31 - день/число месяца.



Параметры


secondsValue Целое от 0 до 59.
msValue Число от 0 до 999 - миллисекунды.



Параметры


yearValue Целое число, специфицирующее числовое значение года, например, 1995.
monthValue Целое число от 0 до 11 - месяцы от January до December.

dayValueЦелое число от 1 до 31 день/число месяца. Если Вы специфицировали параметр dayValue, Вы обязаны также специфицировать monthValue.



Параметры


hoursValueЦелое число от 0 до 23 - час.

minutesValueЦелое число от 0 до 59 - минуты.

secondsValueЦелое число от 0 до 59 - секунды. Если Вы специфицировали secondsValue, Вы обязаны также специфицировать minutesValue.
msValue Число от 0 до 999 - миллисекунды. Если Вы специфицировали параметр msValue, Вы обязаны также специфицировать minutesValue и secondsValue.



Параметры


minutesValueЦелое число от 0 до 59 - минуты.

secondsValueЦелое число от 0 до 59 - секунды. Если Вы специфицировали secondsValue, Вы обязаны также специфицировать minutesValue.
msValue Число от 0 до 999 - миллисекунды. Если Вы специфицировали параметр msValue, Вы обязаны также специфицировать minutesValue и secondsValue.



Параметры


monthValue Целое число от 0 до 11 - месяц от January до December.
dayValue Целое число от 1 до 31 - день/число месяца.



Параметры


secondsValueЦелое число от 0 до 59.

msValue Число от 0 до 999 - миллисекунды.



Параметры


yearГод после 1900.

month Целое число от 0 до 11 - месяц.
date Целое число от 1 до 31 - день/число месяца.

hrs Целое число от 0 до 23 - час.
min Целое число от 0 до 59 - минуты.
sec Целое число от 0 до 59 - секунды.
ms Целое число от 0 до 999 - миллисекунды.



Параметры


eventType

Тип отлавливаемых событий. Допустимые типы перечислены в описании объекта event.



Параметры


classNameЗначение с учётом регистра символов - атрибут CLASS тэга HTML, специфицированного в tagName..

tagNameЗначение без учёта регистра - имя HTML-тэга, такое как H1 или BLOCKQUOTE. Если значением tagName является all, tagName  ссылается на все тэги HTML.



Параметры


context1, ...[contextN]> Объекты Style, описанные свойствами document.classes или document.tags, которые устанавливают контекст для объекта Style.

affectedStyle Объект Style, стилевые свойства которого Вы хотите изменить.



Параметры


mimeType Строка, специфицирующая тип документа, в который Вы записываете. Если Вы не специфицировали mimeType, по умолчанию он будет text/html.

replace Строка "replace". Если Вы предоставили этот параметр, mimeType обязан быть "text/html". Вызывает использование новым документом вхождения из history, использованного предыдущим документом.



Параметры


tagName

Нечувствительное у регистру имя любого тэга HTML, такого как H1 или BLOCKQUOTE.



Параметры


arg1, arg2, ... argN Имена, используемые функцией в качестве имён формальных аргументов. Каждое имя обязано быть строкой, соответствующей верному JavaScript-идентификатору; например, "x" или "theValue".
functionBody Строка операторов JavaScript, образующих определение функции.

nameИмя функции.

param Имя аргумента, передаваемого функции. Функция может иметь до 255 аргументов.

statements Операторы, образующие тело функции.



Параметры


thisArg Параметр для вызывающего объекта.

argArrayМассив аргументов для объекта.



Параметры


thisArgПараметр для вызывающего объекта.

arg1, arg2, ...Аргументы для объекта.



Параметры


deltaЦелое число - относительная позиция в списке history.

locationСтрока, представляющая все или часть URL из списка history.



Параметры


width Ширина изображения в пикселах.

height Высота изображения в пикселах.



Параметры


eventType Тип захватываемых событий. Допустимые типы событий перечислены в книге Клиентский JavaScript. Руководство.



Параметры


sourcestring Строка - имя внешнего файла.
width Ширина слоя в пикселах.