JavaScript. Подробное руководство, 6-е издание

Предлагаемые к реализации свойства

Свойства, перечисленные ниже, предлагаются проектом спецификации «DOM Level 3 Events». Они должны решить основные проблемы несовместимости между броузерами, но пока (на момент написания этих слов) не реализованы ни в одном из броузеров. Если они будут реализованы совместимым способом, это существенно упростит создание переносимого программного кода для обработки событий ввода текста, нажатий клавиш и событий мыши.

  readonly unsigned short buttons

Напоминает свойство button, поддерживаемое в модели событий ІE и описанное выше.

  readonly string char

Для событий клавиатуры это свойство хранит строку символов (т. е. может содержать более одного символа), сгенерированную событием.

  readonly string data

Для событий «textinput» определяет введенный текст.

  readonly unsigned long deltaMode

Для событий колесика мыши это свойство определяет соответствующую интерпретацию свойств deltaX, deltaY и deltaZ. Значением этого свойства может быть одна из констант: DOM_DELTA_PIXEL, DOM_DELTA_LINE, DOM_DELTA_PAGE. Конкретное значение определяется платформой и может зависеть от настроек системы или от факта удерживания нажатыми клавиш-модификаторов во время возникновения события колесика мыши.

  readonly long deltaX, deltaY, deltaZ

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

  readonly unsigned long inputMethod

Для событий «textinput» это свойство определяет способ ввода текста. Значением этого свойства может быть одна из констант: DOM_INPUT_METHOD_UNKNOWN, D0M_INPUT_ METHOD_KEYBOARD, DOM_INPUT_METHOD_PASTE, D0M_INPUT_METH0D_DR0P, DOM_INPUT_METHOD_IME, D0M_INPUT_METH0D_0PTI0N, DOM_INPUT_METHOD_HANDWRITING, DOM_INPUT_METHOD_VOICE, D0M_ INPUT_METHOD_MULTIMODAL, DOM_INPUT_METHOD_SCRIPT.

  readonly string key

Для событий клавиатуры, генерирующих символы, это свойство получает то же значение, что и свойство char. Для событий клавиатуры, не генерирующих символы, это свойство содержит имя нажатой клавиши (такое как, «Tab» или «Down»).

  readonly string locale

Для событий клавиатуры и событий «textinput» это свойство определяет код языка (например, «еn-GB»), идентифицирующий выбранную раскладку клавиатуры, если эта информация доступна.

  readonly unsigned long location

Для событий клавиатуры это свойство определяет местоположение нажатой клавиши. Значением этого свойства может быть одна из констант: D0M_KEY_LOCATION_ STANDARD, D0M_KEY_LOATION_LEFT, DOM_KEY_LOCATION_RIGHT, DOM_KEY_LOCATION_NUMPAD, D0M_ KEY_LOCATION_M0BILE, D0M_KEY_LOCATION_JOYSTICK.

  readonly boolean repeat

Для событий клавиатуры это свойство будет иметь значение true, если событие вызвано длительным удержанием клавиши в нажатом состоянии, вызвавшем автоповтор ввода.

Предлагаемые к реализации методы

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

  boolean getModifierState(string modifier)

Для событий мыши и клавиатуры этот метод возвращает true, если в момент возбуждения события удерживалась нажатой указанная клавиша-модификатор modifier, и false - в противном случае. Значением аргумента modifier может быть одна из строк: «Alt», «AltGraph», «CapsLock», «Control», «Fn», «Meta», «NumLock», «Scroll», «Shift», «SymbolLock» и «Win».

EventSource

Comet-соединение c HTTP-сервером (EventTarget)

Объект EventSource представляет долгоживущее HTTP-соединение, посредством которого веб-сервер может отправлять клиенту текстовые сообщения. Чтобы использовать события, определяемые стандартом «Server-Sent Events», следует передать URL-адрес сервера конструктору EventSourсе и затем зарегистрировать обработчик события «message» в полученном объекте EventSource.

Спецификация «Server-Sent Events» появилась совсем недавно и на момент написания этих строк поддерживалась не во всех броузерах.

Конструктор

  new EventSource(string url)

Создает новый объект EventSource, подключенный к веб-серверу, определяемому аргументом url. Адрес url интерпретируется относительно URL-адреса документа.

Константы

Следующие константы определяют допустимые значения свойства readyState.

  unsigned short CONNECTING = 0

Идет установка соединения, или соединение было закрыто и объект EventSource пытается восстановить его.

  unsigned short OPEN = 1

Соединение установлено и готово к приему событий.

  unsigned short CLOSED = 2

Соединение было закрыто либо вызовом метода close, либо в результате фатальной ошибки, не позволяющей восстановить его.

Свойства

  readonly unsigned short readyState

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

  readonly string url

Абсолютный URL-адрес, к которому подключен объект EventSource.

Методы

  void close

Закрывает соединение. После вызова этого метода объект EventSource не может больше использоваться. Если потребуется вновь установить соединение, следует создать новый объект EventSource.