Merge pull request vuejs#45 from airyboy/master

Airyboy-api-fixes

Author: gbezyuk

src/v2/api/index.md

@@ -574,7 +574,7 @@ type: api
 
   Если строка начинается с `#`, она будет использована как querySelector, а в качестве строкового шаблона будет использован innerHTML элемента с указанным id. Так вы сможете включать шаблоны, из тегов вроде `<script type="x-template">`.
 
-  <p class="tip">Чтобы оставаться в безопасности, используйте только те шаблоны Vue, которым можете доверять. Никогда не используйте в качестве шаблона данные, вводимые пользователем.</p>
+  <p class="tip">С точки зрения безопасности необходимо использовать только те шаблоны Vue, которым вы можете доверять. Никогда не используйте в качестве шаблона данные, вводимые пользователем.</p>
 
 - **См. также:**
   - [Диаграмма жизненного цикла](../guide/instance.html#Диаграмма-жизненного-цикла)
@@ -595,6 +595,8 @@ type: api
 
 ## Опции — хуки жизненного цикла
 
+Хук (hook - буквально "крючок"), функция, вызывающаяся в определенный момент жизненного цикла сущности, например, непосредственно перед или после создания компонента Vue. Хук позволяет расширить или изменить стандартное поведение на пользовательское.
+
 Контекст `this` хуков указывает на инстанс Vue c данными, вычисляемыми свойствами и методами. Это значит, что __вам не следует использовать стрелочные функции для определения хуков жизненного цикла__ (напр. `created: () => this.fetchTodos()`). Поскольку стрелочные функции связываются с родительским контекстом, `this` не будет указывать на инстанс Vue, и `this.fetchTodos` окажется неопределенным.
 
 ### beforeCreate
@@ -765,7 +767,7 @@ type: api
 
 - **Подробности:**
 
-  Указывает новому инстансу на родительский и устанавливает отношение "родитель-ребёнок" между ними. Родительский элемент будет доступен дочернему в `this.$parent`, а дочерний элемент будет добавлен в массив `$children` родителя.
+  Определяет родительский инстанс для создаваемого. Устанавливает отношение "родитель-ребёнок" между ними. Родитель будет доступен дочернему инстансу посредством `this.$parent`, а дочерний инстанс будет добавлен в массив `$children` родителя.
 
   <p class="tip">Старайтесь реже использовать `$parent` и `$children` — этот механизм мы предусмотрели на крайний случай. Для общения между родителем и ребёнком лучше использовать свойства и события.</p>
 
@@ -775,9 +777,9 @@ type: api
 
 - **Подробности:**
 
-  Массив объектов-миксинов. Миксины могут содержать те же опции, что и обычные объекты инстансов Vue — они будут добавлены к основным опциям согласно логике `Vue.extend()`. Например, если и миксин и объект оба содержат хук `created`, вызваны будут они оба.
+  Массив объектов-примесей. Примеси могут содержать те же опции, что и обычные объекты инстансов Vue — они будут добавлены к основным опциям согласно логике `Vue.extend()`. Например, если и примесь и объект оба содержат хук `created`, вызваны будут они оба.
 
-  Хуки миксинов вызываются в порядке их определения, до вызова собственных хуков компонента.
+  Хуки примесей вызываются в порядке их определения, до вызова собственных хуков компонента.
 
 - **Пример:**
 
@@ -793,7 +795,7 @@ type: api
   // -> 2
   ```
 
-- **См. также:** [Миксины](../guide/mixins.html)
+- **См. также:** [Примеси](../guide/mixins.html)
 
 ### name
 
@@ -803,9 +805,9 @@ type: api
 
 - **Подробности:**
 
-  Название компонента. Позволяет компоненту рекурсивно вызывать самого себя в шаблоне. Обратите внимание что когда компонент регистрируется глобально посредством `Vue.component()`, глобальный ID автоматически становится таким же, как и имя.
+  Название компонента. Позволяет компоненту рекурсивно вызывать самого себя в шаблоне. Обратите внимание что когда компонент регистрируется глобально посредством `Vue.component()`, глобальный ID автоматически устанавливается равным его имени.
 
-  Кроме того, компоненты с указанным `name` проще отлаживать из-за более понятных сообщений в консоли. В [vue-devtools](https://github.com/vuejs/vue-devtools) все безымянные компоненты довольно неинформативно называются `<AnonymousComponent>`. Когда у компонентов указано `name`, дерево компонентов становится куда понятнее.
+  Кроме того, компоненты с указанным `name` проще отлаживать из-за более понятных сообщений в консоли. В [vue-devtools](https://github.com/vuejs/vue-devtools) все безымянные компоненты довольно неинформативно называются `<AnonymousComponent>`. Указание имён для компонентов значительно улучшает ситуацию.
 
 ### extends
 
@@ -855,7 +857,7 @@ type: api
 
 - **Подробности:**
 
-  Превращает компонент в функциональный, то есть не имеющий собственного состояния (`data`) и своего инстанса (`this`). Такие компоненты по сути — просто функция `render`, возвращающая узлы виртуального DOM. Это сильно ускоряет их рендер.
+  Превращает компонент в функциональный, то есть не имеющий собственного состояния (`data`) и своего инстанса (`this`). Такие компоненты по сути — просто функция `render`, возвращающая узлы виртуального DOM. Это сильно ускоряет их рендеринг.
 
 - **См. также:** [Функциональные компоненты](../guide/render-function.html#Функциональные-компоненты)
 
@@ -938,7 +940,7 @@ type: api
 
 - **Подробности:**
 
-  Используется для доступа к контенту, [распространяемому слотами](../guide/components.html#Дистрибьюция-контента-через-слоты). У каждого [именованного слота](../guide/components.html#Именованные-слоты) есть соответствующее значение (например, содержимое `slot="foo"` попадёт в `vm.$slots.foo`). Свойство `default` содержит узлы, не включённые в именованные слоты.
+  Используется для доступа к контенту, [распределяемому слотами](../guide/components.html#Дистрибьюция-контента-через-слоты). У каждого [именованного слота](../guide/components.html#Именованные-слоты) есть соответствующее значение (например, содержимое `slot="foo"` попадёт в `vm.$slots.foo`). Свойство `default` содержит узлы, не включённые в именованные слоты.
 
   Особенно полезно `vm.$slots` в компонентах с [render-функциями](../guide/render-function.html).
 
@@ -1041,7 +1043,7 @@ type: api
 
 - **Использование:**
 
-  Запускает слежение за выражением или вычисляемой функцией на предмет изменений. В параметры коллбэка будут переданы новые и старые значения отслеживаемого объекта. Выражение может быть только простым путём до переменной с разделителями-точками. Для более сложных случаев используйте функцию.
+  Запускает наблюдение за выражением или вычисляемой функцией на предмет изменений. В параметры коллбэка будут переданы новое и старое значения отслеживаемого объекта. Выражение может быть только простым путём до переменной с разделителями-точками. Для более сложных случаев используйте функцию.
 
 <p class="tip">Обратите внимание: когда изменяете (а не заменяете) объект или массив, старое и новое значения при вызове коллбэка будут совпадать, так как они ссылаются на один и тот же объект или массив. Vue не сохраняяет копии объекта на момент, предшествовавший изменениям.</p>
 
@@ -1086,7 +1088,7 @@ type: api
 
 - **Опция: immediate**
 
-  Если передано `immediate: true`, коллбэк будет вызван сразу же после начала слежения с текущим значением выражения:
+  Если передано `immediate: true`, коллбэк будет вызван сразу же после начала наблюдения с текущим значением выражения:
 
   ``` js
   vm.$watch('a', callback, {
@@ -1132,7 +1134,7 @@ type: api
 
 - **Использование:**
 
-  Реагирует на пользовательское событие текущего vm. Такое событие можно вызвать функцией `vm.$emit`. Коллбэк получит все дополнительные аргументы, переданные этому методу.
+  Создает подписку на пользовательское событие текущего vm. Такое событие можно породить функцией `vm.$emit`. Коллбэк получит все дополнительные аргументы, переданные этому методу.
 
 - **Пример:**
 
@@ -1152,7 +1154,7 @@ type: api
 
 - **Использование:**
 
-  Реагирует на пользовательское событие один раз. После первого использования подписчик будет удалён.
+  Создает подписку на пользовательское событие, но срабатывает только один раз. После первого же использования подписчик будет удалён.
 
 <h3 id="vm-off">vm.$off( [event, callback] )</h3>
 
@@ -1176,7 +1178,7 @@ type: api
   - `{string} event`
   - `[...args]`
 
-  Вызывает событие в текущем инстансе. Все дополнительно указанные параметры будут переданы в коллбэк подписки.
+  Порождает событие в текущем инстансе. Все дополнительно указанные параметры будут переданы в коллбэк подписки.
 
 ## Методы инстанса — жизненный цикл
 
@@ -1264,7 +1266,7 @@ type: api
 
 - **Использование:**
 
-  Полностью уничтожает vm. Очищает связи с другими существующими vm, отвязывает директивы, выключает все подписки на события.
+  Полностью уничтожает vm. Очищает связи с другими существующими vm, отвязывает директивы, отменяет все подписки на события.
 
   Вызывает хуки `beforeDestroy` и `destroyed`.
 
@@ -1300,7 +1302,7 @@ type: api
 
   Управляет HTML-содержимым элемента (`innerHTML`). **Обратите внимание, что содержимое вставляется как обычный HTML — то есть не компилируется как шаблон Vue**. Не стоит организовывать вложенные шаблоны с помощью `v-html`, попробуйте лучше применить компоненты.
 
-  <p class="tip">Динамический рендер произвольного HTML-кода на сайте — это очень опасно, так как легко приводит к [XSS-атакам](https://en.wikipedia.org/wiki/Cross-site_scripting). Передавайте в `v-html` только доверенный код, **никогда** не передавайте сюда ничего, предоставленного пользователями.</p>
+  <p class="tip">Динамический рендеринг произвольного HTML-кода на сайте — это очень опасная практика, легко приводящая к уязвимостям к [XSS-атакам](https://en.wikipedia.org/wiki/Cross-site_scripting). Передавайте в `v-html` только содержимое, которому можно доверять, и **никогда** - необработанный пользовательский ввод.</p>
 
 - **Пример:**
 
@@ -1328,7 +1330,9 @@ type: api
 
 - **Использование:**
 
-  Если указанное значение истинное, рендерит элемент, а если ложное — не рендерит. Когда значение переключается, элемент и содержащиеся в нём компоненты с директивами уничтожаются или пересоздаются. Если элемент — `<template>`, вместо элемента будет отрендерено его содержимое. Это нужно, чтобы завернуть в один v-if несколько элементов сразу.
+  Осуществляет рендеринг элемента, только если передаваемое выражение истинно. При изменении значения выражения на противоположное, элемент и содержащиеся в нём компоненты и директивы уничтожаются/пересоздаются. Если элемент — `<template>`, вместо него будет отрендерено его содержимое.
+
+  Эта директива также запускает анимационные переходы при изменении условия.
 
 
 - **См. также:** [Условный рендер — v-if](../guide/conditional.html)
@@ -1400,7 +1404,7 @@ type: api
   </div>
   ```
 
-   Кроме того, вы можете указать название для индекса (или ключа, если вы работаете с хэшем):
+   Кроме того, вы можете указать название для индекса (или ключа, если вы работаете с объектом):
 
   ``` html
   <div v-for="(item, index) in items"></div>