Интерфейс EventTarget

public interface EventTarget

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

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