Интерфейс EventTarget

public interface EventTarget

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

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

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.

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

removeEventListener

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

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

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

dispatchEvent

boolean dispatchEvent(Event evt) throws EventException

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

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

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