Skip to content

Commit 6b18898

Browse files
Alex-Sokolovkazupon
authored andcommitted
[RU] Translation update (#986)
* Russian translation update * options.md допереведено предложение * SUMMARY.md добавлен перечень настроек * options.md добавлена новая опция * testing-with-mocks.md добавлены -loader * testing.md исправлен пример * scoped-css.md добавлен раздел про вложенные селекторы * pre-processors.md добавлена новая секция * options.md нумерация версий * advanced.md нумерация версий * options.md уточнение * options.md уточнение * Fix merge * SUMMARY.md добавлены новые пункты * scoped-css.md новые правки * options.md новые свойства * hot-reload.md обновления * scoped-css.md правка
1 parent 407ddbd commit 6b18898

File tree

5 files changed

+71
-29
lines changed

5 files changed

+71
-29
lines changed

docs/ru/SUMMARY.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,8 @@
2626
- [cssSourceMap](options.md#csssourcemap)
2727
- [esModule](options.md#esmodule)
2828
- [preserveWhitespace](options.md#preservewhitespace)
29+
- [compilerModules](options.md#compilermodules)
30+
- [compilerDirectives](options.md#compilerdirectives)
2931
- [transformToRequire](options.md#transformtorequire)
3032
- [buble](options.md#buble)
3133
- [extractCSS](options.md#extractcss)

docs/ru/configurations/pre-processors.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ scss: generateLoaders('sass').concat(
6969
),
7070
```
7171

72-
В этот файл рекомендуется включать только переменные, примеси и т.п., чтобы предотвратить дублирование CSS в финальных скомпилированных файлах.
72+
В этот файл рекомендуется включать только переменные, примеси и т.п., чтобы предотвратить дублирование CSS в финальных скомпилированных файлах.
7373

7474
### JavaScript
7575

docs/ru/features/hot-reload.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,18 @@
44

55
![hot-reload](http://blog.evanyou.me/images/vue-hot.gif)
66

7+
## Правила сохранения текущего состояния компонента
8+
9+
- При редактировании `<template>` компонента, экземпляры изменённого компонента будут повторно отрендерены, сохраняя всё текущее собственное состояние. Это возможно, потому что шаблоны компилируются в новые render-функции, которые не создают побочных эффектов.
10+
11+
- При редактировании `<script>` компонента, экземпляры редактируемого компонента будут уничтожены и созданы заново (состояние других компонентов в приложении сохраняется). Это связано с тем, что `<script>` может включать в себя хуки жизненного цикла, которые могут создавать побочные эффекты, поэтому для обеспечения согласованности поведения требуется "перезагрузка", а не просто повторный рендеринг. Это также означает, что вам нужно быть осторожным в отношении глобальных побочных эффектов, таких как использование таймеров внутри хуков жизненного цикла компонентов. Иногда вам может потребоваться полная перезагрузка страницы, если ваш компонент создаёт глобальные побочные эффекты.
12+
13+
- Горячая перезагрузка `<style>` работает самостоятельно через `vue-style-loader`, поэтому никак не затрагивает состояние приложения.
14+
15+
## Использование
16+
717
При создании проекта с помощью `vue-cli`, горячая замена включена по умолчанию.
18+
19+
При настройке проекта вручную горячая перезагрузка включится автоматически, когда вы запускаете ваш проект с помощью `webpack-dev-server --hot`.
20+
21+
Продвинутые пользователи могут изучить [vue-hot-reload-api](https://github.com/vuejs/vue-hot-reload-api), который используется внутри `vue-loader`.

docs/ru/features/scoped-css.md

Lines changed: 38 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -28,40 +28,50 @@
2828
</template>
2929
```
3030

31-
#### Примечания
31+
#### Советы
3232

33-
1. Вы можете использовать в компоненте локальные и глобальные стили одновременно:
33+
### Использование локальных и глобальных стилей
3434

35-
``` html
36-
<style>
37-
/* глобальные стили */
38-
</style>
35+
Вы можете сочетать использование в компоненте локальных и глобальных стили одновременно:
3936

40-
<style scoped>
41-
/* локальные стили */
42-
</style>
43-
```
37+
``` html
38+
<style>
39+
/* глобальные стили */
40+
</style>
41+
42+
<style scoped>
43+
/* локальные стили */
44+
</style>
45+
```
46+
47+
### Корневой узел дочернего компонента
48+
49+
С помощью `scoped`, стили родительского компонента не будут влиять на содержимое дочерних компонентов. Тем не менее, корневой узел дочернего компонента будет зависеть как от scoped CSS из родительского элемента, так и от scoped CSS дочернего. Это предусмотрено специально, чтобы родительский элемент мог стилизовать корневой элемент дочернего компонента например для целей макета.
50+
51+
### Глубокие селекторы
52+
53+
Если вы хотите, чтобы селектор в `scoped` стилях был "глубоким", т.е. влиял на дочерние компоненты, вы можете использовать комбинатор `>>>`:
54+
55+
``` html
56+
<style scoped>
57+
.a >>> .b { /* ... */ }
58+
</style>
59+
```
60+
61+
Указанное выше будет скомпилировано в:
62+
63+
``` css
64+
.a[data-v-f3f3eg9] .b { /* ... */ }
65+
```
4466

45-
2. Корневой тег компонента потомка будет попадать под область видимости родительского локального CSS и своего локального CSS.
67+
Некоторые пре-процессоры, такие как SASS, не могут правильно обработать `>>>`. В таких случаях вы можете использовать комбинатор `/deep/` — это псевдоним для `>>>` работающий точно также.
4668

47-
3. Partials не затрагиваются локальными стилями.
69+
### Динамически генерируемый контент
4870

49-
4. **Локальные стили не устраняют необходимость классов**. Из-за того как браузеры рендерят различные CSS-селекторы, `p { color: red }` может быть в разы медленнее при использовании в локальных стилях (например, когда комбинируется с селектором по атрибуту). Если же вы используете классы или ID, такие как `.example { color: red }`, тогда вы практически полностью исключаете ухудшение производительности. [Вот пример](http://stevesouders.com/efws/css-selectors/csscreate.php) где вы можете проверить разницу самостоятельно.
71+
DOM-содержимое, создаваемое с помощью `v-html` не попадает под область действия scoped-стилей, но вы всё равно можете его стилизовать воспользовавшись deep-селекторами.
5072

51-
5. **Будьте внимательны с селекторами потомков в рекурсивных компонентах!** Для CSS-правила с селектором `.a .b`, если элемент, который соответствует `.a` содержит рекурсивный компонент потомок, тогда все `.b` в этом компоненте потомке будут также соответствовать правилу.
73+
### О чём следует помнить
5274

53-
6. Если вам нужны вложенные селекторы в `scoped` стилях, вам нужно будет использовать оператор `>>>` для CSS и `/deep/` для `scss`:
75+
- **Локальные стили не устраняют необходимость классов**. Из-за того как браузеры рендерят различные CSS-селекторы, `p { color: red }` может быть в разы медленнее при использовании в локальных стилях (например, когда комбинируется с селектором по атрибуту). Если же вы используете классы или ID, такие как `.example { color: red }`, тогда вы практически полностью исключаете ухудшение производительности. [Вот пример](http://stevesouders.com/efws/css-selectors/csscreate.php) где вы можете проверить разницу самостоятельно.
5476

55-
``` html
56-
<style scoped>
57-
.a >>> .b {
58-
59-
}
60-
</style>
61-
62-
<style lang="scss" scoped>
63-
.a /deep/ .b {
64-
65-
}
66-
</style>
67-
```
77+
- **Будьте внимательны с селекторами потомков в рекурсивных компонентах!** Для CSS-правила с селектором `.a .b`, если элемент, который соответствует `.a` содержит рекурсивный компонент потомок, тогда все `.b` в этом компоненте потомке будут также соответствовать правилу.

docs/ru/options.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -137,6 +137,22 @@ module.exports = {
137137

138138
При установке в `false` пробельные символы между HTML тегами в шаблонах будут проигнорированы.
139139

140+
### compilerModules
141+
142+
- Тип: `Array<ModuleOptions>`
143+
- По умолчанию: `[]`
144+
145+
Настройка опции `modules` для `vue-template-compiler`. См. подробнее в документации `vue-template-compiler` [опция `modules`](https://github.com/vuejs/vue/blob/dev/packages/vue-template-compiler/README.md#compilercompiletemplate-options).
146+
147+
### compilerDirectives
148+
149+
- Тип: `{ [tag: string]: Function }`
150+
- По умолчанию: `{}` (v13.0.5+)
151+
152+
> Примечание: в версиях v12.x поддержка добавлена с v12.2.3+
153+
154+
Настройка опции `directives` для `vue-template-compiler`. См. подробнее в документации `vue-template-compiler` [опция `directives`](https://github.com/vuejs/vue/blob/dev/packages/vue-template-compiler/README.md#compilercompiletemplate-options).
155+
140156
### transformToRequire
141157

142158
- Тип: `{ [tag: string]: string | Array<string> }`

0 commit comments

Comments
 (0)