Skip to content

Commit abbdf98

Browse files
Alex-Sokolovposva
authored andcommitted
docs(ru): Translation update (#2524)
* docs: [RU] Translation update * README.md обновление * navigation.md fix * consistent code blocks * dynamic-matching.md add new section
1 parent f4d1866 commit abbdf98

18 files changed

+115
-85
lines changed

Diff for: docs/ru/README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,14 @@
66
Для пользователей TypeScript, `[email protected]+` требуется `[email protected]+`, и наоборот.
77
:::
88

9-
Vue Router — официальная библиотека маршрутизации для [Vue.js](https://ru.vuejs.org/). Она глубоко интегрируется с ядром Vue.js, что позволяет создавать SPA-приложения с лёгкостью. Включает следующие возможности:
9+
Vue Router — официальная библиотека маршрутизации для [Vue.js](https://ru.vuejs.org/). Она глубоко интегрируется с Vue.js и позволяет легко создавать SPA-приложения. Включает следующие возможности:
1010

1111
- Вложенные маршруты/представления
1212
- Модульная конфигурация маршрутизатора
1313
- Доступ к параметрам маршрута, query, wildcards
1414
- Анимация переходов представлений на основе Vue.js
1515
- Удобный контроль навигации
16-
- Автоматическое проставление активного класса CSS для ссылок
16+
- Автоматическое проставление активного CSS класса для ссылок
1717
- Режимы работы HTML5 history или хэш, с авто-переключением в IE9
1818
- Настраиваемое поведение прокрутки страницы
1919

Diff for: docs/ru/api/README.md

+18-18
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ sidebar: auto
2222

2323
Иногда может потребоваться применять активный класс к внешнему элементу, а не к тегу `<a>`, в этом случае можно отобразить внешний элемент с помощью `<router-link>` и обернуть содержимое тегом `<a>` внутри:
2424

25-
``` html
25+
```html
2626
<router-link tag="li" to="/foo">
2727
<a>/foo</a>
2828
</router-link>
@@ -39,7 +39,7 @@ sidebar: auto
3939

4040
Определяет итоговый маршрут ссылки. При нажатии, значение входного параметра `to` будет передано в `router.push()` — поэтому это значение может быть как строкой, так и объектом описывающим маршрут.
4141

42-
``` html
42+
```html
4343
<!-- строка -->
4444
<router-link to="home">Home</router-link>
4545
<!-- отобразится в -->
@@ -68,7 +68,7 @@ sidebar: auto
6868

6969
Указание входного параметра `replace` вызовет `router.replace()` вместо `router.push()` при нажатии на ссылку, поэтому навигация не оставит записи в истории переходов.
7070

71-
``` html
71+
```html
7272
<router-link :to="{ path: '/abc'}" replace></router-link>
7373
```
7474

@@ -79,7 +79,7 @@ sidebar: auto
7979

8080
Указание входного параметра `append` будет добавлять относительный путь к текущему. Например, если мы переходим от `/a` к относительной ссылке `b`, то без `append` будет адрес `/b`, а вместе с `append` получится `/a/b`.
8181

82-
``` html
82+
```html
8383
<router-link :to="{ path: 'relative/path'}" append></router-link>
8484
```
8585

@@ -90,7 +90,7 @@ sidebar: auto
9090

9191
Иногда необходимо чтобы `<router-link>` отображался другим тегом, например `<li>`. В таком случае мы можем использовать входной параметр `tag`, чтобы указать нужный тег, и он всё равно будет прослушивать события click для навигации.
9292

93-
``` html
93+
```html
9494
<router-link to="/foo" tag="li">foo</router-link>
9595
<!-- отобразится как -->
9696
<li>foo</li>
@@ -112,7 +112,7 @@ sidebar: auto
112112

113113
Обратите внимание, поэтому `<router-link to="/">` будет активным для каждого маршрута! Для «режима точного соответствия» укажите в ссылке входной параметр `exact`:
114114

115-
``` html
115+
```html
116116
<!-- эта ссылка будет активной только для адреса `/` -->
117117
<router-link to="/" exact>
118118
```
@@ -141,7 +141,7 @@ sidebar: auto
141141

142142
Поскольку это всего лишь компонент, он работает вместе с `<transition>` и `<keep-alive>`. При одновременном использовании обоих обязательно располагайте `<keep-alive>` внутри:
143143

144-
``` html
144+
```html
145145
<transition>
146146
<keep-alive>
147147
<router-view></router-view>
@@ -166,7 +166,7 @@ sidebar: auto
166166

167167
Декларация типа для `RouteConfig`:
168168

169-
``` js
169+
```js
170170
declare type RouteConfig = {
171171
path: string;
172172
component?: Component;
@@ -290,7 +290,7 @@ sidebar: auto
290290

291291
Сигнатуры:
292292

293-
``` js
293+
```js
294294
router.beforeEach((to, from, next) => {
295295
/* необходимо вызывать `next` */
296296
})
@@ -314,7 +314,7 @@ router.afterEach((to, from) => {})
314314

315315
Сигнатуры:
316316

317-
``` js
317+
```js
318318
router.push(location, onComplete?, onAbort?)
319319
router.replace(location, onComplete?, onAbort?)
320320
router.go(n)
@@ -328,7 +328,7 @@ router.forward()
328328
329329
Сигнатура:
330330
331-
``` js
331+
```js
332332
const matchedComponents: Array<Component> = router.getMatchedComponents(location?)
333333
```
334334
@@ -338,7 +338,7 @@ const matchedComponents: Array<Component> = router.getMatchedComponents(location
338338
339339
Сигнатура:
340340
341-
``` js
341+
```js
342342
const resolved: {
343343
location: Location;
344344
route: Route;
@@ -355,7 +355,7 @@ const resolved: {
355355
356356
Сигнатура:
357357
358-
``` js
358+
```js
359359
router.addRoutes(routes: Array<RouteConfig>)
360360
```
361361
@@ -365,7 +365,7 @@ router.addRoutes(routes: Array<RouteConfig>)
365365
366366
Сигнатура:
367367
368-
``` js
368+
```js
369369
router.onReady(callback, [errorCallback])
370370
```
371371
@@ -379,7 +379,7 @@ router.onReady(callback, [errorCallback])
379379
380380
Сигнатура:
381381
382-
``` js
382+
```js
383383
router.onError(callback)
384384
```
385385
@@ -407,15 +407,15 @@ router.onError(callback)
407407
408408
- В качестве двух первых параметров навигационных хуков:
409409
410-
``` js
410+
```js
411411
router.beforeEach((to, from, next) => {
412412
// как `to` так и `from` являются объектами маршрута
413413
})
414414
```
415415
416416
- В качестве двух первых параметров функции `scrollBehavior`:
417417
418-
``` js
418+
```js
419419
const router = new VueRouter({
420420
scrollBehavior (to, from, savedPosition) {
421421
// как `to` так и `from` являются объектами маршрута
@@ -461,7 +461,7 @@ router.onError(callback)
461461
462462
Массив с **записями маршрутов** для всех вложенных сегментов текущего маршрута. Записи маршрутов — это копии объектов из опции `routes` (и вложенных массивов `children`):
463463
464-
``` js
464+
```js
465465
const router = new VueRouter({
466466
routes: [
467467
// объект ниже — это запись маршрута

Diff for: docs/ru/guide/README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212

1313
## HTML
1414

15-
``` html
15+
```html
1616
<script src="https://unpkg.com/vue/dist/vue.js"></script>
1717
<script src="https://unpkg.com/vue-router/dist/vue-router.js"></script>
1818

@@ -32,7 +32,7 @@
3232

3333
## JavaScript
3434

35-
``` js
35+
```js
3636
// 0. Если используем модульную систему (например через vue-cli),
3737
// импортируем Vue и VueRouter и затем вызываем `Vue.use(VueRouter)`.
3838

Diff for: docs/ru/guide/advanced/data-fetching.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414

1515
Предположим, у нас есть компонент `Post`, которому требуется загрузить с сервера данные, соответствующие id поста из `$route.params.id`:
1616

17-
``` html
17+
```html
1818
<template>
1919
<div class="post">
2020
<div class="loading" v-if="loading">
@@ -33,7 +33,7 @@
3333
</template>
3434
```
3535

36-
``` js
36+
```js
3737
export default {
3838
data () {
3939
return {
@@ -73,7 +73,7 @@ export default {
7373

7474
Используя этот подход, мы запрашиваем данные до завершения перехода к новому маршруту. Запрос данных выполняется в навигационном хуке `beforeRouteEnter` компонента, который вызывает `next`, когда данные получены:
7575

76-
``` js
76+
```js
7777
export default {
7878
data () {
7979
return {

Diff for: docs/ru/guide/advanced/lazy-loading.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,13 @@
66

77
Во-первых, асинхронный компонент можно определить как функцию-фабрику, которая возвращает Promise (который должен разрешиться самим компонентом):
88

9-
``` js
9+
```js
1010
const Foo = () => Promise.resolve({ /* определение компонента */ })
1111
```
1212

1313
Во-вторых, с Webpack 2 мы можем использовать синтаксис [динамических импортов](https://github.com/tc39/proposal-dynamic-import) для указания точек разделения кода:
1414

15-
``` js
15+
```js
1616
import('./Foo.vue') // возвращает Promise
1717
```
1818

@@ -22,13 +22,13 @@ import('./Foo.vue') // возвращает Promise
2222

2323
Эти два пункта — всё необходимое, чтобы определить асинхронный компонент, который Webpack автоматически выделит в отдельный фрагмент:
2424

25-
``` js
25+
```js
2626
const Foo = () => import('./Foo.vue')
2727
```
2828

2929
В конфигурации маршрута ничего менять не нужно, можно использовать `Foo` как обычно:
3030

31-
``` js
31+
```js
3232
const router = new VueRouter({
3333
routes: [
3434
{ path: '/foo', component: Foo }
@@ -40,7 +40,7 @@ const router = new VueRouter({
4040

4141
Иногда может понадобиться объединить в одном фрагменте все компоненты, расположенные по определённому маршруту. Для этого можно указывать [имена фрагментов Webpack](https://webpack.js.org/guides/code-splitting-async/#chunk-names), используя специальный синтаксис комментариев (в версиях Webpack > 2.4):
4242

43-
``` js
43+
```js
4444
const Foo = () => import(/* webpackChunkName: "group-foo" */ './Foo.vue')
4545
const Bar = () => import(/* webpackChunkName: "group-foo" */ './Bar.vue')
4646
const Baz = () => import(/* webpackChunkName: "group-foo" */ './Baz.vue')

Diff for: docs/ru/guide/advanced/meta.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Вы можете добавить поле `meta` при определении маршрута:
44

5-
``` js
5+
```js
66
const router = new VueRouter({
77
routes: [
88
{
@@ -31,7 +31,7 @@ const router = new VueRouter({
3131

3232
В качестве примера можно привести проверку метаданных в глобальном навигационном хуке:
3333

34-
``` js
34+
```js
3535
router.beforeEach((to, from, next) => {
3636
if (to.matched.some(record => record.meta.requiresAuth)) {
3737
// этот путь требует авторизации, проверяем залогинен ли

Diff for: docs/ru/guide/advanced/navigation-guards.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88

99
Глобальный хук можно зарегистрировать через `router.beforeEach`:
1010

11-
``` js
11+
```js
1212
const router = new VueRouter({ ... })
1313

1414
router.beforeEach((to, from, next) => {
@@ -44,7 +44,7 @@ router.beforeEach((to, from, next) => {
4444

4545
Можно также зарегистрировать глобальные хуки, вызываемые после завершения перехода. Однако, в отличие от сторожевых хуков, в них не передаётся функция `next`, и на навигацию они повлиять не могут:
4646

47-
``` js
47+
```js
4848
router.afterEach((to, from) => {
4949
// ...
5050
})
@@ -54,7 +54,7 @@ router.afterEach((to, from) => {
5454

5555
Навигационные хуки `beforeEnter` можно указать напрямую для конкретного маршрута в его конфигурации:
5656

57-
``` js
57+
```js
5858
const router = new VueRouter({
5959
routes: [
6060
{
@@ -78,7 +78,7 @@ const router = new VueRouter({
7878
- `beforeRouteUpdate`
7979
- `beforeRouteLeave`
8080

81-
``` js
81+
```js
8282
const Foo = {
8383
template: `...`,
8484
beforeRouteEnter (to, from, next) {
@@ -105,7 +105,7 @@ const Foo = {
105105

106106
Тем не менее, доступ к экземпляру можно получить, передав коллбэк в `next`. Эта функция будет вызвана после подтверждения навигации, а экземпляр компонента будет передан в неё в качестве параметра:
107107

108-
``` js
108+
```js
109109
beforeRouteEnter (to, from, next) {
110110
next(vm => {
111111
// экземпляр компонента доступен как `vm`

Diff for: docs/ru/guide/advanced/scroll-behavior.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66

77
При создании экземпляра маршрутизатора, вы можете указать функцию `scrollBehavior`:
88

9-
``` js
9+
```js
1010
const router = new VueRouter({
1111
routes: [...],
1212
scrollBehavior (to, from, savedPosition) {
@@ -26,7 +26,7 @@ const router = new VueRouter({
2626

2727
Например:
2828

29-
``` js
29+
```js
3030
scrollBehavior (to, from, savedPosition) {
3131
return { x: 0, y: 0 }
3232
}
@@ -36,7 +36,7 @@ scrollBehavior (to, from, savedPosition) {
3636

3737
Возврат `savedPosition` позволяет эмулировать нативное поведение браузера при использовании кнопок назад/вперёд:
3838

39-
``` js
39+
```js
4040
scrollBehavior (to, from, savedPosition) {
4141
if (savedPosition) {
4242
return savedPosition
@@ -48,7 +48,7 @@ scrollBehavior (to, from, savedPosition) {
4848

4949
Эмулировать поведение "прокрутки к якорю" на странице можно так:
5050

51-
``` js
51+
```js
5252
scrollBehavior (to, from, savedPosition) {
5353
if (to.hash) {
5454
return {
@@ -67,7 +67,7 @@ scrollBehavior (to, from, savedPosition) {
6767
6868
Можно также вернуть Promise, который разрешится объектом с желаемой позицией прокрутки:
6969

70-
``` js
70+
```js
7171
scrollBehavior (to, from, savedPosition) {
7272
return new Promise((resolve, reject) => {
7373
setTimeout(() => {

0 commit comments

Comments
 (0)