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

gbezyuk · web-flow · commit 6ccff759a9bc · 2016-12-09T15:17:36.000+02:00
Просмотрел страницу API
diff --git a/src/v2/api/index.md b/src/v2/api/index.md
diff --git a/src/v2/guide/comparison.md b/src/v2/guide/comparison.md
@@ -237,7 +237,7 @@ MobX стал довольно популярным в сообществе Reac
 
 ### Сложность
 
-Vue значительно проще Angular, как в смысле API, так и в смысле архитектуры. Получение достаточных знаний для написания нетривиальных приложений обычно происходит менее чем за день, чего нельзя сказать об Angular. 
+Vue значительно проще Angular, как в смысле API, так и в смысле архитектуры. Получение достаточных знаний для написания нетривиальных приложений обычно происходит менее чем за день, чего нельзя сказать об Angular.
 
 ### Гибкость и модульность
 
@@ -327,4 +327,4 @@ Riot 2.0 предлагает похожую модель разработки,
 - Значительно более мощный роутер. API роутинга Riot'а — предельно минималистичен.
 - Поддержка более зрелого инструментария. Vue официально поддерживает [Webpack](https://github.com/vuejs/vue-loader), [Browserify](https://github.com/vuejs/vueify), и [SystemJS](https://github.com/vuejs/systemjs-plugin-vue), в то время как Riot полагается в вопросах интеграции с системами сборки на поддержку сообщества.
 - [Система анимации переходов](transitions.html). У Riot её просто нет.
-- Лучшая производительность. [Несмотря на заявленное](https://github.com/vuejs/vuejs.org/issues/346) использование virtual DOM, в действительности Riot применяет dirty checking, и потому страдает от тех же проблем, что и Angular 1.
+- Лучшая производительность. [Несмотря на заявленное](https://github.com/vuejs/vuejs.org/issues/346) использование virtual DOM, в действительности Riot применяет dirty checking, и потому страдает от тех же проблем, что и Angular 1.
diff --git a/src/v2/guide/components.md b/src/v2/guide/components.md
@@ -268,7 +268,7 @@ new Vue({
 
 ### camelCase против kebab-case
 
-Аттрибуты HTML являются регистронезависимыми, так что **при использовании в DOM в качестве шаблона** вместо camelCase-версий имён входных параметров приходится применять их kebab-case эквиваленты (разделять слова дефисом):
+Атрибуты HTML являются регистронезависимыми, так что **при использовании в DOM в качестве шаблона** вместо camelCase-версий имён входных параметров приходится применять их kebab-case эквиваленты (разделять слова дефисом):
 
 ``` js
 Vue.component('child', {
@@ -982,7 +982,7 @@ var child = parent.$refs.profile
 
 ### Асинхронные компоненты
 
-В крупных приложениях может возникнуть необходимость в разделении приложения на небольшие куски и подгружать компонент с сервера, только когда он необходим. Для упрощения подобных сценариев, Vue позволяет определить компонент как функцию-фабрику, асинхронно возвращающую определение компонента. Vue вызовет фабричную функцию только тогда, когда компонент действительно понадобится, и закэширует результат для дальнейшего использования. Например:
+В крупных приложениях может возникнуть необходимость в разделении приложения на небольшие куски и подгружать компонент с сервера, только когда он необходим. Для упрощения подобных сценариев, Vue позволяет определить компонент как функцию-фабрику, асинхронно возвращающую определение компонента. Vue вызовет фабричную функцию только тогда, когда компонент действительно понадобится, и закеширует результат для дальнейшего использования. Например:
 
 ``` js
 Vue.component('async-example', function (resolve, reject) {
@@ -1164,7 +1164,7 @@ Vue.component('hello-world', {
 
 ### "Дешёвые" статические компоненты с использованием `v-once`
 
-Рендеринг простых элементов HTML во Vue происходит очень быстро, но иногда возникают компоненты с **большим** количеством статических данных. В таких случаях добавление директивы `v-once` в корневом элементе позволяет удостовериться, что все вычисления будут произведены лишь единожды, а дальнейшая работа будет происходить с кэшем, например таким образом:
+Рендеринг простых элементов HTML во Vue происходит очень быстро, но иногда возникают компоненты с **большим** количеством статических данных. В таких случаях добавление директивы `v-once` в корневом элементе позволяет удостовериться, что все вычисления будут произведены лишь единожды, а дальнейшая работа будет происходить с кешем, например таким образом:
 
 ``` js
 Vue.component('terms-of-service', {
diff --git a/src/v2/guide/deployment.md b/src/v2/guide/deployment.md
@@ -44,7 +44,7 @@ module.exports = {
 NODE_ENV=production browserify -g envify -e main.js | uglifyjs -c -m > build.js
 ```
 
-- Для выноса стилей в отдельный css-файл, используйте плагин extract-css, включённый во vueify.
+- Для выноса стилей в отдельный CSS-файл, используйте плагин extract-css, включённый во vueify.
 
 ``` bash
 NODE_ENV=production browserify -g envify -p [ vueify/plugins/extract-css -o build.css ] -e main.js | uglifyjs -c -m > build.js
@@ -58,4 +58,4 @@ NODE_ENV=production browserify -g envify -p [ vueify/plugins/extract-css -o buil
 
 При использовании в разработке [однофайловых компонентов](./single-file-components.html), теги `<style>` обновляются автоматически. Для "боевого" окружения вы можете захотеть поместить все стили в единый CSS-файл. Детальную информацию о том как это сделать можно получить в документации [vue-loader](http://vue-loader.vuejs.org/en/configurations/extract-css.html) и [vueify](https://github.com/vuejs/vueify#css-extraction).
 
-Официальный шаблон `webpack` для `vue-cli` уже содержит готовую конфигурацию для экстрации стилей.
+Официальный шаблон `webpack` для `vue-cli` уже содержит готовую конфигурацию для экстрации стилей.
diff --git a/src/v2/guide/index.md b/src/v2/guide/index.md
@@ -88,7 +88,7 @@ var app2 = new Vue({
 </script>
 {% endraw %}
 
-Здесь мы встречаемся с кое-чем новым. Аттрибут `v-bind`, который вы видите, называется **директивой**. Директивы имеют префикс `v-`, указывающий на их особую природу. Как вы уже могли догадаться, они применяют к отображаемому DOM особое реактивное поведение, управляемое Vue. В данном примере директива говорит "сохраняй значение title этого элемента актуальным при изменении свойства `message` у инстанса Vue".
+Здесь мы встречаемся с кое-чем новым. Атрибут `v-bind`, который вы видите, называется **директивой**. Директивы имеют префикс `v-`, указывающий на их особую природу. Как вы уже могли догадаться, они применяют к отображаемому DOM особое реактивное поведение, управляемое Vue. В данном примере директива говорит "сохраняй значение title этого элемента актуальным при изменении свойства `message` у инстанса Vue".
 
 Если вы снова откроете консоль JavaScript и введёте `app2.message = 'какое-то новое сообщение'`, вы опять-таки увидите, что связанный код HTML — в данном случае, атрибут `title` — обновился.
 
diff --git a/src/v2/guide/instance.md b/src/v2/guide/instance.md
@@ -73,7 +73,7 @@ vm.$watch('a', function (newVal, oldVal) {
 })
 ```
 
-<p class="tip">Не используйте [arrow-функции](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Functions/Arrow_functions) в свойствах инстанса и в коллбэках (напр. `vm.$watch('a', newVal => this.myMethod())`). Поскольку arrow-функции связываются с родительским контекстом, `this` не будет указывать на инстанс Vue, и `this.myMethod` окажется неопределённым.</p>
+<p class="tip">Не используйте [стрелочные функции](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Functions/Arrow_functions) в свойствах инстанса и в коллбэках (напр. `vm.$watch('a', newVal => this.myMethod())`). Поскольку стрелочные функции связываются с родительским контекстом, `this` не будет указывать на инстанс Vue, и `this.myMethod` окажется неопределённым.</p>
 
 Полный список свойств и методов инстанса Vue есть в [справочнике API](../api).
 
@@ -88,10 +88,10 @@ var vm = new Vue({
   },
   created: function () {
     // `this` указывает на инстанс vm
-    console.log('a is: ' + this.a)
+    console.log('Значение a: ' + this.a)
   }
 })
-// -> "a is: 1"
+// -> "Значение a: 1"
 ```
 
 Существуют также другие хуки, вызываемые на различных стадиях жизненного цикла инстанса, например `mounted`, `updated` и `destroyed`. Все хуки вызываются с контекстной переменной `this`, ссылающейся на вызывающий инстанс Vue. Возможно, вы недоумевали: где же в мире Vue живут контроллеры? Ответ на этот вопрос таков: контроллеров не существует. Всё пользовательское поведение компонента должно быть размещено в этих хуках.
diff --git a/src/v2/guide/transitions.md b/src/v2/guide/transitions.md
@@ -86,9 +86,9 @@ new Vue({
 
 1. Vue автоматически узнаёт, применены ли к целевому элементу CSS-переходы или анимации. Если да, соответствующие CSS-классы будут должным образом обновлены в нужные моменты времени.
 
-2. Если для компонента указаны [хуки JavaScript](#JavaScript-Hooks), они будут вызваны в соответствующие момент времени.
+2. Если для компонента указаны [хуки JavaScript](#JavaScript-Hooks), они будут вызваны в соответствующие моменты времени.
 
-3. Если не обнаружено ни CSS-переходов/анимаций, ни JavaScript-хуков, операции DOM для вставки/удаления элемента будут выполнены непосредственно в следующем анимационном фрейме (Важно: речь идёт об анимационном фрейме браузера, отличном от используемой во Vue концепции `nextTick`).
+3. Если не обнаружено ни CSS-переходов/анимаций, ни JavaScript-хуков, операции DOM для вставки/удаления элемента будут выполнены непосредственно в следующем анимационном фрейме (важно: речь идёт об анимационном фрейме браузера, отличном от используемой во Vue концепции `nextTick`).
 
 ### Классы переходов
 
@@ -381,7 +381,7 @@ new Vue({
 
 Для того чтобы Vue знал о завершении перехода, ему требуется установка слушателей событий. В зависимости от используемых правил CSS, событием будет либо `transitionend`, либо `animationend`. Если вы используете только один из подходов, Vue определит правильный тип автоматически.
 
-Однако, иногда может потребоваться использование обоих подходов на одном элементе. Например, CSS-анимация под управлением Vue при появлении/исчезновении элемента может соседствовать с эффектом CSS-перехода при наведении курсора мыши на элемент. В таких случаях потребуется явное указание типа события, на которое должен будет ориентироваться Vue. Аттрибут `type` может получить значение `animation` или `transition`.
+Однако, иногда может потребоваться использование обоих подходов на одном элементе. Например, CSS-анимация под управлением Vue при появлении/исчезновении элемента может соседствовать с эффектом CSS-перехода при наведении курсора мыши на элемент. В таких случаях потребуется явное указание типа события, на которое должен будет ориентироваться Vue. Атрибут `type` может получить значение `animation` или `transition`.
 
 ### JavaScript-хуки
 
@@ -1652,4 +1652,4 @@ new Vue({
 </script>
 {% endraw %}
 
-Наконец, больше всего возможностей для создания динамических переходов предоставляет создание компонентов, принимающих входные параметры, определяющие природу используемых переходов. Звучит избито, но всё равно — только ваше воображение здесь задаёт рамки.
+Наконец, больше всего возможностей для создания динамических переходов предоставляет создание компонентов, принимающих входные параметры, определяющие природу используемых переходов. Звучит избито, но всё равно — только ваше воображение здесь задаёт рамки.
