(docs) [RU] Translation update

vuejs · posva · Aug 8, 2020 · Aug 14, 2018 · Nov 12, 2018 · Nov 12, 2018
commit 3421e00788eeca8051e367525cd1e2ced777b084
diff --git a/docs/ru/api/README.md b/docs/ru/api/README.md
@@ -13,22 +13,52 @@ sidebar: auto
 `<router-link>` предпочтительнее `<a href="...">` по следующим причинам:
 
 - Он работает одинаково вне зависимости от режима работы (HTML5 history или хэш), поэтому если вы решите переключить режим, или маршрутизатор для совместимости переключится обратно в режим хэша в IE9, ничего не потребуется изменять.
-
 - В режиме HTML5 history, `router-link` будет перехватывать событие click, чтобы браузер не пытался перезагрузить страницу.
-
 - При использовании опции `base` в режиме работы HTML5 history, вам не потребуется добавлять её в URL входного параметра `to`.
 
-### Применение активного класса к внешнему элементу
+### `v-slot` API (3.1.0+)
+
+`router-link` предоставляет возможность более низкоуровневой настройки с помощью [слота с ограниченной областью видимости](https://ru.vuejs.org/v2/guide/components-slots.html#%D0%A1%D0%BB%D0%BE%D1%82%D1%8B-%D1%81-%D0%BE%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%B5%D0%BD%D0%BD%D0%BE%D0%B9-%D0%BE%D0%B1%D0%BB%D0%B0%D1%81%D1%82%D1%8C%D1%8E-%D0%B2%D0%B8%D0%B4%D0%B8%D0%BC%D0%BE%D1%81%D1%82%D0%B8). Это более продвинутое API ориентировано в первую очередь на создателей библиотек, но может пригодиться и разработчикам, к примеру для создании пользовательских компонентов таких как _NavLink_ или подобных.
 
-Иногда может потребоваться применять активный класс к внешнему элементу, а не к тегу `<a>`, в этом случае можно отобразить внешний элемент с помощью `<router-link>` и обернуть содержимое тегом `<a>` внутри:
+**При использовании API `v-slot` необходимо передавать один дочерний элемент в `router-link`**. Если этого не сделать, `router-link` обернёт все дочерние элементы в `span`.
 
 ```html
-<router-link tag="li" to="/foo">
-  <a>/foo</a>
+<router-link
+  to="/about"
+  v-slot="{ href, route, navigate, isActive, isExactActive }"
+>
+  <NavLink :active="isActive" :href="href" @click="navigate">
+    {{ route.fullPath }}
+  </NavLink>
 </router-link>
 ```
 
-В этом случае `<a>` будет фактической ссылкой (и получит правильный `href`), но активный класс будет применён к внешнему `<li>`.
+- `href`: разрешённый URL. Это будет атрибутом `href` для элемента `a`
+- `route`: разрешённый нормализованный маршрут
+- `navigate`: функция для запуска навигации. **Она автоматически предотвращает события, когда это необходимо**, аналогичным способом, как это делает `router-link`
+- `isActive`: `true` если [активный класс](#active-class) должен применяться. Позволяет применить произвольный класс
+- `isExactActive`: `true` если [активный класс при точном совпадении пути](#exact-active-class) должен применяться. Позволяет применить произвольный класс
+
+### Пример: Добавление активного класса к внешнему элементу
+
+Иногда может потребоваться применять активный класс к внешнему элементу, а не к тегу `<a>`, в этом случае можно обернуть этот элемент в `<router-link>` и использовать свойства `v-slot` для создания ссылки:
+
+```html
+<router-link
+  to="/foo"
+  v-slot="{ href, route, navigate, isActive, isExactActive }"
+>
+  <li
+    :class="[isActive && 'router-link-active', isExactActive && 'router-link-exact-active']"
+  >
+    <a :href="href" @click="navigate">{{ route.fullPath }}</a>
+  </li>
+</router-link>
+```
+
+:::tip ПРИМЕЧАНИЕ
+При добавлении `target="_blank"` на элемент `a`, необходимо опустить обработчик `@click="navigate"`.
+:::
 
 ## Входные параметры `<router-link>`
 
@@ -58,7 +88,9 @@ sidebar: auto
   <router-link :to="{ name: 'user', params: { userId: 123 }}">User</router-link>
 
   <!-- с использованием query-строки, получим `/register?plan=private` -->
-  <router-link :to="{ path: 'register', query: { plan: 'private' }}">Register</router-link>
+  <router-link :to="{ path: 'register', query: { plan: 'private' }}">
+    Регистрация
+  </router-link>
   ```
 
 ### replace
@@ -166,8 +198,8 @@ sidebar: auto
 
   Декларация типа для `RouteConfig`:
 
-  ```js
-  declare type RouteConfig = {
+  ```ts
+  interface RouteConfig = {
     path: string,
     component?: Component,
     name?: string, // для именованных маршрутов
@@ -181,7 +213,7 @@ sidebar: auto
 
     // Добавлено в версии 2.6.0+
     caseSensitive?: boolean, // учитывать регистр при сравнении? (по умолчанию: false)
-    pathToRegexpOptions?: Object, // настройки path-to-regexp для компиляции regex
+    pathToRegexpOptions?: Object // настройки path-to-regexp для компиляции regex
   }
   ```
 
@@ -285,7 +317,9 @@ sidebar: auto
 ## Методы экземпляра Router
 
 ### router.beforeEach
+
 ### router.beforeResolve
+
 ### router.afterEach
 
 Сигнатуры:
@@ -307,16 +341,22 @@ router.afterEach((to, from) => {})
 Все три метода возвращают функцию для удаления зарегистрированного хука.
 
 ### router.push
+
 ### router.replace
+
 ### router.go
+
 ### router.back
+
 ### router.forward
 
 Сигнатуры:
 
 ```js
 router.push(location, onComplete?, onAbort?)
+router.push(location).then(onComplete).catch(onAbort)
 router.replace(location, onComplete?, onAbort?)
+router.replace(location).then(onComplete).catch(onAbort)
 router.go(n)
 router.back()
 router.forward()
@@ -425,37 +465,37 @@ router.onError(callback)
 
 ### Свойства объекта Route
 
-- **$route.path**
+- **\$route.path**
 
   - тип: `string`
 
     Строка пути текущего маршрута, всегда в абсолютном формате, например `"/foo/bar"`.
 
-- **$route.params**
+- **\$route.params**
 
   - тип: `Object`
 
     Объект, который содержит пары ключ/значение динамических сегментов маршрута (включая *-сегменты). Если параметров нет, то значением будет пустой объект.
 
-- **$route.query**
+- **\$route.query**
 
   - тип: `Object`
 
     Объект, который содержит пары ключ/значение строки запроса (query string). Например, для пути `/foo?user=1` получим `$route.query.user == 1`. Если строки запроса нет, то значением будет пустой объект.
 
-- **$route.hash**
+- **\$route.hash**
 
   - тип: `string`
 
     Хэш текущего маршрута (вместе с символом `#`) при его наличии. Если хэша нет, то значением будет пустая строка.
 
-- **$route.fullPath**
+- **\$route.fullPath**
 
   - тип: `string`
 
     Полная запись URL-адреса, включая строку запроса и хэш.
 
-- **$route.matched**
+- **\$route.matched**
 
   - тип: `Array<RouteRecord>`
 
@@ -465,7 +505,9 @@ router.onError(callback)
   const router = new VueRouter({
     routes: [
       // объект ниже — это запись маршрута
-      { path: '/foo', component: Foo,
+      {
+        path: '/foo',
+        component: Foo,
         children: [
           // это — тоже запись маршрута
           { path: 'bar', component: Bar }
@@ -477,11 +519,11 @@ router.onError(callback)
 
 Для URL `/foo/bar`, значение `$route.matched` будет массивом, содержащим копии объектов (клоны), в порядке сортировки от родителя к потомку.
 
-- **$route.name**
+- **\$route.name**
 
   Имя текущего маршрута, если было указано. (Подробнее в разделе [именованные маршруты](../guide/essentials/named-routes.md))
 
-- **$route.redirectedFrom**
+- **\$route.redirectedFrom**
 
   Имя маршрута с которого произошло перенаправление, если было указано. (Подробнее в разделе [перенаправления и псевдонимы](../guide/essentials/redirect-and-alias.md))
 
@@ -491,11 +533,11 @@ router.onError(callback)
 
 Эти свойства внедряются в каждый дочерний компонент, передавая экземпляр маршрутизатора в корневой экземпляр в качестве опции `router`.
 
-- **this.$router**
+- **this.\$router**
 
   Экземпляр маршрутизатора.
 
-- **this.$route**
+- **this.\$route**
 
   Текущий активный [маршрут](#объект-route). Это свойство только для чтения и все его свойства иммутабельны, но можно отслеживать их изменения.
 

diff --git a/docs/ru/guide/essentials/named-views.md b/docs/ru/guide/essentials/named-views.md
@@ -47,7 +47,7 @@ const router = new VueRouter({
 - `UserSettings` компонент представления
 - `UserEmailsSubscriptions`, `UserProfile`, `UserProfilePreview` вложенные компоненты представлений
 
-**Примечание**: _Давайте опустим как должен выглядеть HTML/CSS для реализации подобного шаблона и сосредоточимся на используемых компонентах_
+**Примечание**: _Давайте опустим как должен выглядеть HTML/CSS для реализации подобного шаблона и сосредоточимся на используемых компонентах._
 
 Секция `<template>` компонента `UserSettings` будет выглядеть примерно так:
 
@@ -61,7 +61,7 @@ const router = new VueRouter({
 </div>
 ```
 
-_Вложенные компоненты представлений в примере опущены, но вы можете посмотреть их полные исходные коды [здесь](https://jsfiddle.net/posva/22wgksa3/)_
+_Вложенные компоненты представлений в примере опущены, но вы можете посмотреть их полные исходные коды [здесь](https://jsfiddle.net/posva/22wgksa3/)._
 
 Затем вы можете скомпоновать шаблона выше в конфигурации маршрута:
 

diff --git a/docs/ru/guide/essentials/navigation.md b/docs/ru/guide/essentials/navigation.md
@@ -48,6 +48,8 @@ router.push({ path: '/user', params: { userId } }) // -> /user
 
 С версии 2.2.0+ можно опционально указать коллбэки `onComplete` и `onAbort` в `router.push` или `router.replace` в качестве 2-го и 3-го аргументов. Эти коллбэки будут вызываться когда навигация либо успешно завершена (после того как все асинхронные хуки будут завершены), или прервана (переходом на этот же маршрут, или на другой маршрут прежде чем текущая навигация будет завершена), соответственно.
 
+С версии 3.1.0+ можно опустить 2-й и 3-й аргументы, в таком случае `router.push`/`router.replace` будут возвращать Promise, если они поддерживаются окружением.
+
 **Примечание:** если путь назначения совпадает с текущим маршрутом и меняются только параметры (например, переход из одного профиля в другой `/users/1` -> `/users/2`), вам потребуется использовать [`beforeRouteUpdate`](./dynamic-matching.md#отсnеживание-изменений-параметров) для отслеживания изменений (например, загрузки информации о пользователе).
 
 ## `router.replace(location, onComplete?, onAbort?)`