aboutsummaryrefslogtreecommitdiff
path: root/files/ru/web/api/eventlistener/index.html
blob: 4ff64d8c801c2a045fd98b155859a5a3e7a3dba0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
---
title: EventListener
slug: Web/API/EventListener
translation_of: Web/API/EventListener
---
<p>{{APIRef("DOM Events")}}</p>

<p>Интерфейс <code>EventListener</code> представляет собой объект, который может обработать событие, отправленное объектом {{domxref ("EventTarget")}}.</p>

<div class="note">
<p><strong>Note:</strong> Из-за необходимости совместимости с унаследованным контентом, <code>EventListener</code> принимает функцию или объект с методом  <code>handleEvent()</code>. Это показано в <a href="#Example">примере</a> ниже.</p>
</div>

<h2 id="Свойства">Свойства</h2>

<p><em>Интерфейс не реализует и не наследует никаких свойств.</em></p>

<h2 id="Method_overview">Синтаксис</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <td><code>void <a href="#handleEvent()">handleEvent</a>(in Event event);</code></td>
  </tr>
 </tbody>
</table>

<h2 id="Methods">Методы</h2>

<h3 id="handleEvent">handleEvent()</h3>

<p>Этот метод вызывается всякий раз, когда происходит событие того типа, для которого был зарегистрирован интерфейс EventListener.</p>

<pre class="eval">void handleEvent(
  in Event event
);
</pre>

<h5 id="Parameters">Параметры</h5>

<dl>
 <dt><code>event</code></dt>
 <dd>Событие DOM {{ domxref("Event") }} для которого регистрируется обработчик.</dd>
</dl>

<h3 id="Remarks">Примечания</h3>

<p>Поскольку у интерфейса отмечен флаг <code><span class="nowiki">[function]</span></code>, все объекты JavaScript <a href="/en/JavaScript/Reference/Global_Objects/Function" title="en/Core_JavaScript_1.5_Reference/Global_Objects/Function">Function</a> автоматически реализуют этот интерфейс. Вызов метода {{ manch("handleEvent") }} на такой реализации автоматически вызовет эту функцию.</p>



<h2 id="Пример">Пример</h2>

<h3 id="HTML">HTML</h3>

<pre class="brush: html"><code>&lt;button id="btn"&gt;Нажми сюда!&lt;/button&gt;</code>
</pre>

<h3 id="JavaScript">JavaScript</h3>

<pre class="brush: js"><code>const buttonElement = document.getElementById('btn');

// Добавим обработчик для события "click", предоставив callback.
// Теперь по клику на элемент будет всплывать подсказка.

buttonElement.addEventListener('click', function (event) {
  alert('Событие вызвано функцией!');
});

// Теперь привяжем обработчик через объект, содержащий функцию

buttonElement.addEventListener('click', {
  handleEvent: function (event) {
    alert('Событие вызвал handleEvent!');
  }
});</code></pre>

<h3 id="Результат">Результат</h3>

<p>{{EmbedLiveSample('Пример')}}</p>



<h2 id="See_also">Смотрите также</h2>

<ul>
 <li>{{ spec("http://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-EventListener","Document Object Model Events: EventListener","REC") }}</li>
</ul>