Интерфейс Event

public interface Event

Интерфейс Event используется для предоставления контекстной информации об событии обработчику, обрабатывающему это событие. Объект, реализующий интерфейс Event, обычно передается в качестве первого параметра обработчику события. Более подробная контекстная информация передается обработчикам событий путём получения дополнительных интерфейсов от Event, которые содержат информацию, непосредственно связанную с типом события, которое они сопровождают. Эти производные интерфейсы также реализуются объектом, переданным обработчику события.

См. также Спецификацию событий Document Object Model (DOM) уровня 2.

Поля

CAPTURING_PHASE

static final short CAPTURING_PHASE

Текущая фаза события — фаза захвата.

См. также:

Значения постоянных полей

AT_TARGET

static final short AT_TARGET

Событие в настоящее время оценивается на целевом EventTarget.

См. также:

Значения постоянных полей

BUBBLING_PHASE

static final short BUBBLING_PHASE

Текущая фаза события — фаза распространения.

См. также:

Значения постоянных полей

Методы

getType

String getType()

Имя события (регистр не учитывается). Имя должно быть именем XML.

getTarget

EventTarget getTarget()

Используется для указания EventTarget которому первоначально было отправлено событие.

getCurrentTarget

EventTarget getCurrentTarget()

Используется для указания EventTarget чьи EventListeners в настоящее время обрабатываются. Это особенно полезно при обработке захвата и распространения.

getEventPhase

short getEventPhase()

Используется для указания какой фазы потока события в настоящее время оценивается.

getBubbles

boolean getBubbles()

Используется для указания является ли событие событием распространения. Если событие может распространяться, значение равно true, в противном случае значение равно false.

getCancelable

boolean getCancelable()

Используется для указания может ли быть предотвращено действие по умолчанию события. Если действие по умолчанию может быть предотвращено, значение равно true, в противном случае значение равно false.

getTimeStamp

long getTimeStamp()

Используется для указания времени (в миллисекундах относительно эпохи) создания события. Ввиду того, что некоторые системы могут не предоставлять эту информацию, значение timeStamp может быть недоступно для всех событий. В случае отсутствия значения возвращается 0. Примерами эпохи времени являются время запуска системы или 0:0:0 UTC 1 января 1970 года.

stopPropagation

void stopPropagation()

Метод stopPropagation используется для предотвращения дальнейшего распространения события во время потока события. Если этот метод вызывается любым EventListener, событие прекращает распространение по дереву. Событие завершит отправку всем слушателям в текущем EventTarget перед остановкой потока события. Этот метод может быть использован на любой стадии потока события.

preventDefault

void preventDefault()

Если событие может быть отменено, метод preventDefault используется для обозначения того, что событие должно быть отменено, что означает, что любое действие по умолчанию, обычно выполняемое реализацией в результате события, не произойдёт. Если на любой стадии потока события вызывается метод preventDefault, событие отменяется. Любое действие по умолчанию, связанное с событием, не произойдёт. Вызов этого метода для неотменяемого события не оказывает никакого эффекта. После вызова preventDefault он остаётся в силе в течение остальной части распространения события. Этот метод может быть использован на любой стадии потока события.

initEvent

void initEvent(String eventTypeArg,
               boolean canBubbleArg,
               boolean cancelableArg)

Метод initEvent используется для инициализации значения Event созданного через интерфейс DocumentEvent . Этот метод может быть вызван только до того, как событие было отправлено через метод dispatchEvent, хотя он может быть вызван несколько раз в этой фазе, если необходимо. Если вызывается несколько раз, приоритет имеет последнее вызывание. Если вызван из подкласса интерфейса Event, только значения, указанные в методе initEvent, изменяются, все остальные атрибуты остаются неизменными.

Параметры:

eventTypeArg - Указывает тип события. Этот тип может быть любым типом события, определённым в этой спецификации, или новым типом события. Строка должна быть именем XML. Любой новый тип события не должен начинаться с любой прописной, строчной или смешанной версии строки "DOM". Этот префикс зарезервирован для будущих наборов событий DOM. Также настоятельно рекомендуется, чтобы третьи стороны, добавляющие свои события, использовали свой собственный префикс, чтобы избежать путаницы и уменьшить вероятность конфликтов с другими новыми событиями.

canBubbleArg - Указывает может ли событие распространяться.

cancelableArg - Указывает может ли быть предотвращено действие по умолчанию события.