From 415bedec7d098435d3393eba2fe69e0c96f3dbf3 Mon Sep 17 00:00:00 2001 From: Alexey Pyltsyn Date: Thu, 18 Mar 2021 21:44:39 +0300 Subject: Unify translation of "слушатель" (#207) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Unify translation of "слушатель" * Fixes after review --- files/ru/web/api/abortcontroller/abort/index.html | 2 +- .../api/abortcontroller/abortcontroller/index.html | 2 +- files/ru/web/api/abortcontroller/signal/index.html | 2 +- files/ru/web/api/abortsignal/index.html | 2 +- files/ru/web/api/audiocontext/index.html | 2 +- .../api/baseaudiocontext/createpanner/index.html | 6 +-- .../api/broadcastchannel/postmessage/index.html | 2 +- files/ru/web/api/cachestorage/match/index.html | 2 +- .../api/document/domcontentloaded_event/index.html | 2 +- .../api/document_object_model/events/index.html | 6 +-- files/ru/web/api/element/index.html | 2 +- .../ru/web/api/element/mouseenter_event/index.html | 2 +- .../ru/web/api/element/mouseleave_event/index.html | 2 +- .../event/comparison_of_event_targets/index.html | 2 +- .../api/event/stopimmediatepropagation/index.html | 4 +- files/ru/web/api/eventsource/index.html | 2 +- .../api/eventtarget/addeventlistener/index.html | 58 +++++++++++----------- .../web/api/globaleventhandlers/oninput/index.html | 2 +- .../drag_operations/index.html | 16 +++--- .../api/htmlelement/pointerover_event/index.html | 2 +- .../api/htmlelement/transitionend_event/index.html | 2 +- files/ru/web/api/htmlmediaelement/index.html | 2 +- .../api/indexeddb_api/using_indexeddb/index.html | 2 +- files/ru/web/api/navigatoronline/online/index.html | 4 +- files/ru/web/api/rtcpeerconnection/index.html | 2 +- .../using_server-sent_events/index.html | 8 +-- files/ru/web/api/sharedworker/index.html | 2 +- files/ru/web/api/speechrecognition/index.html | 6 +-- .../web/api/window/beforeunload_event/index.html | 2 +- files/ru/web/api/window/index.html | 4 +- files/ru/web/api/window/postmessage/index.html | 4 +- files/ru/web/api/xmlhttprequest/index.html | 2 +- 32 files changed, 80 insertions(+), 80 deletions(-) (limited to 'files/ru/web/api') diff --git a/files/ru/web/api/abortcontroller/abort/index.html b/files/ru/web/api/abortcontroller/abort/index.html index faee90f432..3133be11ae 100644 --- a/files/ru/web/api/abortcontroller/abort/index.html +++ b/files/ru/web/api/abortcontroller/abort/index.html @@ -27,7 +27,7 @@ translation_of: Web/API/AbortController/abort

Сначала мы создаём контроллер с помощью конструктора {{domxref("AbortController.AbortController","AbortController()")}}, а затем получаем ссылку на связанный объект {{domxref("AbortSignal")}} используя свойство {{domxref("AbortController.signal")}}.

-

Когда fetch запрос инициируется, мы передаём AbortSignal в качестве опции внутрь объекта параметров запроса (см. {signal} ниже). Это связывает сигнал и контроллер с fetch запросом и позволяет нам прервать его, вызвав {{domxref("AbortController.abort()")}}, как показано ниже во втором прослушивателе событий.

+

Когда fetch запрос инициируется, мы передаём AbortSignal в качестве опции внутрь объекта параметров запроса (см. {signal} ниже). Это связывает сигнал и контроллер с fetch запросом и позволяет нам прервать его, вызвав {{domxref("AbortController.abort()")}}, как показано ниже во втором обработчике событий.

 

diff --git a/files/ru/web/api/abortcontroller/abortcontroller/index.html b/files/ru/web/api/abortcontroller/abortcontroller/index.html index af3908bc64..be87c327d1 100644 --- a/files/ru/web/api/abortcontroller/abortcontroller/index.html +++ b/files/ru/web/api/abortcontroller/abortcontroller/index.html @@ -23,7 +23,7 @@ translation_of: Web/API/AbortController/AbortController

Сначала мы создаём контроллер с помощью конструктора {{domxref("AbortController.AbortController","AbortController()")}}, а затем получаем ссылку на связанный объект {{domxref("AbortSignal")}} используя свойство {{domxref("AbortController.signal")}}.

-

Когда fetch запрос инициируется, мы передаём AbortSignal в качестве опции внутрь объекта параметров запроса (см. {signal} ниже). Это связывает сигнал и контроллер с fetch запросом и позволяет нам прервать его, вызвав {{domxref("AbortController.abort()")}}, как показано ниже во втором прослушивателе событий.

+

Когда fetch запрос инициируется, мы передаём AbortSignal в качестве опции внутрь объекта параметров запроса (см. {signal} ниже). Это связывает сигнал и контроллер с fetch запросом и позволяет нам прервать его, вызвав {{domxref("AbortController.abort()")}}, как показано ниже во втором обработчике событий.

 

diff --git a/files/ru/web/api/abortcontroller/signal/index.html b/files/ru/web/api/abortcontroller/signal/index.html index 1e21182f01..b8a75feef2 100644 --- a/files/ru/web/api/abortcontroller/signal/index.html +++ b/files/ru/web/api/abortcontroller/signal/index.html @@ -25,7 +25,7 @@ translation_of: Web/API/AbortController/signal

Сначала мы создаём контроллер с помощью конструктора {{domxref("AbortController.AbortController","AbortController()")}}, а затем получаем ссылку на связанный объект {{domxref("AbortSignal")}} используя свойство {{domxref("AbortController.signal")}}.

-

Когда fetch запрос инициируется, мы передаём AbortSignal в качестве опции внутрь объекта параметров запроса (см. {signal} ниже). Это связывает сигнал и контроллер с fetch запросом и позволяет нам прервать его, вызвав {{domxref("AbortController.abort()")}}, как показано ниже во втором прослушивателе событий.

+

Когда fetch запрос инициируется, мы передаём AbortSignal в качестве опции внутрь объекта параметров запроса (см. {signal} ниже). Это связывает сигнал и контроллер с fetch запросом и позволяет нам прервать его, вызвав {{domxref("AbortController.abort()")}}, как показано ниже во втором обработчике событий.

 

diff --git a/files/ru/web/api/abortsignal/index.html b/files/ru/web/api/abortsignal/index.html index 2b7ae051d1..1830282648 100644 --- a/files/ru/web/api/abortsignal/index.html +++ b/files/ru/web/api/abortsignal/index.html @@ -33,7 +33,7 @@ translation_of: Web/API/AbortSignal

Сначала мы создаём контроллер с помощью конструктора {{domxref("AbortController.AbortController","AbortController()")}}, а затем получаем ссылку на связанный объект {{domxref("AbortSignal")}} используя свойство {{domxref("AbortController.signal")}}.

-

Когда fetch запрос инициируется, мы передаём AbortSignal в качестве опции внутрь объекта параметров запроса (см. {signal} ниже). Это связывает сигнал и контроллер с fetch запросом и позволяет нам прервать его, вызвав {{domxref("AbortController.abort()")}}, как показано ниже во втором прослушивателе событий.

+

Когда fetch запрос инициируется, мы передаём AbortSignal в качестве опции внутрь объекта параметров запроса (см. {signal} ниже). Это связывает сигнал и контроллер с fetch запросом и позволяет нам прервать его, вызвав {{domxref("AbortController.abort()")}}, как показано ниже во втором обработчике событий.

var controller = new AbortController();
 var signal = controller.signal;
diff --git a/files/ru/web/api/audiocontext/index.html b/files/ru/web/api/audiocontext/index.html
index e1837c8ec0..17b32839d0 100644
--- a/files/ru/web/api/audiocontext/index.html
+++ b/files/ru/web/api/audiocontext/index.html
@@ -10,7 +10,7 @@ translation_of: Web/API/AudioContext
 

Интерфейс AudioContext можно представить как граф, состоящий из связанных между собой узлов {{domxref("AudioNode")}}. С помощью этого интерфейса можно контролировать как создание узлов, из которых состоит AudioContext, так и контролировать обработку и декодирование звука. Необходимо создать AudioContext перед тем как делать что-либо ещё со звуком, так как всё что происходит при обработке звука, происходит внутри AudioContext.

-

AudioContext может выступать как слушатель событий, и он реализует интерфейс {{domxref("EventTarget")}}.

+

AudioContext может выступать как обработчик событий, и он реализует интерфейс {{domxref("EventTarget")}}.

Свойства

diff --git a/files/ru/web/api/baseaudiocontext/createpanner/index.html b/files/ru/web/api/baseaudiocontext/createpanner/index.html index 28e5bdc0f7..83a8089d44 100644 --- a/files/ru/web/api/baseaudiocontext/createpanner/index.html +++ b/files/ru/web/api/baseaudiocontext/createpanner/index.html @@ -24,7 +24,7 @@ var panner = audioCtx.createPanner();

Пример

-
Ниже можно увидеть пример использования {{domxref("AudioListener")}}, {{domxref("PannerNode")}} и метода createPanner() для управления пространством объемного звука. Обычно определяется положение в трехмерном пространстве, изначально занимаемое слушателем (listener) и источником звука (panner), а затем, при использовании приложения, обновляется позиция одного из них или обоих. Например, вы можете перемещать персонажа внутри игрового мира, и желательно чтобы передача звука изменялась реалистично, по мере приближения или отдаления персонажа относительно источника звука, вроде стереопроигрывателя. В этом примере можно видеть, что все это управляется функциями moveRight(), moveLeft(), и т.п., которые устанавливают новые значения для положения паннера через функцию PositionPanner().
+
Ниже можно увидеть пример использования {{domxref("AudioListener")}}, {{domxref("PannerNode")}} и метода createPanner() для управления пространством объемного звука. Обычно определяется положение в трехмерном пространстве, изначально занимаемое обработчиком (listener) и источником звука (panner), а затем, при использовании приложения, обновляется позиция одного из них или обоих. Например, вы можете перемещать персонажа внутри игрового мира, и желательно чтобы передача звука изменялась реалистично, по мере приближения или отдаления персонажа относительно источника звука, вроде стереопроигрывателя. В этом примере можно видеть, что все это управляется функциями moveRight(), moveLeft(), и т.п., которые устанавливают новые значения для положения паннера через функцию PositionPanner().
 
@@ -40,7 +40,7 @@ var panner = audioCtx.createPanner();

Note how we have used some feature detection to either give the browser the newer property values (like {{domxref("AudioListener.forwardX")}}) for setting position, etc. if it supports those, or older methods (like {{domxref("AudioListener.setOrientation()")}}) if it still supports those but not the new properties.

// set up listener and panner position information
-// установка сведений о слушателе (listener) и положении panner'а
+// установка сведений обработчика и положении panner'а
 var WIDTH = window.innerWidth;
 var HEIGHT = window.innerHeight;
 
@@ -100,7 +100,7 @@ rightBound = xPos - 50;
 xIterator = WIDTH/150;
 
 // listener will always be in the same place for this demo
-// в этом демо слушатель всегда находится на одном и том же месте
+// в этом демо обработчик всегда находится на одном и том же месте
 
 if(listener.positionX) {
   listener.positionX.value = xPos;
diff --git a/files/ru/web/api/broadcastchannel/postmessage/index.html b/files/ru/web/api/broadcastchannel/postmessage/index.html
index 17ea5ad451..abbb139478 100644
--- a/files/ru/web/api/broadcastchannel/postmessage/index.html
+++ b/files/ru/web/api/broadcastchannel/postmessage/index.html
@@ -13,7 +13,7 @@ translation_of: Web/API/BroadcastChannel/postMessage
 ---
 

{{APIRef("BroadCastChannel API")}}

-

BroadcastChannel.postMessage() отправляет сообщение, которое может быть любым {{jsxref("Object", "объектом")}}, каждому слушателю в {{glossary("browsing context", "контексте браузера")}} с тем же {{glossary("origin")}}. Сообщение передается в виде события {{event("message")}} к каждому BroadcastChannel, привязанному к данному каналу.

+

BroadcastChannel.postMessage() отправляет сообщение, которое может быть любым {{jsxref("Object", "объектом")}}, каждому обработчику в {{glossary("browsing context", "контексте браузера")}} с тем же {{glossary("origin")}}. Сообщение передается в виде события {{event("message")}} к каждому BroadcastChannel, привязанному к данному каналу.

{{AvailableInWorkers}}

diff --git a/files/ru/web/api/cachestorage/match/index.html b/files/ru/web/api/cachestorage/match/index.html index 758d898f38..15f417399b 100644 --- a/files/ru/web/api/cachestorage/match/index.html +++ b/files/ru/web/api/cachestorage/match/index.html @@ -48,7 +48,7 @@ translation_of: Web/API/CacheStorage/match

Примеры

-

Это пример  из MDN sw-test example (см. sw-test running live). В данном примере, мы слушаем событие {{domxref("FetchEvent")}}. Мы строим проверку ответа следующим образом:

+

Это пример  из MDN sw-test example (см. sw-test running live). В данном примере, мы обрабатываем событие {{domxref("FetchEvent")}}. Мы строим проверку ответа следующим образом:

  1. Проверяем, совпадения для запроса в {{domxref("CacheStorage")}} используя {{domxref("CacheStorage.match","CacheStorage.match()")}}. Если совпадение найдено, возвращаем response.
  2. diff --git a/files/ru/web/api/document/domcontentloaded_event/index.html b/files/ru/web/api/document/domcontentloaded_event/index.html index 4a77474df9..8a9ae9033b 100644 --- a/files/ru/web/api/document/domcontentloaded_event/index.html +++ b/files/ru/web/api/document/domcontentloaded_event/index.html @@ -58,7 +58,7 @@ for( let i = 0; i < 1000000000; i++)

    Проверка того, завершена ли загрузка

    -

    DOMContentLoaded может сработать до того, как ваш скрипт будет запущен, поэтому разумно это проверить, перед добавлением слушателя.

    +

    DOMContentLoaded может сработать до того, как ваш скрипт будет запущен, поэтому разумно это проверить, перед добавлением обработчика.

    function doSomething() {
       console.info('DOM загружен');
    diff --git a/files/ru/web/api/document_object_model/events/index.html b/files/ru/web/api/document_object_model/events/index.html
    index c5995b792e..b8dd38e9d8 100644
    --- a/files/ru/web/api/document_object_model/events/index.html
    +++ b/files/ru/web/api/document_object_model/events/index.html
    @@ -8,13 +8,13 @@ original_slug: DOM/DOM_Reference/Events
     
     

    Вступление

    -

    В этой главе описывается модель событий DOM. Топ скрыть Интерфейс сам по себе описано, а также интерфейсы для регистрации событий на узлах в DOM, Также а слушатели события Главного , Также а Несколько больше Примеры, которые показывают, как Различные интерфейсы связаны друг события Главного с другом.

    +

    В этой главе описывается модель событий DOM. Топ скрыть Интерфейс сам по себе описано, а также интерфейсы для регистрации событий на узлах в DOM, Также а обработчики события Главного , Также а Несколько больше Примеры, которые показывают, как Различные интерфейсы связаны друг события Главного с другом.

    Существует отличная диаграмма, которая четко объясняет события трех этапов через DOM в проекте DOM Level 3 Events .

    Также см. Пример 5: Распространение событий в главе «Примеры» для более подробного примера.

    -

    Регистрация слушателей событий

    +

    Регистрация обработчиков событий

    Есть 3 способа регистрации обработанных событий для элемента DOM.

    @@ -57,7 +57,7 @@ function greet (event) {

    Доступ к интерфейсам событий

    -

    Обработчики событий могут быть присоединены к различным объектам, включая элементы DOM, документ, объект окна и т. Д. Когда происходит событие, объект события создается и последовательно передается слушателям события.

    +

    Обработчики событий могут быть присоединены к различным объектам, включая элементы DOM, документ, объект окна и т. Д. Когда происходит событие, объект события создается и последовательно передается обработчикам события.

    Интерфейс {{domxref ("Event")}} доступен из функции-обработчика через объект события, переданный в качестве первого аргумента. В следующем простом примере показано, как объект события передается в функцию-обработчик события и может использоваться из одной такой функции.

    diff --git a/files/ru/web/api/element/index.html b/files/ru/web/api/element/index.html index db330d7aee..966cf39fe2 100644 --- a/files/ru/web/api/element/index.html +++ b/files/ru/web/api/element/index.html @@ -175,7 +175,7 @@ translation_of: Web/API/Element
    {{ domxref("Element.removeAttributeNode()") }} {{obsolete_inline}}
    Удаляет представление узла именованного атрибута из текущего узла.
    {{ domxref("EventTarget.removeEventListener()") }}
    -
    Удаляет прослушиватель событий из элемента.
    +
    Удаляет обработчик событий из элемента.
    {{ domxref("Element.requestFullscreen()") }} {{experimental_inline}}
    Асинхронно запрашивает браузер, чтобы сделать элемент полноэкранным.
    {{ domxref("Element.requestPointerLock()")}} {{experimental_inline}}
    diff --git a/files/ru/web/api/element/mouseenter_event/index.html b/files/ru/web/api/element/mouseenter_event/index.html index 4fdfec5bee..682e4930cd 100644 --- a/files/ru/web/api/element/mouseenter_event/index.html +++ b/files/ru/web/api/element/mouseenter_event/index.html @@ -39,7 +39,7 @@ translation_of: Web/API/Element/mouseenter_event
    mouseover.png
    Одиночное событие наведения мыши mouseover отправляется в самый глубокий элемент дерева DOM, затем оно всплывает в иерархии, пока не будет отменено обработчиком или не достигнет корня.
-

При наличии глубокой иерархии количество отправляемых событий mouseenter может быть довольно большим и вызывать значительные проблемы с производительностью. В таких случаях лучше прослушивать события mouseover.

+

При наличии глубокой иерархии количество отправляемых событий mouseenter может быть довольно большим и вызывать значительные проблемы с производительностью. В таких случаях лучше обрабатывать события mouseover.

В сочетании с соответствующим событием mouseleave (которое запускается в элементе, когда мышь покидает область содержимого), событие mouseenter действует очень похоже на псевдокласс CSS {{cssxref(':hover')}}.

diff --git a/files/ru/web/api/element/mouseleave_event/index.html b/files/ru/web/api/element/mouseleave_event/index.html index 9db4d49b39..19b5e9dafb 100644 --- a/files/ru/web/api/element/mouseleave_event/index.html +++ b/files/ru/web/api/element/mouseleave_event/index.html @@ -88,7 +88,7 @@ translation_of: Web/API/Element/mouseleave_event currentTarget {{readonlyInline}} {{domxref("EventTarget")}} - Целевой узел (элемент), который используется слушателем события. + Целевой узел (элемент), который используется обработчиком события. relatedTarget {{readonlyInline}} diff --git a/files/ru/web/api/event/comparison_of_event_targets/index.html b/files/ru/web/api/event/comparison_of_event_targets/index.html index 0c05e9118f..2a6156a312 100644 --- a/files/ru/web/api/event/comparison_of_event_targets/index.html +++ b/files/ru/web/api/event/comparison_of_event_targets/index.html @@ -90,7 +90,7 @@ translation_of: Web/API/Event/Comparison_of_Event_Targets     <thead>         <tr>             <td class="standard">Изначальная цель, отправляющая событие <small>event.target</small></td> -            <td class="standard">Цель, кто прослушивает события <small>event.currentTarget</small></td> +            <td class="standard">Цель, кто обрабатывает события <small>event.currentTarget</small></td>             <td class="standard">Идентифицировать другой элемент (если он есть), участвующий в событии <small>event.relatedTarget</small></td>             <td class="non-standard">Если по какой-то причине произошло перенацеливание события <small>event.explicitOriginalTarget</small> содержит цель перед перенацеливанием (никогда не содержит анонимных целей)</td>             <td class="non-standard">Если по какой-то причине произошло перенацеливание события <small>event.originalTarget</small> содержит цель перед перенацеливанием (может содержать анонимные цели)</td> diff --git a/files/ru/web/api/event/stopimmediatepropagation/index.html b/files/ru/web/api/event/stopimmediatepropagation/index.html index 177bffde51..fd19d6a123 100644 --- a/files/ru/web/api/event/stopimmediatepropagation/index.html +++ b/files/ru/web/api/event/stopimmediatepropagation/index.html @@ -15,7 +15,7 @@ translation_of: Web/API/Event/stopImmediatePropagation ---

{{APIRef("DOM")}}

-

Останавливает цепочку вызова событий для последующих слушателей DOM элемента.

+

Останавливает цепочку вызова событий для последующих обработчиков DOM элемента.

Синтаксис

@@ -24,7 +24,7 @@ translation_of: Web/API/Event/stopImmediatePropagation

Замечания

-

Если несколько слушателей прикреплены к одному и тому же элементу с одинаковым типом события, тогда они будут вызваны в порядке своего добавления. Если один из этих слушателей вызовет event.stopImmediatePropagation() тогда события оставшихся слушателей вызваны не будут.

+

Если несколько обработчиков прикреплены к одному и тому же элементу с одинаковым типом события, тогда они будут вызваны в порядке своего добавления. Если один из этих обработчиков вызовет event.stopImmediatePropagation() тогда события оставшихся обработчиков вызваны не будут.

Спецификация

diff --git a/files/ru/web/api/eventsource/index.html b/files/ru/web/api/eventsource/index.html index fd25f85eb4..7c99a51bfc 100644 --- a/files/ru/web/api/eventsource/index.html +++ b/files/ru/web/api/eventsource/index.html @@ -7,7 +7,7 @@ translation_of: Web/API/EventSource

Интерфейс EventSource используется для получения серверных событий (Server-sent events). Он устанавливает соединение с сервером по HTTP и получает события в формате text/event-stream без закрытия соединения.

-

Вы можете присвоить атрибуту onmessage JavaScript-функцию для получения нетипизированных сообщений (то есть сообщений без поля event). Вы так же можете вызвать функцию addEventListener() для прослушивания событий так же, как для любого другого источника событий.

+

Вы можете присвоить атрибуту onmessage JavaScript-функцию для получения нетипизированных сообщений (то есть сообщений без поля event). Вы так же можете вызвать функцию addEventListener() для обработки событий так же, как для любого другого источника событий.

См. Using server-sent events для более детальной информации 

diff --git a/files/ru/web/api/eventtarget/addeventlistener/index.html b/files/ru/web/api/eventtarget/addeventlistener/index.html index 7d5f4d84ba..dfd29c7aa9 100644 --- a/files/ru/web/api/eventtarget/addeventlistener/index.html +++ b/files/ru/web/api/eventtarget/addeventlistener/index.html @@ -27,7 +27,7 @@ target.addEventListener(type, listener[, useCapture
type
-
Чувствительная к регистру строка, представляющая тип прослушиваемого события.
+
Чувствительная к регистру строка, представляющая тип обрабатываемого события.
listener
Объект, который принимает уведомление, когда событие указанного типа произошло. Это должен быть объект, реализующий интерфейс {{domxref("EventListener")}} или просто функция JavaScript.
@@ -36,20 +36,20 @@ target
.addEventListener(type, listener[, useCaptureoptions {{optional_inline}}
Объект options, который определяет характеристики объекта, прослушивающего событие. Доступны следующие варианты:
    -
  • capture:  {{jsxref("Boolean")}} указывает, что события этого типа будут отправлены зарегистрированному слушателю listener перед отправкой на EventTarget, расположенный ниже в дереве DOM.
  • -
  • once: {{jsxref("Boolean")}} указывает, что слушатель должен быть вызван не более одного раза после добавления. Если true, слушатель автоматически удаляется при вызове.
  • -
  • passive:  {{jsxref("Boolean")}} указывает, что слушатель никогда не вызовет preventDefault(). Если все же вызов будет произведен, браузер должен игнорировать его и генерировать консольное предупреждение. Пример {{anch("Улучшение производительности прокрутки с помощью passive true")}}
  • -
  • {{non-standard_inline}} mozSystemGroup: {{jsxref("Boolean")}} указывает, что слушатель должен быть добавлен в системную группу. Доступно только в коде, запущенном в XBL или в расширении Chrome.
  • +
  • capture:  {{jsxref("Boolean")}} указывает, что события этого типа будут отправлены зарегистрированному обработчику listener перед отправкой на EventTarget, расположенный ниже в дереве DOM.
  • +
  • once: {{jsxref("Boolean")}} указывает, что обработчик должен быть вызван не более одного раза после добавления. Если true, обработчик автоматически удаляется при вызове.
  • +
  • passive:  {{jsxref("Boolean")}} указывает, что обработчик никогда не вызовет preventDefault(). Если все же вызов будет произведен, браузер должен игнорировать его и генерировать консольное предупреждение. Пример {{anch("Улучшение производительности прокрутки с помощью passive true")}}
  • +
  • {{non-standard_inline}} mozSystemGroup: {{jsxref("Boolean")}} указывает, что обработчик должен быть добавлен в системную группу. Доступно только в коде, запущенном в XBL или в расширении Chrome.
useCapture {{optional_inline}}
-
Если равно true, useCapture указывает, что пользователь желает начать захват. После инициализации захвата все события указанного типа будут отправлены в зарегистрированный listener перед отправкой в какой-либо EventTarget под ним в дереве DOM. События, восходящие вверх по дереву, не будут вызывать слушателей, которым назначено использовать захват. Смотрите DOM Level 3 Events для более детального объяснения. Значение useCapture по умолчанию равно false. -
Note: Для прослушивателей событий прикреплённых к цели события, событие  находиться в целевой фазе, а не в фазах захвата или всплытия. События в целевой фазе инициируют все прослушиватели на элементе в том порядке, в котором они были зарегистрированы независимо от параметра useCapture.
+
Если равно true, useCapture указывает, что пользователь желает начать захват. После инициализации захвата все события указанного типа будут отправлены в зарегистрированный listener перед отправкой в какой-либо EventTarget под ним в дереве DOM. События, восходящие вверх по дереву, не будут вызывать обработчиков, которым назначено использовать захват. Смотрите DOM Level 3 Events для более детального объяснения. Значение useCapture по умолчанию равно false. +
Note: Для обработчиков событий прикреплённых к цели события, событие  находиться в целевой фазе, а не в фазах захвата или всплытия. События в целевой фазе инициируют все обработчики на элементе в том порядке, в котором они были зарегистрированы независимо от параметра useCapture.
Note: useCapture не всегда был опциональным. Лучше указывать данный параметр для повышения совместимости.
wantsUntrusted {{Non-standard_inline}}
-
Если равно true, слушатель будет получать сгенерированные события, посланные со страницы (по умолчанию равно false для chrome и true для обычных веб-страниц). Этот параметр доступен только в Gecko и в основном полезен для использования в дополнениях и самом браузере. Смотрите Взаимодействие между привилегированными и непривилегированными страницами для примеров использования.
+
Если равно true, обработчик будет получать сгенерированные события, посланные со страницы (по умолчанию равно false для chrome и true для обычных веб-страниц). Этот параметр доступен только в Gecko и в основном полезен для использования в дополнениях и самом браузере. Смотрите Взаимодействие между привилегированными и непривилегированными страницами для примеров использования.

Прежде чем использовать определенное значение в объекте options, рекомендуется убедиться, что браузер пользователя поддерживает его, поскольку это дополнение, которое не все браузеры поддерживали исторически.

@@ -60,9 +60,9 @@ target
.addEventListener(type, listener[, useCaptureПримечания по использованию -

Обратный вызов прослушивателя событий

+

Обратный вызов обработчика событий

-

Прослушиватель событий может быть задан либо как функция обратного вызова, либо как объект реализующий {{domxref("EventListener")}}, чей {{domxref("EventListener.handleEvent", "handleEvent()")}} метод служит как функция обратного вызова.

+

Обработчик событий может быть задан либо как функция обратного вызова, либо как объект реализующий {{domxref("EventListener")}}, чей {{domxref("EventListener.handleEvent", "handleEvent()")}} метод служит как функция обратного вызова.

Сама функция обратного вызова имеет те же параметры и возвращаемое значение что и метод handleEvent(); То есть обратный вызов принимает единственный параметр: объект основанный на {{domxref("Event")}} описывая событие, которое произошло и ничего не возвращая.

@@ -78,7 +78,7 @@ target
.addEventListener(type, listener[, useCaptureБезопасная проверка поддержки option -

В более старых версиях спецификации DOM третьим параметром addEventListener было логическое значение, указывающее, следует ли захватывать событие на этапе погружения. Со временем стало ясно, что необходимо больше вариантов. Вместо добавления дополнительных параметров в функцию (усложняя ситуацию при использовании необязательных значений) третий параметр был изменен на объект, который может содержать различные свойства, определяющие значения параметров для настройки слушателя событий.

+

В более старых версиях спецификации DOM третьим параметром addEventListener было логическое значение, указывающее, следует ли захватывать событие на этапе погружения. Со временем стало ясно, что необходимо больше вариантов. Вместо добавления дополнительных параметров в функцию (усложняя ситуацию при использовании необязательных значений) третий параметр был изменен на объект, который может содержать различные свойства, определяющие значения параметров для настройки обработчика событий.

Поскольку старые браузеры (а также некоторые не слишком старые браузеры) по-прежнему предполагают, что третий параметр является логическим, возникает необходимость создания своего кода, чтобы разумно обрабатывать этот сценарий. Вы можете сделать это, используя функцию обнаружения для каждого из интересующих вас параметров.

@@ -100,12 +100,12 @@ try {

Для проверки поддержки использования какой-либо опции можно просто добавить геттер для нее, используя код, подобный тому, что показан выше.

-

Если вы хотите добавить прослушиватель событий, использующий параметры, о которых идет речь, вы можете сделать это подобным образом:

+

Если вы хотите добавить обработчик событий, использующий параметры, о которых идет речь, вы можете сделать это подобным образом:

someElement.addEventListener("mouseup", handleMouseUp, passiveSupported
                                ? { passive: true } : false);
-

Здесь мы добавляем слушателя для события {{event ("mouseup")}} элемента someElement. Для третьего параметра, если passiveSupported имеет значение true, мы указываем объект options с passive: true; в противном случае мы знаем, что нам нужно передать логическое значение, и мы передаем false как значение параметра useCapture.

+

Здесь мы добавляем обработчик события {{event ("mouseup")}} элемента someElement. Для третьего параметра, если passiveSupported имеет значение true, мы указываем объект options с passive: true; в противном случае мы знаем, что нам нужно передать логическое значение, и мы передаем false как значение параметра useCapture.

Вы можете использовать стороннюю библиотеку, такую как Modernizr или Detect It, чтобы проверить поддержку необходимого свойства.

@@ -113,7 +113,7 @@ try {

Примеры

-

Добавление простого слушателя

+

Добавление простого обработчика

Эти примеры демонстрируют как использовать addEventListener() для наблюдения за щелчками мышкой по элементу.

@@ -137,18 +137,18 @@ function modifyText() { } } -// Добавляет слушателя событий для таблицы +// Добавляет обработчика событий для таблицы var el = document.getElementById("outside"); el.addEventListener("click", modifyText, false); -

В примере выше, modifyText() регистрирует слушателя для события click, используя addEventListener(). Клик в любом месте таблицы будет поднимать обработчик и запускать modifyText().

+

В примере выше, modifyText() регистрирует обработчика для события click, используя addEventListener(). Клик в любом месте таблицы будет поднимать обработчик и запускать modifyText().

Результат

{{EmbedLiveSample('Add_a_simple_listener')}}

-

Если вам нужно передать параметры в слушателя, вы можете использовать анонимные функции.

+

Если вам нужно передать параметры в обработчик, вы можете использовать анонимные функции.

Слушатель события с анонимной функцией

@@ -167,7 +167,7 @@ function modifyText(new_text) {   t2.firstChild.nodeValue = new_text; } -// Функция, добавляющая слушатель к таблице +// Функция, добавляющая обработчик к таблице el = document.getElementById("outside"); el.addEventListener("click", function(){modifyText("четыре")}, false); @@ -219,13 +219,13 @@ el.addEventListener("click", () => { modifyText("four"); }, false);

Ниже описан другой, более старый способ регистрации обработчиков.

-

Добавление слушателя во время обработки события

+

Добавление обработчика во время обработки события

Если EventListener добавлен к EventTarget во время обработки события, он не будет вызван текущими действиями, но может быть вызван на более поздней стадии обработки события, при восходящей обработке.

-

Несколько одинаковых слушателей события

+

Несколько одинаковых обработчиков события

-

Если зарегистрировано несколько одинаковых EventListener на одном EventTarget с одинаковыми параметрами, дублирующиеся слушатели игнорируются. Так как одинаковые слушатели игнорируются, не требуется удалять их вручную с помощью метода removeEventListener.

+

Если зарегистрировано несколько одинаковых EventListener на одном EventTarget с одинаковыми параметрами, дублирующиеся обработчики игнорируются. Так как одинаковые обработчики игнорируются, не требуется удалять их вручную с помощью метода removeEventListener.

Значение this в обработчике

@@ -239,7 +239,7 @@ el.addEventListener("click", () => { modifyText("four"); }, false);

Значение переменной this внутри modifyText() при вызове событием клика будет равно ссылке на глобальный (window) объект (или undefined при использовании strict mode)

-
Note: В JavaScript 1.8.5 введён метод Function.prototype.bind() , который позволяет указать значение, которое должно быть использовано для всех вызовов данной функции. Он позволяет вам легко обходить ситуации, в которых не ясно, чему будет равно this, в зависимости от того, в каком контексте будет вызвана ваша функция. заметьте, также, что Вам будет необходимо иметь внешнюю ссылку на слушатель, чтобы Вы могли удалить его позже.
+
Note: В JavaScript 1.8.5 введён метод Function.prototype.bind() , который позволяет указать значение, которое должно быть использовано для всех вызовов данной функции. Он позволяет вам легко обходить ситуации, в которых не ясно, чему будет равно this, в зависимости от того, в каком контексте будет вызвана ваша функция. заметьте, также, что Вам будет необходимо иметь внешнюю ссылку на обработчик, чтобы Вы могли удалить его позже.

Пример с использованием bind и без него:

@@ -256,7 +256,7 @@ el.addEventListener("click", () => { modifyText("four"); }, false); } -

Проблема в примере выше заключается в том, что Вы не можете удалить слушатель, вызванный с bind. Другое решение использует специальную функцию handleEvent, чтобы перехватывать любые события:

+

Проблема в примере выше заключается в том, что Вы не можете удалить обработчик, вызванный с bind. Другое решение использует специальную функцию handleEvent, чтобы перехватывать любые события:

var Something = function(element) {
   this.name = 'Something Good';
@@ -272,11 +272,11 @@ el.addEventListener("click", () => { modifyText("four"); }, false);
} }; - // В этом случае слушатели хранятся в this, а не в this.handleEvent + // В этом случае обработчики хранятся в this, а не в this.handleEvent element.addEventListener('click', this, false); element.addEventListener('dblclick', this, false); - // Вы можете напрямую удалять слушатели + // Вы можете напрямую удалять обработчики element.removeEventListener('click', this, false); element.removeEventListener('dblclick', this, false); } @@ -378,7 +378,7 @@ el.addEventListener("click", () => { modifyText("four"); }, false);

Старый способ регистрации обработчиков событий

-

addEventListener() был добавлен в спецификации DOM 2 Events. До этого слушатели добавлялись следующим образом:

+

addEventListener() был добавлен в спецификации DOM 2 Events. До этого обработчики добавлялись следующим образом:

// Передача ссылки на функцию — не добавляйте '()' после него, это вызовет функцию!
 el.onclick = modifyText;
@@ -391,7 +391,7 @@ element.onclick = function() {
 
 

Этот метод заменяет текущие слушатели события click, если они есть. Тоже самое для других событий и ассоциируемых с ними  обработчиков, таких как blur (onblur), keypress (onkeypress), и так далее.

-

Так как это по существу было частью DOM 0, этот метод имеет широкую поддержку и не требует специального кросс-браузерного кода; следовательно, это обычно используется, чтобы добавлять слушатели динамически, если не требуются расширенные возможности addEventListener().

+

Так как это по существу было частью DOM 0, этот метод имеет широкую поддержку и не требует специального кросс-браузерного кода; следовательно, это обычно используется, чтобы добавлять обработчики динамически, если не требуются расширенные возможности addEventListener().

Вопросы памяти

@@ -418,7 +418,7 @@ for(i=0 ; i<els.length ; i++){

Улучшение производительности прокрутки с помощью passive: true

-

Значение по умолчанию для параметра passive - false. Начиная с Chrome 56 (desktop, Chrome for Android, Android webview) значение по умолчанию для {{event("touchstart")}} и {{event("touchmove")}} равно true, а вызовы preventDefault() не разрешены. Чтобы отменить это поведение, необходимо установить параметр passive в false (см. пример ниже). Это изменение не позволяет слушателю блокировать показ страницы во время прокрутки пользователя. Демонстрация доступна на сайте разработчиков Google. Обратите внимание, что Edge вообще не поддерживает options, и добавление его без проверки поддержки помешает использовать аргумент useCapture.

+

Значение по умолчанию для параметра passive - false. Начиная с Chrome 56 (desktop, Chrome for Android, Android webview) значение по умолчанию для {{event("touchstart")}} и {{event("touchmove")}} равно true, а вызовы preventDefault() не разрешены. Чтобы отменить это поведение, необходимо установить параметр passive в false (см. пример ниже). Это изменение не позволяет обработчику блокировать показ страницы во время прокрутки пользователя. Демонстрация доступна на сайте разработчиков Google. Обратите внимание, что Edge вообще не поддерживает options, и добавление его без проверки поддержки помешает использовать аргумент useCapture.

/* Feature detection */
 var passiveSupported = false;
@@ -437,7 +437,7 @@ elem.addEventListener(
     passiveSupported ? { passive: true } : false
 );
-

Установка passive не имеет значения для основного события {{event ("scroll")}}, поскольку его нельзя отменить, поэтому его слушатель в любом случае не может блокировать показ страницы.

+

Установка passive не имеет значения для основного события {{event ("scroll")}}, поскольку его нельзя отменить, поэтому его обработчик в любом случае не может блокировать показ страницы.

Совместимость

diff --git a/files/ru/web/api/globaleventhandlers/oninput/index.html b/files/ru/web/api/globaleventhandlers/oninput/index.html index 7da5c5e43b..0d8a45263a 100644 --- a/files/ru/web/api/globaleventhandlers/oninput/index.html +++ b/files/ru/web/api/globaleventhandlers/oninput/index.html @@ -5,7 +5,7 @@ translation_of: Web/API/GlobalEventHandlers/oninput ---
{{ApiRef("HTML DOM")}}
-

Обработчик события для input event в окне. Событие ввода возникает при изменении значения элемента {{HTMLElement ("input")}}.
+

Обработчик события input в окне. Событие ввода возникает при изменении значения элемента {{HTMLElement ("input")}}.

Это событие пузырится. Если он поддерживается в окне, он поддерживается и в {{HTMLElement ("input")}}.

diff --git a/files/ru/web/api/html_drag_and_drop_api/drag_operations/index.html b/files/ru/web/api/html_drag_and_drop_api/drag_operations/index.html index 1b8cf0c387..0ebd022362 100644 --- a/files/ru/web/api/html_drag_and_drop_api/drag_operations/index.html +++ b/files/ru/web/api/html_drag_and_drop_api/drag_operations/index.html @@ -20,8 +20,8 @@ original_slug: Web/Guide/HTML/Drag_and_drop/Drag_operations
  1. Установить {{htmlattrxref("draggable")}}="true" на элемент, который вы хотите сделать перетаскиваемым.
  2. -
  3. Добавить слушатель события {{event("dragstart")}}.
  4. -
  5. Установить данные перетаскивания в слушатель выше.
  6. +
  7. Добавить обработчик события {{event("dragstart")}}.
  8. +
  9. Установить данные перетаскивания в обработчик выше.

Вот пример, который позволяет перетаскивать часть содержимого.

@@ -41,7 +41,7 @@ original_slug: Web/Guide/HTML/Drag_and_drop/Drag_operations

Начало операции перетаскивания

-

В примере, слушатель добавлен для события {{event("dragstart")}} с использованием атрибута{{domxref("GlobalEventHandlers.ondragstart","ondragstart")}}.

+

В примере, обработчик добавлен для события {{event("dragstart")}} с использованием атрибута{{domxref("GlobalEventHandlers.ondragstart","ondragstart")}}.

<p draggable="true" ondragstart="event.dataTransfer.setData('text/plain', 'This text may be dragged')">
   This text <strong>may</strong> be dragged.
@@ -50,7 +50,7 @@ original_slug: Web/Guide/HTML/Drag_and_drop/Drag_operations
 
 

Когда пользователь начинает перетаскивание, запускается событие {{event("dragstart")}}.

-

В этом примере слушатель {{event("dragstart")}} добавлен к самому перемещаемом элементу. Однако, вы можете слушать более высокого предка, так как событие перетаскивание всплывает вверх как и большинство событий.

+

В этом примере обработчик {{event("dragstart")}} добавлен к самому перемещаемом элементу. Однако, вы можете слушать более высокого предка, так как событие перетаскивание всплывает вверх как и большинство событий.

Внутри события {{event("dragstart")}}, вы можете указать drag данные, изображение отклика, drag-эффекты, все это описано ниже. Однако, обязательны только drag данные. (Изображение и drag-эффекты по умолчанию, подходят в большинстве ситуаций)

@@ -60,7 +60,7 @@ original_slug: Web/Guide/HTML/Drag_and_drop/Drag_operations

Когда происходит перетаскивание, данные должны быть связаны с перетаскиванием, которое определяет, что перетаскивается. Например, при перетаскивании выделенного текста в текстовое поле данные, связанные с элементом данных перетаскивания, являются самим текстом. Аналогично, при перетаскивании ссылки на веб-странице элемент данных перетаскивания является URL-адресом ссылки.

-

{{domxref("DataTransfer","drag data")}} содержит два параметра, тип (или формат) данных, и значение данных. Формат это строковый тип (такой как text/plain текстовых данных), значение - строка текста. Когда начинается перетаскивание, вы добавляете данные, предоставляя тип и данные. Во время перетаскивания в слушателе события для событий {{event("dragenter")}} и {{event("dragover")}} , вы используете типы данных перетаскиваемых данных, чтобы проверить, разрешено ли удаление. Например, цель drop, которая принимает ссылки, будет проверять тип text/uri-list. В течение события drop, слушатель будет получать данные тащат и вставить его на место.

+

{{domxref("DataTransfer","drag data")}} содержит два параметра, тип (или формат) данных, и значение данных. Формат это строковый тип (такой как text/plain текстовых данных), значение - строка текста. Когда начинается перетаскивание, вы добавляете данные, предоставляя тип и данные. Во время перетаскивания в обработчике события для событий {{event("dragenter")}} и {{event("dragover")}} , вы используете типы данных перетаскиваемых данных, чтобы проверить, разрешено ли удаление. Например, цель drop, которая принимает ссылки, будет проверять тип text/uri-list. В течение события drop, обработчик будет получать данные тащат и вставить его на место.

Свойство {{domxref("DataTransfer","drag data's")}} {{domxref("DataTransfer.types","types")}} возвращает список MIME-типов {{domxref("DOMString")}}, таких как text/plain или image/jpeg. Вы также можете создавать свои собственные типы. Большинство основные используемых типов описаны в  Recommended Drag Types.

@@ -131,7 +131,7 @@ dt.setData("text/plain", "https://www.mozilla.org");

При перетаскивании можно выполнить несколько операций. Операция  copy используется для указания на то, что перетаскиваемые данные будут скопированы из текущего местоположения в место перетаскивания. Операция move используется для указания на то, что перетаскиваемые данные будут перемещены, а операция link используется для указания на то, что между исходным и удаляемым местоположениями будет создана некоторая форма связи или соединения.

-

Вы можете указать, какая из трех операций разрешена для источника перетаскивания, установив свойство {{domxref("DataTransfer.effectAllowed","effectAllowed")}} в слушателе событий{{event("dragstart")}}.

+

Вы можете указать, какая из трех операций разрешена для источника перетаскивания, установив свойство {{domxref("DataTransfer.effectAllowed","effectAllowed")}} в обработчике событий{{event("dragstart")}}.

event.dataTransfer.effectAllowed = "copy";
 
@@ -163,7 +163,7 @@ dt.setData("text/plain", "https://www.mozilla.org");

Обратите внимание, что эти значения должны использоваться так, как указано выше. Например, установка свойства {{domxref("DataTransfer.effectAllowed","effectAllowed")}} на copyMove позволяет выполнять операцию копирования или перемещения, но не позволяет пользователю выполнять операцию связывания. Если вы не измените свойство {{domxref("DataTransfer.effectAllowed","effectAllowed")}},  то любая операция разрешена, как и со значением 'all'. Поэтому вам не нужно настраивать это свойство, если вы не хотите исключить определенные типы.

-

Во время операции перетаскивания, слушатель для событий {{event("dragenter")}} или {{event("dragover")}} может проверить свойство {{domxref("DataTransfer.effectAllowed","effectAllowed")}} , какие операции разрешены. Связанное свойство,  {{domxref("DataTransfer.dropEffect","dropEffect")}}, должно быть установлено в пределах одного из этих событий, чтобы указать, какая единственная операция должна быть выполнена. Допустимые значения для {{domxref("DataTransfer.dropEffect","dropEffect")}} - none, copy, move, или link. Комбинированные значения для этого свойства не используются.

+

Во время операции перетаскивания, обработчик для событий {{event("dragenter")}} или {{event("dragover")}} может проверить свойство {{domxref("DataTransfer.effectAllowed","effectAllowed")}} , какие операции разрешены. Связанное свойство,  {{domxref("DataTransfer.dropEffect","dropEffect")}}, должно быть установлено в пределах одного из этих событий, чтобы указать, какая единственная операция должна быть выполнена. Допустимые значения для {{domxref("DataTransfer.dropEffect","dropEffect")}} - none, copy, move, или link. Комбинированные значения для этого свойства не используются.

С событиями {{event("dragenter")}} и {{event("dragover")}}, свойство {{domxref("DataTransfer.dropEffect","dropEffect")}} инициализируется в соответствии с запросом пользователя. Пользователь может изменить желаемый эффект, нажав клавиши-модификаторы. Хотя точные используемые клавиши различаются в зависимости от платформы, обычно клавиши  Shift и Control используются для переключения между копированием, перемещением и связыванием. Указатель мыши изменится, чтобы указать, какая операция требуется. Например, для copy курсор может появиться со знаком плюс рядом с ним.

@@ -182,7 +182,7 @@ dt.setData("text/plain", "https://www.mozilla.org");

Слушатель для событий {{event("dragenter")}} и {{event("dragover")}} используются для указания допустимых drop-целей, то есть мест, где могут быть сброшены перетаскиваемые элементы. Большинство областей веб-страницы или приложения не являются допустимыми местами для сброса данных. Таким образом, обработка этих событий по умолчанию не допускает сброса перетаскиваемых данных.

-

Если вы хотите разрешить сброс переносимых данных, вы должны предотвратить обработку по умолчанию, отменив оба события dragenter и dragover.  Это можно сделать, либо вернув false из определенных атрибутом слушателя событий, либо вызвав метод {{domxref("Event.preventDefault","preventDefault()")}} событие. Последнее может быть более осуществимо в функции, определенной в отдельном скрипте.

+

Если вы хотите разрешить сброс переносимых данных, вы должны предотвратить обработку по умолчанию, отменив оба события dragenter и dragover.  Это можно сделать, либо вернув false из определенных атрибутом обработчика событий, либо вызвав метод {{domxref("Event.preventDefault","preventDefault()")}} событие. Последнее может быть более осуществимо в функции, определенной в отдельном скрипте.

<div ondragover="return false">
 <div ondragover="event.preventDefault()">
diff --git a/files/ru/web/api/htmlelement/pointerover_event/index.html b/files/ru/web/api/htmlelement/pointerover_event/index.html
index cd2ca5ef5c..09db1385a6 100644
--- a/files/ru/web/api/htmlelement/pointerover_event/index.html
+++ b/files/ru/web/api/htmlelement/pointerover_event/index.html
@@ -5,7 +5,7 @@ translation_of: Web/API/HTMLElement/pointerover_event
 ---
 
{{APIRef}}
-

Событие pointerover когда указатель входит в границы элемента слушающего события.

+

Событие pointerover когда указатель входит в границы элемента обрабатываемого события.

diff --git a/files/ru/web/api/htmlelement/transitionend_event/index.html b/files/ru/web/api/htmlelement/transitionend_event/index.html index 898af024d0..697806203f 100644 --- a/files/ru/web/api/htmlelement/transitionend_event/index.html +++ b/files/ru/web/api/htmlelement/transitionend_event/index.html @@ -75,7 +75,7 @@ original_slug: Web/Events/transitionend

Пример

/*
- * Прослушивать событие transitionend на определенном элементе, т.е. #slidingMenu
+ * Обрабатывать событие transitionend на определенном элементе, т.е. #slidingMenu
  * Затем, вызвать определенную функцию, т.е. showMessage()
  */
 function showMessage() {
diff --git a/files/ru/web/api/htmlmediaelement/index.html b/files/ru/web/api/htmlmediaelement/index.html
index f5524d3040..9bd4e1feca 100644
--- a/files/ru/web/api/htmlmediaelement/index.html
+++ b/files/ru/web/api/htmlmediaelement/index.html
@@ -186,7 +186,7 @@ translation_of: Web/API/HTMLMediaElement
 
 

События 

-

Наследует методы от своего родителя {{domxref ("HTMLElement")}}, определенного в миксине {{domxref ('GlobalEventHandlers')}}. Прослушайте эти события, используя addEventListener () или назначив прослушиватель событий свойству oneventname этого интерфейса.

+

Наследует методы от своего родителя {{domxref ("HTMLElement")}}, определенного в миксине {{domxref ('GlobalEventHandlers')}}. Обработайте эти события, используя addEventListener () или назначив обработчик событий свойству oneventname этого интерфейса.

{{domxref("HTMLMediaElement.abort_event", 'abort')}}
diff --git a/files/ru/web/api/indexeddb_api/using_indexeddb/index.html b/files/ru/web/api/indexeddb_api/using_indexeddb/index.html index 7a60703eb9..824a0372d0 100644 --- a/files/ru/web/api/indexeddb_api/using_indexeddb/index.html +++ b/files/ru/web/api/indexeddb_api/using_indexeddb/index.html @@ -25,7 +25,7 @@ translation_of: Web/API/IndexedDB_API/Using_IndexedDB
  • Создать хранилище объектов в базе данных, над которой будут выполняться наши операции. 
  • Запустить транзакцию и выдать запрос на выполнение какой-либо операции с базой данных, например, добавление или извлечение данных.
  • -
    Ждать завершения операции, "слушая" событие DOM, на которое должен быть установлен наш обработчик.
    +
    Ждать завершения операции, обрабатывая событие DOM, на которое должен быть установлен наш обработчик.
  • Сделать что-то с результатами (которые могут быть найдены в возвращаемом по нашему запросу объекте ).
    diff --git a/files/ru/web/api/navigatoronline/online/index.html b/files/ru/web/api/navigatoronline/online/index.html index afb1f8380b..1620695b45 100644 --- a/files/ru/web/api/navigatoronline/online/index.html +++ b/files/ru/web/api/navigatoronline/online/index.html @@ -13,7 +13,7 @@ translation_of: Web/API/NavigatorOnLine/onLine

    В Firefox и Internet Explorer, переключение браузера в автономный режим посылает false значение. Во всех остальных случаях возвращается значение true.

    -

    Вы можете увидеть изменения в состоянии сети путем прослушивания событий window.ononline и window.onoffline.

    +

    Вы можете увидеть изменения в состоянии сети путем обработки событий window.ononline и window.onoffline.

    Синтаксис

    @@ -38,7 +38,7 @@ translation_of: Web/API/NavigatorOnLine/onLine

    Если браузер не поддерживает navigator.onLine в примере выше, то всегда будет false/undefined.

    -

    Чтобы увидеть изменения в состоянии сети, используйте addEventListener для прослушивания событий window.ononline и window.onoffline, как показано в примере:

    +

    Чтобы увидеть изменения в состоянии сети, используйте addEventListener для обработки событий window.ononline и window.onoffline, как показано в примере:

    window.addEventListener("offline", function(e) {alert("offline");})
     
    diff --git a/files/ru/web/api/rtcpeerconnection/index.html b/files/ru/web/api/rtcpeerconnection/index.html
    index b0b1f6c165..5103da41dc 100644
    --- a/files/ru/web/api/rtcpeerconnection/index.html
    +++ b/files/ru/web/api/rtcpeerconnection/index.html
    @@ -22,7 +22,7 @@ translation_of: Web/API/RTCPeerConnection
     
     

    События 

    -

    Для прослушивания событий используется функция добавления обработчика события {{domxref("EventTarget.addEventListener", "addEventListener()")}} или используется стандартное свойство интерфейса по схеме  onимясобытия (префикс on к которому добавляется имя события прописными буквами) для установки обработчика события.

    +

    Для обработки событий используется функция добавления обработчика события {{domxref("EventTarget.addEventListener", "addEventListener()")}} или используется стандартное свойство интерфейса по схеме  onимясобытия (префикс on к которому добавляется имя события прописными буквами) для установки обработчика события.

    {{domxref("RTCPeerConnection.connectionstatechange_event", "connectionstatechange")}}
    diff --git a/files/ru/web/api/server-sent_events/using_server-sent_events/index.html b/files/ru/web/api/server-sent_events/using_server-sent_events/index.html index dc94c72a33..0bc2834743 100644 --- a/files/ru/web/api/server-sent_events/using_server-sent_events/index.html +++ b/files/ru/web/api/server-sent_events/using_server-sent_events/index.html @@ -20,7 +20,7 @@ translation_of: Web/API/Server-sent_events/Using_server-sent_events
    const evtSource = new EventSource("//api.example.com/ssedemo.php", { withCredentials: true } ); 
     
    -

    Как только вы создали экземпляр EventSource, вы можете начать прослушивание сообщений с сервера, добавив обработчик для события {{event("message")}} :

    +

    Как только вы создали экземпляр EventSource, вы можете начать получать сообщения с сервера, добавив обработчик события {{event("message")}} :

    evtSource.onmessage = function(event) {
       const newElement = document.createElement("li");
    @@ -31,9 +31,9 @@ translation_of: Web/API/Server-sent_events/Using_server-sent_events
     }
     
    -

    Этот код прослушивает входящие сообщения (то есть уведомления от сервера, на которых нет поля event) и добавляет текст сообщения в список в HTML-документе.

    +

    Этот код обрабатывает входящие сообщения (то есть уведомления от сервера, на которых нет поля event) и добавляет текст сообщения в список в HTML-документе.

    -

    Вы также можете прослушивать события, используя addEventListener():

    +

    Вы также можете обрабатывать события, используя addEventListener():

    evtSource.addEventListener("ping", function(event) {
       const newElement = document.createElement("li");
    @@ -114,7 +114,7 @@ while (1) {
     
     
    event
    -
    Строка, идентифицирующая тип описанного события. Если event указан, то событие будет отправлено в браузер слушателю для указанного имени события. Исходный код сайта должен использовать addEventListener() для прослушивания именованных событий. Обработчик onmessage вызывается, если для сообщения не указано имя события.
    +
    Строка, идентифицирующая тип описанного события. Если event указан, то событие будет отправлено в браузер обработчику указанного имени события. Исходный код сайта должен использовать addEventListener() для обработки именованных событий. Обработчик onmessage вызывается, если для сообщения не указано имя события.
    data
    Поле данных для сообщения. Когда EventSource получает несколько последовательных строк, начинающихся с data:, он объединяет их, вставляя символ новой строки между каждой из них. Последние переводы строки удаляются.
    id
    diff --git a/files/ru/web/api/sharedworker/index.html b/files/ru/web/api/sharedworker/index.html index a8d9b92990..7e2b91c3c7 100644 --- a/files/ru/web/api/sharedworker/index.html +++ b/files/ru/web/api/sharedworker/index.html @@ -46,7 +46,7 @@ translation_of: Web/API/SharedWorker
    var myWorker = new SharedWorker("worker.js");
     
    -

    далее скрипты получают доступ к воркеру через объект {{domxref("MessagePort")}}, находящийся в свойстве {{domxref("SharedWorker.port")}}. Если устанавливается хэндлер события onmessage, port самостоятельно начинает работу, вызывая собственный метод start(), если же принимать события с помощью слушателя события  "message" через addEventListener, необходимо вызвать метод start() самостоятельно:

    +

    далее скрипты получают доступ к воркеру через объект {{domxref("MessagePort")}}, находящийся в свойстве {{domxref("SharedWorker.port")}}. Если устанавливается обработчик события onmessage, port самостоятельно начинает работу, вызывая собственный метод start(), если же принимать события с помощью обработчика события  "message" через addEventListener, необходимо вызвать метод start() самостоятельно:

    myWorker.port.start();
    diff --git a/files/ru/web/api/speechrecognition/index.html b/files/ru/web/api/speechrecognition/index.html index 7fe68eb613..8331ae2e91 100644 --- a/files/ru/web/api/speechrecognition/index.html +++ b/files/ru/web/api/speechrecognition/index.html @@ -57,7 +57,7 @@ translation_of: Web/API/SpeechRecognition
    {{domxref("SpeechRecognition.onspeechend")}}
    Вызывается, когда прекращается обнаружение речи, распознанной службой распознавания речи.
    {{domxref("SpeechRecognition.onstart")}}
    -
    Вызывается, когда служба распознавания речи начинает прослушивать входящий звук с намерением распознать грамматики, связанные с текущим распознаванием речи.
    +
    Вызывается, когда служба распознавания речи начинает обрабатывать входящий звук с намерением распознать грамматики, связанные с текущим распознаванием речи.

    Методы

    @@ -66,11 +66,11 @@ translation_of: Web/API/SpeechRecognition
    {{domxref("SpeechRecognition.abort()")}}
    -
    Прекращает службу распознавания речи от прослушивания входящего аудио и не пытается вернуть {{domxref("SpeechRecognitionResult")}}.
    +
    Останавливает обработку входящего аудио службой распознавания речи и не пытается вернуть {{domxref("SpeechRecognitionResult")}}.
    {{domxref("SpeechRecognition.start()")}}
    Запускает службу распознавания речи, прослушивая входящее аудио с целью распознавания грамматик, связанных с текущим распознаванием речи.
    {{domxref("SpeechRecognition.stop()")}}
    -
    Прекращает службу распознавания речи от прослушивания входящего аудио и пытается вернуть{{domxref("SpeechRecognitionResult")}} Используя уже записанный звук.
    +
    Останавливает обработку входящего аудио службой распознавания речи и пытается вернуть {{domxref("SpeechRecognitionResult")}} Используя уже записанный звук.

    Примеры

    diff --git a/files/ru/web/api/window/beforeunload_event/index.html b/files/ru/web/api/window/beforeunload_event/index.html index 4826f98d71..1273c5de18 100644 --- a/files/ru/web/api/window/beforeunload_event/index.html +++ b/files/ru/web/api/window/beforeunload_event/index.html @@ -43,7 +43,7 @@ translation_of: Web/API/Window/beforeunload_event

    Для борьбы с нежелательными всплывающими окнами браузеры могут не отображать подсказки, созданные в обработчиках событий beforeunload, за исключением случаев, когда страница была обработана или даже не отображается вообще.

    -

    Прикрепление обработчика/слушателя событий к window или document's beforeunload событие не позволяет браузерам использовать кэш навигации по страницам в памяти, наподобие Firefox's Back-Forward cache or WebKit's Page Cache.

    +

    Прикрепление обработчика событий к window или document beforeunload событие не позволяет браузерам использовать кэш навигации по страницам в памяти, наподобие Firefox's Back-Forward cache or WebKit's Page Cache.

    В спецификации HTML указано, что вызовы {{domxref("window.alert()")}}, {{domxref("window.confirm()")}}, и {{domxref("window.prompt()")}} методы могут быть проигнорированы во время этого события. Посмотреть HTML specification для более подробной информации.

    diff --git a/files/ru/web/api/window/index.html b/files/ru/web/api/window/index.html index 85133473dc..702534c6c7 100644 --- a/files/ru/web/api/window/index.html +++ b/files/ru/web/api/window/index.html @@ -233,7 +233,7 @@ translation_of: Web/API/Window
    {{domxref("Window.releaseEvents()")}} {{Deprecated_inline}}
    Возвращает окно с захваченных событий определенного типа.
    {{domxref("element.removeEventListener","Window.removeEventListener()")}}
    -
    Удаляет слушателя события из окна.
    +
    Удаляет обработчик события из окна.
    {{domxref("Window.requestIdleCallback()")}}  {{experimental_inline}}
    Позволяет назначить расписание задачи во время периода простоя браузера.
    {{domxref("Window.resizeBy()")}}
    @@ -290,7 +290,7 @@ translation_of: Web/API/Window
    {{domxref("WindowOrWorkerGlobalScope.fetch()")}}
    Начинает процесс загрузки ресурса из сети.
    {{domxref("EventTarget.removeEventListener")}}
    -
    Удаляет слушателя события из окна.
    +
    Удаляет обработчик события из окна.
    {{domxref("WindowOrWorkerGlobalScope.setInterval()")}}
    Устанавливает расписание для исполнения функции каждый раз через заданное число миллисекунд.
    {{domxref("WindowOrWorkerGlobalScope.setTimeout()")}}
    diff --git a/files/ru/web/api/window/postmessage/index.html b/files/ru/web/api/window/postmessage/index.html index 7d1eaa8773..d6db0cff3a 100644 --- a/files/ru/web/api/window/postmessage/index.html +++ b/files/ru/web/api/window/postmessage/index.html @@ -26,7 +26,7 @@ translation_of: Web/API/Window/postMessage

    The dispatched event

    -

    В otherWindow отправляемые сообщения могут быть прослушаны следующим способом:

    +

    В otherWindow отправляемые сообщения могут быть обработаны следующим способом:

    window.addEventListener("message", receiveMessage, false);
     
    @@ -52,7 +52,7 @@ function receiveMessage(event)
     
     

    Вопросы безопасности

    -

    Если вы не ожидаете получения сообщения от других сайтов, не добавляйте никаких слушателей для message событий. Это гарантированный способ избежать проблем с безопасностью.

    +

    Если вы не ожидаете получения сообщения от других сайтов, не добавляйте обработчики событий message. Это гарантированный способ избежать проблем с безопасностью.

    Если же вы хотите получать сообщения от других сайтов, то всегда необходимо идентифицировать отправителя, используя origin и возможно source свойства. Любой сайт (включая, например, http://evil.example.com) может отправлять сообщения любым другим, и у вас нет гарантии, что неизвестный отправитель не пошлет вредоносные сообщения. Однако даже если отправитель известен, вам все равно необходимо всегда подтверждать синтаксис получаемого сообщения. Иначе, дыра в безопасности сайта, которому вы доверяете, может открыть дыру для межсайтового скриптинга на вашем сайте.

    diff --git a/files/ru/web/api/xmlhttprequest/index.html b/files/ru/web/api/xmlhttprequest/index.html index 2d5eb61469..c880307d7d 100644 --- a/files/ru/web/api/xmlhttprequest/index.html +++ b/files/ru/web/api/xmlhttprequest/index.html @@ -431,7 +431,7 @@ translation_of: Web/API/XMLHttpRequest

    Если запрос синхронный, то метод вернет значение только после того, как придет запрос от сервера.

    -
    Примечание: все необходимые слушатели событий (event listeners) должны быть установлены перед вызовом send().
    +
    Примечание: все необходимые обработчики событий должны быть установлены перед вызовом send().
    Примечание: Лучше не использовать параметр ArrayBuffer. Сейчас он не входит в спецификацию XMLHttpRequest. Вместо него можно использовать ArrayBufferView (смотри таблицу совместимости для различных версий).
    -- cgit v1.2.3-54-g00ecf