Интерфейс Event
- Все известные подинтерфейсы:
-
LSLoadEvent,LSProgressEvent,MouseEvent,MutationEvent,UIEvent
public interface Event
Интерфейс
Event используется для предоставления контекстной информации об событии обработчику, обрабатывающему это событие. Объект, реализующий интерфейс Event, обычно передаётся в качестве первого параметра обработчику событий. Более специфичная контекстная информация передаётся обработчикам событий путём вывода дополнительных интерфейсов из Event, которые содержат информацию, напрямую связанную с типом события, которое они сопровождают. Эти производные интерфейсы также реализуются объектом, переданным слушателю события. См. также Спецификацию событий Document Object Model (DOM) уровня 2.
- С момента:
- 1.5, DOM Level 2
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final short |
AT_TARGET |
Событие в настоящее время оценивается на целевом EventTarget. |
static final short |
BUBBLING_PHASE |
Текущая фаза события — фаза всплытия. |
static final short |
CAPTURING_PHASE |
Текущая фаза события — фаза захвата. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
getBubbles() |
Используется для указания, является ли событие событием всплытия. |
boolean |
getCancelable() |
Используется для указания, может ли быть предотвращено действие по умолчанию события. |
EventTarget |
getCurrentTarget() |
Используется для указания EventTarget, чьи EventListeners в настоящее время обрабатываются. |
short |
getEventPhase() |
Используется для указания текущей фазы потока событий. |
EventTarget |
getTarget() |
Используется для указания EventTarget которому изначально было разослано событие. |
long |
getTimeStamp() |
Используется для указания времени (в миллисекундах относительно эпохи), когда событие было создано. |
String |
getType() |
Название события (регистронезависимое). |
void |
initEvent |
Метод initEvent используется для инициализации значения Event созданного через интерфейс DocumentEvent. |
void |
preventDefault() |
Если событие может быть отменено, метод preventDefault используется для обозначения того, что событие должно быть отменено, что означает, что любое действие по умолчанию, обычно выполняемое реализацией в результате события, не произойдёт. |
void |
stopPropagation() |
Метод stopPropagation используется для предотвращения дальнейшего распространения события во время потока событий. |
Подробное описание полей
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. Примеры эпохи — время запуска системы или 00:00:00 по 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. Этот метод может быть вызван только до того, как событие было разослано через метод Event, хотя он может быть вызван несколько раз на этой фазе, если это необходимо. Если вызывается несколько раз, приоритет имеет последнее обращение. Если вызывается из подкласса интерфейса Event, только значения, указанные в методе initEvent, изменяются, все остальные атрибуты остаются неизменными.- Параметры:
-
eventTypeArg- Указывает тип события. Этот тип может быть любым типом события, определенным в данной спецификации, или новым типом события. Строка должна быть именем XML. Любой новый тип события не должен начинаться с какой-либо заглавной, строчной или смешанной версии строки "DOM". Этот префикс зарезервирован для будущих наборов событий DOM. Также настоятельно рекомендуется, чтобы третьи стороны, добавляющие свои собственные события, использовали свой собственный префикс, чтобы избежать путаницы и уменьшить вероятность конфликтов с другими новыми событиями. -
canBubbleArg- Указывает, может ли событие всплывать. -
cancelableArg- Указывает, может ли быть предотвращено действие по умолчанию события.
© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.xml/org/w3c/dom/events/Event.html
