docs: [RU] Translation update (#3520)

Co-authored-by: Alex Sokolov <[email protected]>

Author: Alex-Sokolov

docs/api/README.md

@@ -481,7 +481,7 @@ addRoute(parentName: string, route: RouteConfig): () => void
 
 > New in 3.5.0
 
-Get the list of all the active route records. **Note only documented properties are considered Public API**, avoid using any other propery e.g. `regex` as it doesn't exist on Vue Router 4.
+Get the list of all the active route records. **Note only documented properties are considered Public API**, avoid using any other property e.g. `regex` as it doesn't exist on Vue Router 4.
 
 Signature:
 

docs/ru/README.md

@@ -1,7 +1,7 @@
 ---
 home: true
 heroImage: /logo.png
-actionText: Get Started →
+actionText: Начать знакомство →
 actionLink: /ru/installation.html
 footer: MIT Licensed | Copyright © 2014-present Evan You, Eduardo San Martin Morote
 ---

docs/ru/api/README.md

@@ -23,6 +23,7 @@ sidebar: auto
 ```html
 <router-link
   to="/about"
+  custom
   v-slot="{ href, route, navigate, isActive, isExactActive }"
 >
   <NavLink :active="isActive" :href="href" @click="navigate">
@@ -44,6 +45,7 @@ sidebar: auto
 ```html
 <router-link
   to="/foo"
+  custom
   v-slot="{ href, route, navigate, isActive, isExactActive }"
 >
   <li
@@ -138,7 +140,7 @@ sidebar: auto
 - тип: `boolean`
 - по умолчанию: `false`
 
-  Стандартное поведение определения когда выставлять активный класс основывается на **совпадениях по включению**. Например, `<router-link to="/a">` будет получать класс активности, когда текущий путь начинается с `/a/` или `/a`.
+  Стандартное поведение сопоставления, когда выставляется активный класс, основывается на **совпадениях по включению**. Например, `<router-link to="/a">` будет получать класс активности и когда текущий путь начинается с `/a/` и когда с `/a`.
 
   Обратите внимание, поэтому `<router-link to="/">` будет активным для каждого маршрута! Для «режима точного соответствия» укажите в ссылке входной параметр `exact`:
 
@@ -149,6 +151,27 @@ sidebar: auto
 
   Ознакомьтесь с другими примерами активных классов ссылок [вживую](https://jsfiddle.net/8xrk1n9f/).
 
+### exact-path
+
+> Добавлено в версии 3.5.0
+
+- тип: `boolean`
+- по умолчанию: `false`
+
+  Позволяет использовать сопоставление только на секции `path` в URL, позволяя эффективно игнорировать секции `query` и `hash`.
+
+  ```html
+  <!-- ссылка будет активной для `/search?page=2` или `/search#filters` -->
+  <router-link to="/search" exact-path> </router-link>
+  ```
+
+### exact-path-active-class
+
+- тип: `string`
+- по умолчанию: `"router-link-exact-path-active"`
+
+  Указание активного CSS класса, который применяется когда ссылка активна по сопоставлению `path`. Обратите внимание, что значение по умолчанию можно задать глобально в опции `linkExactPathActiveClass` конструктора маршрутизатора.
+
 ### event
 
 - тип: `string | Array<string>`
@@ -319,6 +342,26 @@ sidebar: auto
 
   Текущий маршрут в виде [объекта Route](#объект-route).
 
+### router.START_LOCATION
+
+- тип: `Route`
+
+  Первоначальная навигация будет [объектом Route](#объект-route) с которого запускается маршрутизатор. Можно использовать в навигационных хуках для определения стартовой навигации.
+
+  ```js
+  import Router from 'vue-router'
+
+  const router = new Router({
+    // ...
+  })
+
+  router.beforeEach((to, from) => {
+    if (from === START_LOCATION) {
+      // первоначальная навигация
+    }
+  })
+  ```
+
 ## Методы экземпляра Router
 
 ### router.beforeEach
@@ -398,14 +441,52 @@ const resolved: {
 
 ### router.addRoutes
 
+_УСТАРЕВШИЙ_: используйте вместо метод [`router.addRoute()`](#router-addroute).
+
 Сигнатура:
 
-```js
+```ts
 router.addRoutes(routes: Array<RouteConfig>)
 ```
 
 Динамически добавляет дополнительные маршруты в маршрутизатор. Аргумент должен быть массивом маршрутов в таком же формате, как и в опции `routes` конструктора.
 
+### router.addRoute
+
+> Добавлено в версии 3.5.0
+
+Добавляет новый маршрут в маршрутизатор. Если у маршрута указан `name` и уже существует маршрут с таким же именем, то он будет перезаписан.
+
+Сигнатура:
+
+```ts
+addRoute(route: RouteConfig): () => void
+```
+
+### router.addRoute
+
+> Добавлено в версии 3.5.0
+
+Добавляет новый маршрут в качестве дочернего для существующего маршрута. Если у маршрута указан `name` и уже существует маршрут с таким же именем, то он будет перезаписан.
+
+Сигнатура:
+
+```ts
+addRoute(parentName: string, route: RouteConfig): () => void
+```
+
+### router.getRoutes
+
+> Добавлено в версии 3.5.0
+
+Получение списка записей всех активных маршрутов. **Обратите внимание, что только задокументированные свойства считаются публичным API**, поэтому следует избегать использования любых других свойств, например `regex`, так как их уже не будет в Vue Router 4.
+
+Сигнатура:
+
+```ts
+getRoutes(): RouteRecord[]
+```
+
 ### router.onReady
 
 Сигнатура:

docs/ru/guide/README.md

@@ -6,7 +6,7 @@
 Кроме того, все примеры будут использовать полную сборку Vue, чтобы позволить компиляцию шаблонов на лету. Подробнее о различиях сборок читайте [здесь](https://ru.vuejs.org/v2/guide/installation.html#Runtime-Компилятор-vs-Runtime-only).
 :::
 
-Создавать одностраничные приложения (SPA) используя Vue + Vue Router очень просто. С помощью Vue.js, мы уже компонуем своё приложение из компонентов. Добавляя Vue Router, мы просто сопоставляем наши компоненты с маршрутами и объясняем Vue Router где их отображать. Вот простой пример:
+Создавать одностраничные приложения (SPA) используя Vue + Vue Router очень просто: с помощью Vue.js, мы уже компонуем своё приложение из компонентов. Добавляя Vue Router, мы просто сопоставляем наши компоненты с маршрутами и объясняем Vue Router где их отображать. Вот простой пример:
 
 ## HTML
 

docs/ru/guide/advanced/data-fetching.md

@@ -81,14 +81,14 @@ export default {
       error: null
     }
   },
-  beforeRouteEnter (to, from, next) {
+  beforeRouteEnter(to, from, next) {
     getPost(to.params.id, (err, post) => {
       next(vm => vm.setData(err, post))
     })
   },
   // если путь изменяется, а компонент уже отображён,
   // то логика будет немного иной
-  beforeRouteUpdate (to, from, next) {
+  beforeRouteUpdate(to, from, next) {
     this.post = null
     getPost(to.params.id, (err, post) => {
       this.setData(err, post)

docs/ru/guide/advanced/meta.md

@@ -1,6 +1,6 @@
 # Метаданные маршрутов
 
-Вы можете добавить поле `meta` при определении маршрута:
+Иногда может быть удобным добавить дополнительную информацию к маршрутам, например имена анимаций переходов, кто может получить доступ к маршруту и т.д. Этого можно достичь с помощью свойства `meta`, которое принимает объект свойств и к которому можно получить доступ на странице маршрута или в навигационных хуках. Свойства `meta` можно объявить так:
 
 ```js
 const router = new VueRouter({

docs/ru/guide/advanced/navigation-failures.md

@@ -48,7 +48,7 @@ router
 
 ## Свойства _ошибок навигации_
 
-Все сбои навигации предоставляют доступ к свойствам `to` и `from`, чтобы отобразить текущее местоположение, а также местоположение места назначения для навигации, в которой произошёл сбой:
+Все сбои навигации предоставляют доступ к свойствам `to` и `from`, отображающие для навигации в которой произошёл сбой местоположение места назначения и текущее местоположение соответственно:
 
 ```js
 // попытка получения доступа к странице администрирования

docs/ru/guide/advanced/navigation-guards.md

@@ -98,20 +98,20 @@ const router = new VueRouter({
 ```js
 const Foo = {
   template: `...`,
-  beforeRouteEnter (to, from, next) {
+  beforeRouteEnter(to, from, next) {
     // вызывается до подтверждения пути, соответствующего этому компоненту.
     // НЕ ИМЕЕТ доступа к контексту экземпляра компонента `this`,
     // так как к моменту вызова экземпляр ещё не создан!
   },
-  beforeRouteUpdate (to, from, next) {
+  beforeRouteUpdate(to, from, next) {
     // вызывается когда маршрут, что рендерит этот компонент изменился,
     // но этот компонент будет повторно использован в новом маршруте.
     // Например, для маршрута с динамическими параметрами `/foo/:id`, когда мы
     // перемещаемся между `/foo/1` и `/foo/2`, экземпляр того же компонента `Foo`
     // будет использован повторно, и этот хук будет вызван когда это случится.
     // Также имеется доступ в `this` к экземпляру компонента.
   },
-  beforeRouteLeave (to, from, next) {
+  beforeRouteLeave(to, from, next) {
     // вызывается перед переходом от пути, соответствующего текущему компоненту;
     // имеет доступ к контексту экземпляра компонента `this`.
   }
@@ -123,17 +123,17 @@ const Foo = {
 Тем не менее, доступ к экземпляру можно получить, передав коллбэк в `next`. Эта функция будет вызвана после подтверждения навигации, а экземпляр компонента будет передан в неё в качестве параметра:
 
 ```js
-beforeRouteEnter (to, from, next) {
+beforeRouteEnter(to, from, next) {
   next(vm => {
     // экземпляр компонента доступен как `vm`
   })
 }
 ```
 
-Обратите внимание, что `beforeRouteEnter` — единственный хук, который поддерживает передачу коллбэка в `next`. Для `beforeRouteUpdate` и `beforeRouteLeave`, `this` уже доступен, поэтому передача коллбэка не требуется и поэтому *не поддерживается*:
+Обратите внимание, что `beforeRouteEnter` — единственный хук, который поддерживает передачу коллбэка в `next`. Для `beforeRouteUpdate` и `beforeRouteLeave`, `this` уже доступен, поэтому передача коллбэка не требуется и поэтому _не поддерживается_:
 
 ```js
-beforeRouteUpdate (to, from, next) {
+beforeRouteUpdate(to, from, next) {
   // просто используйте `this`
   this.name = to.params.name
   next()
@@ -143,7 +143,7 @@ beforeRouteUpdate (to, from, next) {
 **Навигационный хук ухода со страницы** обычно используется для предотвращения случайного ухода пользователя со страницы с несохранёнными изменениями. Навигацию можно отменить вызовом `next(false)`.
 
 ```js
-beforeRouteLeave (to, from, next) {
+beforeRouteLeave(to, from, next) {
   const answer = window.confirm('Вы хотите уйти? У вас есть несохранённые изменения!')
   if (answer) {
     next()
@@ -153,6 +153,18 @@ beforeRouteLeave (to, from, next) {
 }
 ```
 
+При использовании примесей, которые будут добавлять навигационные хуки для компонента, убедитесь, что объявляете примесь **после установки плагина vue-router**:
+
+```js
+Vue.use(Router)
+
+Vue.mixin({
+  beforeRouteUpdate(to, from, next) {
+    // ...
+  }
+})
+```
+
 ## Полная цепочка обработки навигации
 
 1. Срабатывание навигации.

docs/ru/guide/advanced/scroll-behavior.md

@@ -9,7 +9,7 @@
 ```js
 const router = new VueRouter({
   routes: [...],
-  scrollBehavior (to, from, savedPosition) {
+  scrollBehavior(to, from, savedPosition) {
     // возвращаем требуемую позицию прокрутки
   }
 })
@@ -27,7 +27,7 @@ const router = new VueRouter({
 Например:
 
 ```js
-scrollBehavior (to, from, savedPosition) {
+scrollBehavior(to, from, savedPosition) {
   return { x: 0, y: 0 }
 }
 ```
@@ -37,7 +37,7 @@ scrollBehavior (to, from, savedPosition) {
 Возврат `savedPosition` позволяет эмулировать нативное поведение браузера при использовании кнопок назад/вперёд:
 
 ```js
-scrollBehavior (to, from, savedPosition) {
+scrollBehavior(to, from, savedPosition) {
   if (savedPosition) {
     return savedPosition
   } else {
@@ -49,7 +49,7 @@ scrollBehavior (to, from, savedPosition) {
 Эмулировать поведение "прокрутки к якорю" на странице можно так:
 
 ```js
-scrollBehavior (to, from, savedPosition) {
+scrollBehavior(to, from, savedPosition) {
   if (to.hash) {
     return {
       selector: to.hash
@@ -68,7 +68,7 @@ scrollBehavior (to, from, savedPosition) {
 Можно также вернуть Promise, который разрешится объектом с желаемой позицией прокрутки:
 
 ```js
-scrollBehavior (to, from, savedPosition) {
+scrollBehavior(to, from, savedPosition) {
   return new Promise((resolve, reject) => {
     setTimeout(() => {
       resolve({ x: 0, y: 0 })
@@ -78,3 +78,18 @@ scrollBehavior (to, from, savedPosition) {
 ```
 
 Это можно связать с событиями компонента transition на уровне страницы, чтобы реализовать такое поведение прокрутки, которое сочетается с анимациями перехода между страницами, но из-за множества возможных вариантов и комплексности примеров, мы просто предоставляем этот простой пример, чтобы показать где можно разместить собственную реализацию.
+
+## Плавная прокрутка
+
+Можно включить нативную плавную прокрутку для [браузеров, которые поддерживают её](https://developer.mozilla.org/en-US/docs/Web/API/ScrollToOptions/behavior), просто добавив опцию `behavior` к объекту, возвращаемому из `scrollBehavior`:
+
+```js
+scrollBehavior(to, from, savedPosition) {
+  if (to.hash) {
+    return {
+      selector: to.hash,
+      behavior: 'smooth',
+    }
+  }
+}
+```

docs/ru/guide/essentials/dynamic-matching.md

@@ -58,7 +58,7 @@ const User = {
 ```js
 const User = {
   template: '...',
-  beforeRouteUpdate (to, from, next) {
+  beforeRouteUpdate(to, from, next) {
     // обрабатываем изменение параметров маршрута...
     // не забываем вызвать next()
   }