Интерфейс Event
- Все известные подинтерфейсы:
-
LSLoadEvent,LSProgressEvent,MouseEvent,MutationEvent,UIEvent
public interface Event
Интерфейс
Event используется для предоставления контекстной информации об событии обработчику, обрабатывающему это событие. Объект, реализующий интерфейс Event, обычно передаётся в качестве первого параметра обработчику событий. Более специфическая контекстная информация передаётся обработчикам событий путём получения дополнительных интерфейсов от интерфейса Event, которые содержат информацию, напрямую относящуюся к типу сопровождаемого события. Эти производные интерфейсы также реализуются объектом, переданным слушателю событий. См. также Спецификацию событий Document Object Model (DOM) Level 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. |
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. Этот метод можно вызывать только до того, как Event был отправлен посредством метода dispatchEvent, хотя его можно вызывать несколько раз на этой фазе, если это необходимо. Если вызывается несколько раз, приоритет имеет последнее обращение. Если вызывается из подкласса интерфейса Event, изменяются только значения, указанные в методе initEvent, все остальные атрибуты остаются неизменными.- Параметры:
-
eventTypeArg- Указывает тип события. Этот тип может быть любым типом события, в настоящее время определённым в этой спецификации, или новым типом события. Строка должна быть именем XML. Любой новый тип события не должен начинаться с любой версии, заглавной, строчной или смешанной, строки «DOM». Этот префикс зарезервирован для будущих наборов событий DOM. Также настоятельно рекомендуется, чтобы третьи лица, добавляющие свои собственные события, использовали свой собственный префикс, чтобы избежать путаницы и уменьшить вероятность конфликтов с другими новыми событиями. -
canBubbleArg- Указывает может ли событие распространяться. -
cancelableArg- Указывает может ли быть предотвращено действие по умолчанию события.
© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/w3c/dom/events/Event.html
