Доработки curveball

Author: xcurveballx

1-js/09-classes/07-mixins/article.md

@@ -2,21 +2,21 @@
 
 В JavaScript мы можем использовать наследование только от одного объекта. Объект имеет единственный `[[Prototype]]`. И класс может расширить только один другой класс.
 
-Иногда это может ограничивать нас. Например, у нас есть класс `StreetSweeper` и класс `Bicycle`, и хотим создать `StreetSweepingBicycle`.
+Иногда это может ограничивать нас. Например, у нас есть класс `StreetSweeper` и класс `Bicycle`, а мы хотим создать `StreetSweepingBicycle`.
 
-Или, поговорим о программировании, у нас есть класс `Renderer`, который реализует шаблон и класс `EventEmitter` реализующий событие. И мы хотим объединить их функционалы вместе в классе `Page`. Создадим страницу, которая будет использовать шаблон, и использовать событие.
+Или, говоря о программировании, у нас есть класс `Renderer`, который реализует шаблон, и класс `EventEmitter`, реализующий событие. Мы хотели бы объединить их функционал в классе `Page`, чтобы создать страницу, которая будет использовать шаблон и запускать событие.
 
-Для таких случаев существует "примеси".
+Для таких случаев существуют "примеси".
 
-Как говориться в Википедии [примесь](https://ru.wikipedia.org/wiki/%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%81%D1%8C_(%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5)) является классом, который имеет методы и мы можем их использовать в других классов, без необходимости быть родителем этих классов.
+Как говорится в Википедии, [примесь](https://ru.wikipedia.org/wiki/%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%81%D1%8C_(%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5)) является классом, который имеет методы, и мы можем использовать эти методы в других классах, не будучи родителем тех классов.
 
-Другими словами *примесь* определяет методы, которые реализуют определенное поведение. Мы не используем его в одиночку, а используем его, чтобы добавить другим классам больше функционала.
+Другими словами, *примесь* определяет методы, которые реализуют определённое поведение. Мы не используем примесь саму по себе, она нужна, чтобы добавить другим классам больше функционала.
 
 ## Пример примеси
 
-Простой путь создать примесь в JavaScript - это создать объект с использующимися методами, так что мы легко можем объединить их в прототип любого класса.
+Простой путь создания примеси в JavaScript - это создание объекта с полезными методами, так чтобы мы легко могли добавить их в прототип любого класса.
 
-В примере ниже примесь `sayHiMixin` имеет методы для речи класса `User`:
+В примере ниже примесь `sayHiMixin` имеет методы для придания объектам класса `User` возможности вести разговор:
 
 ```js run
 *!*
@@ -43,11 +43,11 @@ class User {
 // копируем методы
 Object.assign(User.prototype, sayHiMixin);
 
-// сейчас User можем сказать hi
+// сейчас User может сказать Hello
 new User("Dude").sayHi(); // Hello Dude!
 ```
 
-Это не наследование, а простой способ скопировать методы. Таким образом, класс `User` может расширять другие классы и так же содержать в себе методы от примеси, например:
+Это не наследование, а просто скопированные методы. Таким образом, класс `User` может расширять другие классы и также содержать в себе методы от примеси, например:
 
 ```js
 class User extends Person {
@@ -91,36 +91,36 @@ class User {
 // копируем методы
 Object.assign(User.prototype, sayHiMixin);
 
-// сейчас User может сказать hi
+// сейчас User может сказать Hello
 new User("Dude").sayHi(); // Hello Dude!
 ```
 
 Обратите внимание, что мы вызвали родительский метод `super.say()` из `sayHiMixin` в прототипе другой примеси, а не в классе.
 
 ![](mixin-inheritance.png)
 
-Это связано с тем, что методы из `sayHiMixin` имеют установку `[[HomeObject]]`. А `super` на самом деле означает `sayHiMixin.__ proto__`, а не `User.__ proto__`.
+Это связано с тем, что методы из `sayHiMixin` имеют установленное свойство `[[HomeObject]]`. А `super` на самом деле означает `sayHiMixin.__ proto__`, а не `User.__ proto__`.
 
-## Примесь события
+## EventMixin
 
 Сейчас давайте создадим примесь для реального случая.
 
-Важная особенность при работе с объектами это работа с событиями.
+Важная особенность при работе с объектами - это работа с событиями.
 
-То есть объект должен иметь метод для «генерации события», когда с ним происходит что-то важное, а другие объекты должны иметь возможность «считывать» такие события.
+То есть, объект должен иметь метод для "генерации события", когда с ним происходит что-то важное, а другие объекты должны иметь возможность "слушать" такие события.
 
-Событие может иметь имя, необязательно, и связь между некоторыми дополнительными данными.
+Событие должно иметь имя и, опционально, какие-то дополнительные данные, ассоциированные с ним.
 
-Например, объект `user` может генерировать события `"login"`, когда посетитель входит. А другой объект `calendar` может захотеть получать его события, чтобы загрузить календарь для вошедшего человека.
+Например, объект `user` может генерировать событие `"login"`, когда посетитель входит. А другой объект `calendar` может захотеть получать событие `"login"`, чтобы загрузить календарь для вошедшего пользователя.
 
-Или `menu` может генерировать событие `"select"`, когда меню элемент выбран, или другие объекты могут захотеть получить эту информацию и отреагировать на это событие.
+Или `menu` может генерировать событие `"select"`, когда элемент меню выбран, а другие объекты могут захотеть получить эту информацию и тоже отреагировать на это событие.
 
-События — это способ «поделиться информацией» со всеми, кто этого захочет. Они могут быть полезны в любом классе, поэтому давайте сделаем для них пример:
+События — это способ "поделиться информацией" со всеми, кто этого захочет. Они могут быть полезны в любом классе, поэтому давайте сделаем для них пример:
 
 ```js run
 let eventMixin = {
   /**
-   * Опишем события, используя:
+   * Подпишемся на событие, используя:
    * menu.on('select', function(item) { ... }
    */
   on(eventName, handler) {
@@ -132,7 +132,7 @@ let eventMixin = {
   },
 
   /**
-   * Закроем событие, используя:
+   * Отменим подписку, используя:
    * menu.off('select', handler)
    */
   off(eventName, handler) {
@@ -146,27 +146,27 @@ let eventMixin = {
   },
 
   /**
-   * Создадим событие и прикрепим данные
+   * Запустим событие и добавим к нему данные
    * this.trigger('select', data1, data2);
    */
   trigger(eventName, ...args) {
     if (!this._eventHandlers || !this._eventHandlers[eventName]) {
-      return; // без обработчиков для этого события
+      return; // обработчиков для этого события нет
     }
 
-    // вызовем обработчиков
+    // вызовем обработчики
     this._eventHandlers[eventName].forEach(handler => handler.apply(this, args));
   }
 };
 ```
 
-И так у нас 3 метода:
+Итак, у нас 3 метода:
 
-1. `.on(eventName, handler)` -- назначили функцию `handler`, чтобы запустить событие с этим именем. И храним обработчиков в свойстве  `_eventHandlers`.
+1. `.on(eventName, handler)` -- назначили функцию `handler`, чтобы обработать событие с заданным именем. Храним обработчики в свойстве  `_eventHandlers`.
 
-2. `.off(eventName, handler)` -- удаляем функцию из списка обработчиков.
+2. `.off(eventName, handler)` -- убираем функцию из списка обработчиков.
 
-3. `.trigger(eventName, ...args)` -- генерируем событие: все назначенные обработчики вызываются и в `args` передаются в качестве аргументов.
+3. `.trigger(eventName, ...args)` -- генерируем событие: все назначенные обработчики вызываются, и `args` передаётся в обработчики в качестве аргумента.
 
 Использование:
 
@@ -182,27 +182,25 @@ Object.assign(Menu.prototype, eventMixin);
 
 let menu = new Menu();
 
-// Вызовем выбранный обработчик:
+// Вызовем обработчик на событие "select":
 *!*
-menu.on("select", value => alert(`Value selected: ${value}`));
+menu.on("select", value => alert(`Выбранное значение: ${value}`));
 */!*
 
-// Запустили событие => покажет выбранное значение: 123
-menu.choose("123"); // значение выбрано
+// Запустили событие => будет показано "Выбранное значение: 123"
+menu.choose("123"); // выбранное значение
 ```
 
-Сейчас у нас есть код, который реагирует на выбор пользователя и мы можем связать его с `menu.on(...)`.
+Если у нас есть код, заинтересованный в событии "select", то мы можем привязать его с помощью `menu.on(...)`.
 
-И `eventMixin` может добавить поведение в любой класс какой мы хотим, без вмешательства в цепочку наследования.
+И `eventMixin` может добавить такое поведение в любой класс без вмешательства в цепочку наследования.
 
 ## Итого
 
 *Примесь* -- общий термин в объектно-ориентированном программировании: класс, который содержит в себе методы для других классов.
 
-В других языках, как Python разрешается создавать примеси используя множественное наследование. JavaScript не поддерживает множественное наследование, но с помощью примесей мы можем реализовать это скопировав методы в прототип.
+В других языках (например, Python) разрешается создавать примеси, используя множественное наследование. JavaScript не поддерживает множественное наследование, но с помощью примесей мы можем реализовать нечто похожее, скопировав методы в прототип.
 
-Мы можем использовать примесь для дополнения множественного поведения классов, например, для обработки события, как мы делали это выше.
+Мы можем использовать примеси для расширения функционала классов, например, для обработки событий, как мы сделали это выше.
 
-Мы так же можем использовать примесь, как способ дополнить любой класс множественным поведением, например, обработкой событий, как мы сделали выше.
-
-С примесями могут быть проблемы, если они будут перезаписывать нативные метода. Стоит помнить это и быть внимательней при назначении имени для примеси, чтобы избежать такую возможность ошибки.
+С примесями могут возникнуть проблемы, если они перезаписывают нативные методы класса. Стоит помнить об этом и быть внимательнее при выборе имён методов для примеси, чтобы избежать конфликтов и ошибок.

1-js/09-classes/07-mixins/head.html

@@ -2,7 +2,7 @@
 let eventMixin = {
 
   /**
-   * Subscribe to event, usage:
+   * Подпишемся на событие, используя:
    *  menu.on('select', function(item) { ... }
   */
   on(eventName, handler) {
@@ -14,7 +14,7 @@
   },
 
   /**
-   * Cancel the subscription, usage:
+   * Отменим подписку, используя:
    *  menu.off('select', handler)
    */
   off(eventName, handler) {
@@ -28,15 +28,15 @@
   },
 
   /**
-   * Generate the event and attach the data to it
+   * Запустим событие и добавим к нему данные
    *  this.trigger('select', data1, data2);
    */
   trigger(eventName, ...args) {
     if (!this._eventHandlers || !this._eventHandlers[eventName]) {
-      return; // no handlers for that event name
+      return; // обработчиков для этого события нет
     }
 
-    // call the handlers
+    // вызовем обработчики
     this._eventHandlers[eventName].forEach(handler => handler.apply(this, args));
   }
 };