Интерфейс EventTarget

public interface EventTarget

Интерфейс EventTarget реализован всеми Nodes в реализации, поддерживающей модель событий DOM. Поэтому этот интерфейс можно получить с помощью методов приведения типов, специфичных для привязки, для экземпляра интерфейса Node. Интерфейс позволяет регистрировать и удалять EventListeners для EventTarget, а также отправлять события этому EventTarget.

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

Начиная с:: 1.5, DOM Level 2

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addEventListener(String type, EventListener listener, boolean useCapture)`	Этот метод позволяет регистрировать слушателей событий для цели события.
`boolean`	`dispatchEvent(Event evt)`	Этот метод позволяет отправлять события в модель событий реализации.
`void`	`removeEventListener(String type, EventListener listener, boolean useCapture)`	Этот метод позволяет удалять слушателей событий из цели события.

Подробное описание методов

addEventListener

void addEventListener(String type, EventListener listener, boolean useCapture)

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

Параметры:: type — тип события, для которого пользователь выполняет регистрацию; listener — параметр listener принимает интерфейс, реализованный пользователем и содержащий методы, которые должны вызываться при возникновении события.; useCapture — если значение true, useCapture указывает, что пользователь хочет инициировать перехват. После его начала все события указанного типа будут отправляться зарегистрированному EventListener до отправки любому EventTargets, находящемуся ниже него в дереве. События, всплывающие вверх по дереву, не вызовут EventListener, для которого указан перехват.

removeEventListener

void removeEventListener(String type, EventListener listener, boolean useCapture)

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

Параметры:: type — указывает тип удаляемого события EventListener.; listener — параметр EventListener указывает EventListener , который необходимо удалить.; useCapture — указывает, был ли удаляемый EventListener зарегистрирован как слушатель с перехватом. Если слушатель был зарегистрирован дважды — один раз с перехватом и один раз без него, — каждый экземпляр необходимо удалять отдельно. Удаление слушателя с перехватом не влияет на вариант того же слушателя без перехвата, и наоборот.

dispatchEvent

boolean dispatchEvent(Event evt) throws EventException

Этот метод позволяет отправлять события в модель событий реализации. События, отправленные таким способом, будут вести себя при перехвате и всплытии так же, как события, отправленные непосредственно реализацией. Целью события является EventTarget, для которого вызывается dispatchEvent.

Параметры:: evt — указывает тип события, его поведение и контекстную информацию, используемые при обработке события.
Возвращает:: Возвращаемое значение dispatchEvent указывает, вызвал ли какой-либо из обработавших событие слушателей preventDefault. Если был вызван preventDefault, возвращается false, в противном случае — true.
Исключения:: EventException — UNSPECIFIED_EVENT_TYPE_ERR: возникает, если тип Event не был указан при инициализации события до вызова dispatchEvent. Указание типа Event как null или пустой строки также вызывает это исключение.

© 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/EventTarget.html