Интерфейс события
- Все известные подинтерфейсы:
-
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 по Гринвичу 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, 2023, 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/21/docs/api/java.xml/org/w3c/dom/events/Event.html
