Интерфейс Event
- Все известные подинтерфейсы:
LSLoadEvent, LSProgressEvent, MouseEvent, MutationEvent, UIEvent
public interface Event
Интерфейс
Event используется для предоставления обработчику, обрабатывающему событие, контекстной информации о событии. Объект, реализующий интерфейс Event, обычно передается в качестве первого параметра обработчику событий. Более конкретная контекстная информация передается обработчикам событий с помощью дополнительных интерфейсов, производных от Event, которые содержат сведения, непосредственно относящиеся к сопровождаемому ими типу события. Эти производные интерфейсы также реализуются объектом, передаваемым прослушивателю событий. См. также Спецификацию событий объектной модели документа (DOM) уровня 2.
- Начиная с:
- 1.5, DOM уровня 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. Примерами времени эпохи являются время запуска системы или 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. Этот метод можно вызвать только до отправки 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://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/w3c/dom/events/Event.html
