Интерфейс EventTarget

public interface EventTarget

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

См. также Спецификацию событий модели документа (DOM) уровня 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.

Параметры:: 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, 2021, 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/17/docs/api/java.xml/org/w3c/dom/events/EventTarget.html