diff --git a/docs/ru/advanced/lazy-loading.md b/docs/ru/advanced/lazy-loading.md index 564a8b1e3..bc6b44261 100644 --- a/docs/ru/advanced/lazy-loading.md +++ b/docs/ru/advanced/lazy-loading.md @@ -2,7 +2,7 @@ При использовании модульного сборщика, результирующая JavaScript-сборка может оказаться довольно большой, что негативно сказывается на времени загрузки страницы. В некоторых случаях было бы эффективнее разделить компоненты каждого пути на отдельные минисборки, и загружать их только при переходе к соответствующему пути. -Совместное использование [асинхронной загрузки компонентов](http://vuejs.org/guide/components.html#Async-Components) Vue и [разделения кода](https://webpack.js.org/guides/code-splitting-require/) WebPack делает реализацию ленивой загрузки компонентов в зависимости от путей тривиальной. +Совместное использование [асинхронной загрузки компонентов](https://ru.vuejs.org/v2/guide/components.html#Асинхронные-компоненты) Vue и [разделения кода](https://webpack.js.org/guides/code-splitting-require/) WebPack делает реализацию ленивой загрузки компонентов в зависимости от путей тривиальной. Всё, что требуется — определить компоненты путей как асинхронные: diff --git a/docs/ru/advanced/navigation-guards.md b/docs/ru/advanced/navigation-guards.md index 52d117ae5..9a2e223e8 100644 --- a/docs/ru/advanced/navigation-guards.md +++ b/docs/ru/advanced/navigation-guards.md @@ -32,6 +32,8 @@ router.beforeEach((to, from, next) => { - **`next('/')` или `next({ path: '/' })`**: редирект на другой путь. Текущий переход будет отменён, и процесс начнётся заново для нового пути. + - **`next(error)`**: (добавлено в версии 2.4.0+) если аргумент, переданный `next` является экземпляром `Error`, навигация будет прервана и ошибка будет передана в коллбек, зарегистрированный через `router.onError()`. + **Удостоверьтесь, что функция `next` так или иначе будет вызвана, иначе хук никогда не будет разрешён.** Можно также зарегистрировать глобальные хуки, вызываемые после завершения перехода. Однако, в отличие от сторожевых хуков, в них не передаётся функция `next`, и на ход перехода они повлиять не могут: diff --git a/docs/ru/advanced/transitions.md b/docs/ru/advanced/transitions.md index c2be44973..795ae1c7f 100644 --- a/docs/ru/advanced/transitions.md +++ b/docs/ru/advanced/transitions.md @@ -8,7 +8,7 @@ ``` -Всё, [что сказано о `` в документации основной библиотеки](http://vuejs.org/guide/transitions.html), применимо и здесь. +Всё, [что сказано о `` в документации основной библиотеки](https://ru.vuejs.org/v2/guide/transitions.html), применимо и здесь. ### Анимация переходов для конкретных путей diff --git a/docs/ru/api/component-injections.md b/docs/ru/api/component-injections.md index d4a9ea1d0..555d63ae9 100644 --- a/docs/ru/api/component-injections.md +++ b/docs/ru/api/component-injections.md @@ -15,6 +15,7 @@ ### Доступные опции - **beforeRouteEnter** +- **beforeRouteUpdate** (добавлено в версии 2.2) - **beforeRouteLeave** См. [раздел документации о сторожевых хуках](../advanced/navigation-guards.md#incomponent-guards). diff --git a/docs/ru/api/options.md b/docs/ru/api/options.md index b52e5623b..6d60579f6 100644 --- a/docs/ru/api/options.md +++ b/docs/ru/api/options.md @@ -68,3 +68,11 @@ ``` Для подробностей см. [Скроллинг](../advanced/scroll-behavior.md). + +### parseQuery / stringifyQuery + +> Добавлено в версии 2.4.0+ + +- Тип: `Function` + + Пользовательские функции для парсинга строки запроса / приведения к строке запроса (функции stringify). Переопределяют значения по умолчанию. \ No newline at end of file diff --git a/docs/ru/api/router-instance.md b/docs/ru/api/router-instance.md index 130730412..09570f6fc 100644 --- a/docs/ru/api/router-instance.md +++ b/docs/ru/api/router-instance.md @@ -60,10 +60,24 @@ Динамически добавить дополнительные маршруты в маршрутизатор. Аргументом должен быть массив маршрутов в таком же формате как и в опции `routes` конструктора. -- **router.onReady(callback)** +- **router.onReady(callback[, errorCallback])** > 2.2.0+ Этот метод добавляет в очередь коллбек, который будет вызван когда маршрутизатор завершит начальную навигацию, что означает что будут завершены все асинхронные хуки и будут готовы асинхронные компоненты связанные с начальным маршрутом. Это будет полезно при рендеринге на стороне сервера для обеспечения одинакового результата как на сервере, так и на клиенте. + + Второй аргумент `errorCallback` поддерживается только в версиях 2.4+. Он вызывается, когда исходное разрешение маршрута заканчивается ошибкой (например, не удалось разрешить асинхронный компонент). + +- **router.onError(callback)** + + > Добавлено в версии 2.4.0+ + + Регистрация коллбека, который будет вызываться при ошибках во время навигации по маршруту. Обратите внимание, что для вызова ошибки должен быть использован один из следующих сценариев: + + - Ошибка произошла синхронно внутри функции маршрута; + + - Ошибка фиксируется и асинхронно обрабатывается с помощью `next(err)` внутри функции сторожевого хука; + + - Произошла ошибка при попытке разрешить асинхронный компонент, необходимый для отображения маршрута. \ No newline at end of file diff --git a/docs/ru/essentials/getting-started.md b/docs/ru/essentials/getting-started.md index 8714e18e2..c0876cdd9 100644 --- a/docs/ru/essentials/getting-started.md +++ b/docs/ru/essentials/getting-started.md @@ -4,7 +4,7 @@ Создать одностраничное приложение используя Vue.js и Vue-router очень просто. Используя Vue.js, мы уже компонуем своё приложение из компонентов. Добавляя Vue-router, мы просто сопоставляем компонентам пути, и указываем, где именно их отображать. Вот простой пример: -> Все примеры используют standalone-сборку Vue, которая позволяет использовать парсинг шаблонов. Подробнее о разнице сборок можно почитать [в документации к Vue.js](https://ru.vuejs.org/v2/guide/installation.html#Standalone-%D0%B8%D0%BB%D0%B8-runtime-%D1%81%D0%B1%D0%BE%D1%80%D0%BA%D0%B0). +> Все примеры используют standalone-сборку Vue, которая позволяет использовать парсинг шаблонов. Подробнее о разнице сборок можно почитать [в документации к Vue.js](https://ru.vuejs.org/v2/guide/installation.html#Объяснение-различных-сборок). ### HTML diff --git a/docs/ru/essentials/navigation.md b/docs/ru/essentials/navigation.md index 5cec9f92b..dad2183fd 100644 --- a/docs/ru/essentials/navigation.md +++ b/docs/ru/essentials/navigation.md @@ -4,6 +4,8 @@ #### `router.push(location, onComplete?, onAbort?)` +**Примечание: Внутри экземпляра Vue у вас есть доступ к экземпляру маршрутизатора через `$router`. Поэтому вы можете вызвать `this.$router.push`.** + Для перехода к новому URL, используйте `router.push`. Этот метод добавляет новую запись в стек истории навигации, что позволяет клику пользователя по кнопке "назад" в браузере сработать привычным образом. При клике на `` этот метод вызывается автоматически. Клик по `` эквивалентен императивному вызову `router.push(...)`. diff --git a/docs/ru/essentials/passing-props.md b/docs/ru/essentials/passing-props.md index fa20574c3..81f67e4de 100644 --- a/docs/ru/essentials/passing-props.md +++ b/docs/ru/essentials/passing-props.md @@ -27,6 +27,13 @@ const User = { const router = new VueRouter({ routes: [ { path: '/user/:id', component: User, props: true } + + // для маршрутов с именованными представлениями, необходимо указывать опцию props для каждого именованного представления: + { + path: '/user/:id', + components: { default: User, sidebar: Sidebar }, + props: { default: true, sidebar: false } + } ] }) ``` diff --git a/docs/ru/essentials/redirect-and-alias.md b/docs/ru/essentials/redirect-and-alias.md index 9c1698476..84d7a765e 100644 --- a/docs/ru/essentials/redirect-and-alias.md +++ b/docs/ru/essentials/redirect-and-alias.md @@ -27,7 +27,7 @@ const router = new VueRouter({ ``` js const router = new VueRouter({ routes: [ - { path: '/a', redirect: to => { + { path: '/a', redirect: to => { // в функцию в качестве аргумента передаётся путь // возвращаемым значением должна быть строка или объект пути }}