Skip to content

Commit 02d0647

Browse files
authored
Merge pull request vuejs#3 from translation-gang/master
Update
2 parents 84e861e + 3a83c5c commit 02d0647

File tree

9 files changed

+38
-41
lines changed

9 files changed

+38
-41
lines changed

src/v2/examples/select2.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Создание компонента-обертки
2+
title: Компонент-обертка
33
type: examples
44
order: 8
55
---

src/v2/guide/class-and-style.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ order: 6
1010

1111
### Использование объектов
1212

13-
Для динамического включения или выключения классов мы можем передать в директиву `v-bind:class` объект:
13+
Для динамического задания или удаления CSS классов мы можем передать в директиву `v-bind:class` объект:
1414

1515
``` html
1616
<div v-bind:class="{ active: isActive }"></div>
@@ -105,7 +105,7 @@ data: {
105105

106106
В этом случае 'errorClass' будет применён к элементу всегда, а `activeClass` — только в случае истинности `isActive`.
107107

108-
Однако, такая запись быстро становится громоздкой. Поэтому можно использовать и смешанный синтаксис:
108+
Однако, такая запись становится слегка громоздкой, если у вас есть несколько классов, задаваемых по условию. Поэтому можно использовать и смешанный синтаксис:
109109

110110
``` html
111111
<div v-bind:class="[{ active: isActive }, errorClass]">
@@ -115,7 +115,7 @@ data: {
115115

116116
> Эта секция предполагает знакомство с [компонентами Vue](components.html). Вы можете спокойно пропустить её сейчас и вернуться позднее.
117117
118-
При применении атрибута `class` к пользовательскому компоненту, классы будут добавлены к его корневому элементу. Собственные классы компонента при этом потеряны не будут.
118+
При применении атрибута `class` к пользовательскому компоненту, классы будут добавлены к его корневому элементу. Собственные классы элемента при этом потеряны не будут.
119119

120120
Возьмём, к примеру, такой компонент:
121121

@@ -165,7 +165,7 @@ data: {
165165
}
166166
```
167167

168-
Передача объекта стилей по имени нередко может сделать код проще для понимания:
168+
Передача объекта стилей по имени нередко может сделать код чище:
169169

170170
``` html
171171
<div v-bind:style="styleObject"></div>
@@ -191,4 +191,4 @@ data: {
191191

192192
### Автоматические префиксы
193193

194-
При использовании в `v-bind:style` свойств CSS, требующих указания вендорных префиксов, Vue автоматически определит это и добавит необходимые префиксы к применяемым стилям.
194+
При использовании в `v-bind:style` свойств CSS, требующих указания вендорных префиксов, Vue автоматически определит это и добавит подходящие префиксы к применяемым стилям.

src/v2/guide/components.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1085,10 +1085,8 @@ template: '<div><stack-overflow></stack-overflow></div>'
10851085
Компонент, подобный вышеописанному, породит ошибку переполнения стека, поэтому обязательно удостоверьтесь, что рекурсивный вызов является условным (т.е. использует директиву `v-if`, которая рано или поздно станет ложной).
10861086

10871087
### Кольцевые ссылки между компонентами
1088-
### Circular References Between Components
10891088

10901089
Предположим вы конструируете каталог файлов в виде дерева, подобный Finder или Проводнику. У вас возможно есть компонент `tree-folder` с таким шаблоном:
1091-
Let's say you're building a file directory tree, like in Finder or File Explorer. You might have a `tree-folder` component with this template:
10921090

10931091
``` html
10941092
<p>
@@ -1098,7 +1096,6 @@ Let's say you're building a file directory tree, like in Finder or File Explorer
10981096
```
10991097

11001098
Затем компонент `tree-folder-contents` с таким шаблоном:
1101-
Then a `tree-folder-contents` component with this template:
11021099

11031100
``` html
11041101
<ul>

src/v2/guide/computed.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -181,9 +181,9 @@ computed: {
181181

182182
Теперь запись `vm.fullName = 'Иван Иванов'` вызовет сеттер, и `vm.firstName` и `vm.lastName` будут соответствующим образом обновлены.
183183

184-
## Методы слежения
184+
## Методы-наблюдатели
185185

186-
Хотя в большинстве случаев лучше использовать вычисляемые свойства, иногда методы слежения всё же необходимы. Поэтому Vue предоставляет опцию `watch`, позволяющую как угодно реагировать на изменения в данных. Полезнее всего эта возможность оказывается для дорогих или асинхронных операций
186+
Хотя в большинстве случаев лучше использовать вычисляемые свойства, иногда пользовательские методы-наблюдатели всё же необходимы. Поэтому Vue предоставляет более общий путь для реагирования на изменения в данных через опцию `watch`. Полезнее всего эта возможность оказывается для дорогих или асинхронных операций, выполняемых в ответ на изменение данных.
187187

188188
Рассмотрим пример:
189189

@@ -241,7 +241,7 @@ var watchExampleVM = new Vue({
241241
vm.answer = 'Ошибка! Не могу связаться с API. ' + error
242242
})
243243
},
244-
// Это количество миллисекунд, после которого мы считаем, что пользователь прекратил печатать:
244+
// Это число миллисекунд, которое мы ждем, после того как пользователь прекратил печатать:
245245
500
246246
)
247247
}

src/v2/guide/deployment.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -54,8 +54,8 @@ NODE_ENV=production browserify -g envify -p [ vueify/plugins/extract-css -o buil
5454

5555
Если при рендеринге компонента произойдёт ошибка, она будет передана в глобальную функцию `Vue.config.errorHandler`, если таковая была указана. Использование этого хука в связке с сервисом отслеживания ошибок, например с [Sentry](https://sentry.io), может быть неплохой идеей — тем более, что [интеграция с Vue официально поддерживается](https://sentry.io/for/vue/).
5656

57-
## Экстракция CSS
57+
## Извлечение CSS
5858

59-
При использовании в разработке [однофайловых компонентов](./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).
59+
При использовании в разработке [однофайловых компонентов](./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).
6060

61-
Официальный шаблон `webpack` для `vue-cli` уже содержит готовую конфигурацию для экстрации стилей.
61+
Официальный шаблон `webpack` для `vue-cli` уже содержит готовую конфигурацию для извлечения стилей.

src/v2/guide/events.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@ type: guide
44
order: 9
55
---
66

7-
## Наблюдение за событиями
7+
## Подписка на события
88

9-
Для наблюдения за событиями DOM и запуска JavaScript-кода при их наступлении можно применить директиву `v-on`.
9+
Для подписки на события DOM и выполнения JavaScript-кода по их наступлении можно применить директиву `v-on`.
1010

1111
Например:
1212

@@ -44,7 +44,7 @@ var example1 = new Vue({
4444

4545
## Обработчики событий
4646

47-
Логика обработки события может быть довольно сложной, так что оставить весь код JavaScript в значении атрибута `v-on` попросту не всегда возможно. На этот случай `v-on` может принять и название метода, который вы бы хотели вызвать.
47+
Логика обработки события может быть довольно сложной, так что оставить весь код JavaScript в значении атрибута `v-on` попросту не всегда возможно. На этот случай `v-on` может принять и название метода, который вы хотите вызвать.
4848

4949
Например:
5050

@@ -248,7 +248,7 @@ Vue.config.keyCodes.f1 = 112
248248
<div @click.ctrl="doSomething">Сделать что-нибудь</div>
249249
```
250250

251-
## Почему слушатели указываются в HTML?
251+
## Почему подписчики указываются в HTML?
252252

253253
Может показаться, что такой подход к отслеживанию событий нарушает старое доброе правило "разделения мух и котлет". Будьте уверены — поскольку все обработчики во Vue строго связываются с ответственным за текущее представление инстансом vm, трудностей в поддержке не возникает. На практике, есть даже несколько преимуществ при использовании `v-on`:
254254

src/v2/guide/list.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -125,7 +125,7 @@ var example2 = new Vue({
125125
</ul>
126126
```
127127

128-
### Итерирование по объекту посредством v-for
128+
### v-for для объекта
129129

130130
`v-for` можно также использовать для итерирования по свойствам объекта:
131131

@@ -188,11 +188,11 @@ new Vue({
188188
</div>
189189
```
190190

191-
<p class="tip">При итерировании по объекту, порядок соответствует порядку следования ключей в `Object.keys()`, консистентность которого **не** гарантирована при использовании различных имплементаций движков JavaScript.</p>
191+
<p class="tip">При итерировании по объекту, порядок обхода соответствует порядку ключей в `Object.keys()`, консистентность которого **не** гарантирована при использовании различных реализаций движков JavaScript.</p>
192192

193193
### v-for и диапазоны
194194

195-
В `v-for` можно также передать целое число. В этом случае шаблон будет повторён указанное количество раз.
195+
В `v-for` можно также передать целое число. В этом случае шаблон будет повторён указанное число раз.
196196

197197
``` html
198198
<div>

src/v2/guide/mixins.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,44 @@
11
---
2-
title: Миксины
2+
title: Примеси
33
type: guide
44
order: 17
55
---
66

77
## Основы
88

9-
Миксины дают гибкие возможности для расширения функциональности компонентов Vue. Объект миксина может содержать любые опции компонентов. При использовании компонентом миксина, все опции миксина "примешиваются" к собственным опциям компонента.
9+
Примеси (mixins) - это гибкий инструмент повторного использования кода в компонентах Vue. Объект примеси может содержать любые опции компонентов. При использовании компонентом примеси, все опции примеси "подмешиваются" к собственным опциям компонента.
1010

1111
Пример:
1212

1313
``` js
14-
// определяем объект миксина
14+
// определяем объект примеси
1515
var myMixin = {
1616
created: function () {
1717
this.hello()
1818
},
1919
methods: {
2020
hello: function () {
21-
console.log('привет из миксина!')
21+
console.log('привет из примеси!')
2222
}
2323
}
2424
}
2525

26-
// определяем компонент, использующий миксин
26+
// определяем компонент, использующий примесь
2727
var Component = Vue.extend({
2828
mixins: [myMixin]
2929
})
3030

31-
var component = new Component() // -> "привет из миксина!"
31+
var component = new Component() // -> "привет из примеси!"
3232
```
3333

3434
## Слияние опций
3535

36-
Если миксин и компонент содержат пересекающиеся опции, они будут определённым образом соединены. Например, одноимённые хуки будут объединены в массив, что обеспечит вызов их всех. Кроме того, хуки миксина будут вызваны **перед** собственными хуками компонента:
36+
Если примесь и компонент содержат пересекающиеся опции, они будут определённым образом объединены. Например, одноимённые хуки будут объединены в массив, что обеспечит вызов их всех. Кроме того, хуки примеси будут вызваны **перед** собственными хуками компонента:
3737

3838
``` js
3939
var mixin = {
4040
created: function () {
41-
console.log('вызван хук миксина')
41+
console.log('вызван хук примеси')
4242
}
4343
}
4444

@@ -49,7 +49,7 @@ new Vue({
4949
}
5050
})
5151

52-
// -> "вызван хук миксина"
52+
// -> "вызван хук примеси"
5353
// -> "вызван хук компонента"
5454
```
5555

@@ -62,7 +62,7 @@ var mixin = {
6262
console.log('foo')
6363
},
6464
conflicting: function () {
65-
console.log('из миксина')
65+
console.log('из примеси')
6666
}
6767
}
6868
}
@@ -86,9 +86,9 @@ vm.conflicting() // -> "из самого компонента"
8686

8787
Обратите внимание, что те же самые стратегии слияния используются и во `Vue.extend()`.
8888

89-
## Глобальные миксины
89+
## Глобальные примеси
9090

91-
Миксин можно применить и глобально. Будьте осторожны! После применения, миксин окажет влияние на **все** инстансы Vue, создаваемые в дальнейшем. При правильном использовании это можно использовать для вставки логики обработки пользовательских опций:
91+
Примесь может быть применена и глобально. Но используйте данную возможность осторожно! После применения, примесь окажет влияние на **все** инстансы Vue, создаваемые в дальнейшем. При правильном использовании это можно использовать для вставки логики обработки пользовательских опций:
9292

9393
``` js
9494
// добавляем обработчик для пользовательской опции `myOption`
@@ -107,11 +107,11 @@ new Vue({
107107
// -> "hello!"
108108
```
109109

110-
<p class="tip">Используйте глобальные миксины редко и осторожно, поскольку они оказывают эффект на все до единого создаваемые инстансы Vue, включая third-party-компоненты. В большинстве случаев их стоит использовать только для обработки пользовательских опций, подобно продемонстрированной выше. Неплохой идеей будет их оформление в виде [Плагинов](plugins.html), что позволит избежать дублирования кода.</p>
110+
<p class="tip">Используйте глобальные примеси с осторожностью, поскольку они влияют на все до единого создаваемые инстансы Vue, включая внешние компоненты. В большинстве случаев их стоит использовать только для обработки пользовательских опций, подобно примеру выше. Неплохой идеей будет их оформление в виде [Плагинов](plugins.html), что позволит избежать дублирования кода.</p>
111111

112112
## Пользовательские стратегии слияния опций
113113

114-
При слиянии пользовательских опций применяется стратегия по умолчанию, которая просто переписывает одни значения другими. Если вы хотите использовать отличную логику при слиянии пользовательских опций, добавьте функцию в `Vue.config.optionMergeStrategies`:
114+
При слиянии пользовательских опций применяется стратегия по умолчанию, которая просто заменяет одни значения другими. Если вы хотите использовать отличную логику при слиянии пользовательских опций, добавьте функцию в `Vue.config.optionMergeStrategies`:
115115

116116
``` js
117117
Vue.config.optionMergeStrategies.myOption = function (toVal, fromVal) {

0 commit comments

Comments
 (0)