Интерфейс EventTarget

public interface EventTarget

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

См. также спецификацию событий модели объекта документа (DOM) уровня 2 Document Object Model (DOM) Level 2 Events Specification.

Since:: 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 во время обработки события, он не будет вызван текущими действиями, но может быть вызван на более поздней стадии потока события, например, на фазе всплытия.
Если несколько идентичных EventListener зарегистрированы на одном и том же EventTarget с одинаковыми параметрами, дублированные экземпляры отбрасываются. Они не вызывают вызов 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 - Указывает тип события удаляемого обработчика.; 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://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/w3c/dom/events/EventTarget.html