Merge pull request vuejs#188 from Alex-Sokolov/master

Правки к обновлению 2.4.0

Author: Alex-Sokolov

src/v2/api/index.md

@@ -83,8 +83,28 @@ type: api
 
   > В версии 2.2.0, этот хук также отслеживает ошибки в хуках жизненного цикла компонентов. Кроме того, при установленном значении `undefined` захваченные ошибки будут зарегистрированы с помощью `console.error` вместо вызова сбоя приложения.
 
+  > В версии 2.4.0, этот хук также отслеживает ошибки, возникающие внутри пользовательских обработчиков событий Vue.
+
   > Сервис отслеживания ошибок [Sentry](https://sentry.io) предлагает [официальную интеграцию](https://sentry.io/for/vue/) с использованием этого свойства.
 
+### warnHandler
+
+> Добавлено в версии 2.4.0
+
+- **Тип:** `Function`
+
+- **По умолчанию:** `undefined`
+
+- **Использование:**
+
+  ``` js
+  Vue.config.warnHandler = function (msg, vm, trace) {
+    // `trace` — это трассировка иерархии компонентов
+  }
+  ```
+
+  Назначает пользовательский обработчик предупреждений Vue во время выполнения. Обратите внимание, что это работает только в версии для разработки и игнорируется в версии для production.
+
 ### ignoredElements
 
 - **Тип:** `Array<string>`
@@ -1086,6 +1106,30 @@ if (version === 2) {
   </my-checkbox>
   ```
 
+### inheritAttrs
+
+> Добавлено в версии 2.4.0
+
+- **Тип:** `boolean`
+
+- **По умолчанию:** `true`
+
+- **Подробности:**
+
+  По умолчанию атрибуты из родительской области видимости, которые не были распознаны как входные параметры, будут "проваливаться" и применяться к корневому элементу дочернего компонента как обычные HTML-атрибуты. При создании компонента, который оборачивает элемент или другой компонент, это не всегда может быть ожидаемым поведением. Устанавливая `inheritAttrs` в `false`, это поведение по умолчанию может быть отключено. Атрибуты доступны через свойство экземпляра `$attrs` (также добавленное в версии 2.4.0) и могут быть явно привязаны к некорневому элементу с использованием `v-bind`.
+
+### comments
+
+> Добавлено в версии 2.4.0
+
+- **Тип:** `boolean`
+
+- **По умолчанию:** `false`
+
+- **Подробности:**
+
+  Когда установлено в значение `true`, будут сохраняться и рендериться HTML-комментарии, найденные в шаблонах. Поведение по умолчанию выбрасывает их.
+
 ## Свойства экземпляра
 
 ### vm.$data
@@ -1261,13 +1305,33 @@ if (version === 2) {
 
 - **См. также:** [SSR. Рендеринг на стороне сервера](../guide/ssr.html)
 
+### vm.$attrs
+
+- **Тип:** `{ [key: string]: string }`
+
+- **Только для чтения**
+
+- **Подробности:**
+
+  Содержит нераспознанные атрибуты, указанные для компонента в родительской области видимости. Если у компонента нет объявленных входных параметров, здесь окажутся все атрибуты, за исключением `class` и `style`. Эти атрибуты можно передавать вниз во внутренние компоненты через `v-bind="$attrs"` — что может быть полезным при создании компонентов высшего порядка (HOC).
+
+### vm.$listeners
+
+- **Тип:** `{ [key: string]: Function | Array<Function> }`
+
+- **Только для чтения**
+
+- **Подробности:**
+
+  Содержит обработчики событий `v-on` из родительской области видимости (без модификаторов `.native`). Они могут быть переданы во внутренние компоненты через `v-on="$listeners"` — что может быть полезным при создании компонентов высшего порядка (HOC).
+
 ## Методы экземпляра — данные
 
 <h3 id="vm-watch">vm.$watch( expOrFn, callback, [options] )</h3>
 
 - **Аргументы:**
   - `{string | Function} expOrFn`
-  - `{Function} callback`
+  - `{Function | Object} callback`
   - `{Object} [options]`
     - `{boolean} deep`
     - `{boolean} immediate`
@@ -1665,9 +1729,9 @@ if (version === 2) {
 
 - **Сокращение:** `@`
 
-- **Принимает:** `Function | Inline-выражение`
+- **Принимает:** `Function | Inline-выражение | Object`
 
-- **Параметр:** `event (обязательный)`
+- **Параметр:** `event`
 
 - **Модификаторы:**
   - `.stop` — вызовет `event.stopPropagation()`.
@@ -1686,6 +1750,8 @@ if (version === 2) {
 
   Прикрепляет к элементу подписчик события. Тип события указывается в параметре. Выражение может быть именем метода, inline-выражением или вовсе отсутствовать, если указан один или несколько модификаторов.
 
+  Начиная с версии `2.4.0`, `v-on` также поддерживает привязку к объекту пар событие/обработчик без аргумента. Обратите внимание, что при использовании синтаксиса объекта не поддерживаются никакие модификаторы.
+
   У обычного элемента можно подписаться только **на нативные события DOM**. У элемента компонента можно также подписаться **на пользовательские события**, вызываемые этим дочерним компонентом.
 
   При работе с нативными событиями DOM, метод получает нативное событие единственным аргументом. В inline-выражениях, можно получить к нему доступ с помощью `$event`: `v-on:click="handle('ok', $event)"`.
@@ -1696,6 +1762,9 @@ if (version === 2) {
   <!-- обработчик метода -->
   <button v-on:click="doThis"></button>
 
+  <!-- синтаксис объекта (2.4.0+) -->
+  <button v-on="{ mousedown: doThis, mouseup: doThat }"></button>
+
   <!-- inline-выражение -->
   <button v-on:click="doThat('hello', $event)"></button>
 

src/v2/guide/installation.md

@@ -2,11 +2,11 @@
 title: Установка
 type: guide
 order: 1
-vue_version: 2.3.0
-dev_size: "247.31"
-min_size: "76.64"
-gz_size: "28.03"
-ro_gz_size: "19.54"
+vue_version: 2.4.0
+dev_size: "257.91"
+min_size: "79.71"
+gz_size: "28.96"
+ro_gz_size: "20.18"
 ---
 
 ### Предупреждение о совместимости

src/v2/guide/join.md

@@ -1,51 +1,51 @@
----
-title: Присоединяйтесь к сообществу Vue.js!
-type: guide
-order: 30
----
-
-Сообщество Vue растёт поразительно быстро, и если вы сейчас читаете эти строки, возможно, что и вы готовы к нему присоединиться. Добро пожаловать на борт!
-
-Ниже мы расскажем, что сообщество может сделать для вас, и что вы можете сделать для сообщества.
-
-## Ресурсы, которые вам понравятся
-
-### Получить поддержку
-
-- [Форум](http://forum.vuejs.org/): Лучшее место для вопросов и ответов по Vue и его экосистеме.
-- [Канал Gitter](https://gitter.im/vuejs/vue): Место встреч и общения разработчиков. Вопросы здесь тоже можно задавать, но форум для них структурно приспособлен лучше.
-- [Github](https://github.com/vuejs): GitHub issues — самое место для багрепортов, feature request'ов, и конечно же pull request'ов!
-
-### Изучение экосистемы
-
-- [Страница The Awesome Vue](https://github.com/vuejs/awesome-vue): Посмотрите, какие ещё клёвые ресурсы были опубликованы другим крутым народом.
-- [Подфорум "Show and Tell"](http://forum.vuejs.org/c/show-and-tell): Ещё одно отличное место чтобы посмотреть на результаты работы других участников растущего сообщества Vue.
-
-## Что вы можете сделать
-
-### Прислать код
-
-Как и у других проектов, здесь есть свои правила. Чтобы удостовериться, что мы сможем помочь вам или принять ваш pull request в кратчайший срок, пожалуйста прочитайте [the contributing guide](https://github.com/vuejs/vue/blob/dev/.github/CONTRIBUTING.md).
-
-После этого, вы будете готовы прислать код как в основные репозитории Vue:
-
-- [Vue](https://github.com/vuejs/vue): ядро фреймворка
-- [Vuex](https://github.com/vuejs/vuex): Flux-подобная система управления состоянием
-- [Vue-router](https://github.com/vuejs/vue-router): роутер для SPA
-
-...так и во множество небольших официальных [сопутствующих библиотек](https://github.com/vuejs).
-
-### Поделитесь своим опытом (и получите его)
-
-Помимо вопросов и ответов на форуме и в канале Gitter, существуют и менее очевидные возможности поделиться имеющимися знаниями и приобрести новые:
-
-- **Создавайте обучающие материалы.** Часто говорят, что лучший способ научиться — это научить. Если вы делаете с Vue что-то интересное, не стесняйтесь написать об этом пост в блоге, провести воркшоп или просто опубликовать в соцсети ссылку на gist.
-- **Подпишитесь как наблюдатель на интересующий вас репозиторий.** Таким образом вы сможете получать уведомления каждый раз, когда в этом репозитории будет что-нибудь происходить, что даст вам инсайдерскую информацию о происходящих обсуждениях и грядущих нововведениях. Это — прекрасная возможность набраться опыта, который поможет в дальнейшем.
-
-### Переведите документацию
-
-Vue уже распространился по планете: основная команда разработчиков распределена в как минимум полудюжине временных зон. [Форум](http://forum.vuejs.org/) включает разделы на 7 языках, а документация — имеет многие [активно поддерживаемые переводы](https://github.com/vuejs?utf8=%E2%9C%93&query=vuejs.org). Мы гордимся международным развитием Vue — но всё может быть ещё лучше!
-
-Мы надеемся, что сейчас вы читаете это предложение на своём родном языке. Если нет — может быть, вы хотели бы помочь с переводом?
-
-В этом случае, просто форкните репозиторий [основной документации](https://github.com/vuejs/vuejs.org/) или любой другой официально поддерживаемой документации, и начните перевод. По достижении некоторого прогресса, откройте issue или pull request в основном репозитории, и мы позовём ещё кого-нибудь вам в помощь.
+---
+title: Присоединяйтесь к сообществу Vue.js!
+type: guide
+order: 30
+---
+
+Сообщество Vue растёт поразительно быстро, и если вы сейчас читаете эти строки, возможно, что и вы готовы к нему присоединиться. Добро пожаловать на борт!
+
+Ниже мы расскажем, что сообщество может сделать для вас, и что вы можете сделать для сообщества.
+
+## Ресурсы, которые вам понравятся
+
+### Получить поддержку
+
+- [Форум](http://forum.vuejs.org/): Лучшее место для вопросов и ответов по Vue и его экосистеме.
+- [Чат](https://chat.vuejs.org/): Место встреч и общения Vue разработчиков и чат в реальном времени.
+- [Github](https://github.com/vuejs): GitHub issues — самое место для багрепортов, feature request'ов, и конечно же pull request'ов!
+
+### Изучение экосистемы
+
+- [Страница The Awesome Vue](https://github.com/vuejs/awesome-vue): Посмотрите, какие ещё клёвые ресурсы были опубликованы другим крутым народом.
+- [Подфорум "Show and Tell"](http://forum.vuejs.org/c/show-and-tell): Ещё одно отличное место чтобы посмотреть на результаты работы других участников растущего сообщества Vue.
+
+## Что вы можете сделать
+
+### Прислать код
+
+Как и у других проектов, здесь есть свои правила. Чтобы удостовериться, что мы сможем помочь вам или принять ваш pull request в кратчайший срок, пожалуйста прочитайте [the contributing guide](https://github.com/vuejs/vue/blob/dev/.github/CONTRIBUTING.md).
+
+После этого, вы будете готовы прислать код как в основные репозитории Vue:
+
+- [Vue](https://github.com/vuejs/vue): ядро фреймворка
+- [Vuex](https://github.com/vuejs/vuex): Flux-подобная система управления состоянием
+- [Vue-router](https://github.com/vuejs/vue-router): роутер для SPA
+
+...так и во множество небольших официальных [сопутствующих библиотек](https://github.com/vuejs).
+
+### Поделитесь своим опытом (и получите его)
+
+Помимо вопросов и ответов на форуме и в чате, существуют и менее очевидные возможности поделиться имеющимися знаниями и приобрести новые:
+
+- **Создавайте обучающие материалы.** Часто говорят, что лучший способ научиться — это научить. Если вы делаете с Vue что-то интересное, не стесняйтесь написать об этом пост в блоге, провести воркшоп или просто опубликовать в соцсети ссылку на gist.
+- **Подпишитесь как наблюдатель на интересующий вас репозиторий.** Таким образом вы сможете получать уведомления каждый раз, когда в этом репозитории будет что-нибудь происходить, что даст вам инсайдерскую информацию о происходящих обсуждениях и грядущих нововведениях. Это — прекрасная возможность набраться опыта, который поможет в дальнейшем.
+
+### Переведите документацию
+
+Vue уже распространился по планете: основная команда разработчиков распределена в как минимум полудюжине временных зон. [Форум](http://forum.vuejs.org/) включает разделы на 7 языках, а документация — имеет многие [активно поддерживаемые переводы](https://github.com/vuejs?utf8=%E2%9C%93&query=vuejs.org). Мы гордимся международным развитием Vue — но всё может быть ещё лучше!
+
+Мы надеемся, что сейчас вы читаете это предложение на своём родном языке. Если нет — может быть, вы хотели бы помочь с переводом?
+
+В этом случае, просто форкните репозиторий [основной документации](https://github.com/vuejs/vuejs.org/) или любой другой официально поддерживаемой документации, и начните перевод. По достижении некоторого прогресса, откройте issue или pull request в основном репозитории, и мы позовём ещё кого-нибудь вам в помощь.