Как работать с Vue 3 Router
- 28 февраля 2023
☝ Предполагается, что к моменту прочтения этой статьи вы уже знаете, как создавать простое Vue-приложение. Также предполагается, что приложение открывается по адресу localhost:8080
.
Для чего нужен маршрутизатор
При написании сайта или веб-приложения мы можем использовать обычные гиперссылки. Например, сделать панель навигации так:
<a href="/">Главная</a>
<a href="/settings">Настройки</a>
<a href="/contacts">Контакты</a>
Этот способ работает, но не всегда подходит, потому что каждый клик по ссылке приводит к загрузке новой страницы. Это нормальное поведение для статических сайтов — блога или ленты новостей. Но если мы хотим сделать интерфейс интерактивным, необходимо другое решение — например, использовать маршрутизатор.
Концепция Vue Router
Концепция маршрутизатора сводится к тому, что в зависимости от указанного пути и дополнительных параметров приложение отображает соответствующий контент. Например, наша логика подразумевает, что при переходе в /settings
отобразится компонент с настройками, а в /contacts
— форма обратной связи.
Давайте создадим простое Vue-приложение, которое реализует такую логику. Для быстрого старта воспользуйтесь шаблоном в CodeSandbox.
Мы намеренно опустим шаги по инициализации проекта, поскольку подразумевается, что с этим вы знакомы.
Для начала установим Vue Router:
npm install --save vue-router
Добавим в точку входа в приложение main.js
следующий код:
import { createApp } from 'vue'
import { createRouter, createWebHistory } from 'vue-router'
import App from './App.vue'
import HomeView from './views/HomeView.vue'
const router = createRouter({
routes: [{
path: '/',
component: HomeView
}],
history: createWebHistory()
})
const app = createApp(App)
app.use(router)
app.mount('#app')
Маршруты — это массив объектов, в котором мы описываем правила для отображения компонентов в зависимости от маршрута.
history
— это настройка, которая отвечает за механизм поведения Vue Router. Мы указали createWebHistory()
, то есть роутер будет использовать History API.
Чтобы посмотреть на работу Vue Router, добавим компонент <router-view>
, который отвечает за отображение. Он является своего рода контейнером, в котором отрисовывается компонент соответствующего маршрута.
App.vue
<template>
<router-view />
</template>
views/HomeView.vue
<template>
<main>
<h1>Главная</h1>
</main>
</template>
Если мы откроем приложение в браузере, то увидим страницу, которую описали в HomeView.vue
.
🚀 Изучите Vue.js 3
Научитесь с нуля создавать и стилизовать проект, добавлять анимации в веб-приложение и проводить тестирование.
Иерархия и вложенность маршрутов
Создадим страницу настроек views/SettingsView.vue
:
<template>
<main>
<h1>Настройки</h1>
</main>
</template>
Добавим новый объект в массив routes
в файле main.js
:
import SettingsView from './views/SettingsView.vue'
const router = createRouter({
routes: [{
path: '/',
component: HomeView
},
{
path: '/settings',
component: SettingsView
}],
history: createWebHistory()
})
Откроем в браузере страницу [<http://localhost:8080/settings>](<http://localhost:4137/settings>)
и увидим только что созданный нами компонент.
Теперь добавим дочерний маршрут для страницы настроек — например, настройки профиля:
views/SettingsProfileView.vue
<template>
<main>
<h2>Настройки профиля</h2>
</main>
</template>
Укажем это в массиве routes
в файле main.js
:
import SettingsProfileView from './views/SettingsProfileView.vue'
const router = createRouter({
routes: [{
path: '/',
component: HomeView
},
{
path: '/settings',
component: SettingsView,
children: [{
path: 'profile',
component: SettingsProfileView
}]
}],
history: createWebHistory()
})
Однако, открыв страницу по маршруту /settings/profile
, мы не увидим изменений. Для отображения дочерних маршрутов их родитель (в нашем случае SettingsView.vue
) должен также содержать <router-view>
. Исправим это:
views/SettingsView.vue
<template>
<main>
<h1>Настройки</h1>
<section>
<router-view />
</section>
</main>
</template>
Теперь всё работает так, как мы и предполагали.
Навигация между маршрутами
Для привычной навигации по ссылкам необходимо использовать компонент <router-link>
. Он принимает проп :to
, который указывает, куда будет вести ссылка. Можно прописать полный путь или параметры маршрута — например, имя и query
-парметры, которые мы рассмотрим далее.
Давайте зададим маршрутам имена и посмотрим, как это работает.
const router = createRouter({
routes: [{
path: '/',
name: 'home',
component: HomeView
},
{
path: '/settings',
name: 'settings',
component: SettingsView,
children: [{
path: 'profile',
name: 'settings-profile',
component: SettingsProfileView
}]
}],
history: createWebHistory()
})
В компоненте views/SettingsView.vue
добавим ссылку на главную страницу:
<template>
<main>
<h1>Настройки</h1>
<section>
<router-view />
</section>
<footer>
<router-link :to="{ name: 'home' }">
На главную
</router-link>
</footer>
</main>
</template>
Если мы откроем код страницы /settings
в инспекторе, то увидим, что «На главную» — это обычный тег <a>
. Но при нажатии на ссылку страница не станет перезагружаться — Vue Router меняет поведение ссылок, определённых при помощи <router-link>
.
А если мы хотим реализовать навигацию на JavaScript — например, когда пользователь совершает какое-то действие, то можем воспользоваться методом push
или replace
. Они отличаются тем, что push
сохраняется в истории навигации браузера, а replace
перезаписывает текущее состояние.
Для примера добавим кнопку, открывающую настройки профиля, в компонент views/SettingsView.vue
:
<template>
<main>
<h1>Настройки</h1>
<section>
<button @click="router.push({ name: 'settings-profile' })">
Открыть настройки профиля
</button>
</section>
<section>
<router-view />
</section>
<footer>
<router-link :to="{ name: 'home' }">
На главную
</router-link>
</footer>
</main>
</template>
<script setup>
import {
useRouter
} from 'vue-router'
const router = useRouter()
</script>
Теперь, находясь на странице /settings
и нажав на кнопку, мы попадаем на /settings/profile
и видим надпись «Настройки профиля».
Также добавим панель навигации на главную страницу. Пока что там будет только ссылка на настройки.
views/HomeView.vue
<template>
<main>
<h1>Главная</h1>
<section>
<ul>
<li>
<router-link :to="{ name: 'settings' }">
Настройки
</router-link>
</li>
</ul>
</section>
</main>
</template>
Маршрутизатор и Composition API
Vue Router предоставляет два основных Composition API для работы с маршрутами: useRouter
и useRoute
.
useRouter — используется для получения доступа к самому маршрутизатору. В примере выше мы вызывали useRouter()
, чтобы получить объект маршрутизатора.
Прочитать про useRouter в документации
useRoute — используется для получения текущего маршрута. Рассмотрим его подробнее.
Ранее мы добавили кнопку «Показать настройки профиля», но она не пропадает, даже когда мы открываем эти настройки. Давайте исправим эту ошибку.
views/SettingsView.vue
<template>
<main>
<h1>Настройки</h1>
<section v-if="route.name === 'settings'">
<button @click="router.push({ name: 'settings-profile' })">
Открыть настройки профиля
</button>
</section>
<section>
<router-view />
</section>
<footer>
<router-link :to="{ name: 'home' }">
На главную
</router-link>
</footer>
</main>
</template>
<script setup>
import {
useRouter,
useRoute
} from 'vue-router'
const router = useRouter()
const route = useRoute()
</script>
Теперь блок с кнопкой будет отображаться, только если открыта страница по маршруту, потому что мы дали ей имя — settings
— и проверили его в компоненте.
Прочитать про useRoute в документации
Параметры маршрута
При помощи useRoute
можно получить доступ к параметрам маршрута.
Создадим новый компонент views/UserView.vue
:
<template>
<main>
<h1>Пользователь ID {{ id }}</h1>
<section>
<router-link :to="{ name: 'home' }">
На главную
</router-link>
</section>
</main>
</template>
<script setup>
import {
computed
} from 'vue'
import {
useRoute
} from 'vue-router'
const route = useRoute()
const id = computed(() => route.params.id)
</script>
Компонент предполагает, что текущий маршрут содержит параметр id
. Давайте добавим этот идентификатор:
import UserView from './views/UserView.vue'
const router = createRouter({
routes: [{
path: '/',
name: 'home',
component: HomeView
},
{
path: '/settings',
name: 'settings',
component: SettingsView,
children: [{
path: 'profile',
name: 'settings-profile',
component: SettingsProfileView
}]
},
{
path: '/user/:id',
name: 'user',
component: UserView
}],
history: createWebHistory()
})
Запись path
вида /user/:id
означает, что если мы зайдём на страницу /user/123
, то маршрутизатор рассмотрит 123
как параметр id
. Соответственно, если мы откроем /user/123
в браузере, то увидим текст «Пользователь ID: 123».
Добавим также ссылку на пользователя 123 на главной странице.
views/HomeView.vue
<template>
<main>
<h1>Главная</h1>
<section>
<ul>
<li>
<router-link :to="{ name: 'settings' }">
Настройки
</router-link>
</li>
<li>
<router-link :to="{ name: 'user', params: { id: 123 } }">
Пользователь 123
</router-link>
</li>
</ul>
</section>
</main>
</template>
Прочитать про согласование маршрутов с параметрами
Страница ошибки «Страница не найдена»
Чтобы создать страницу для 404 ошибки, в конец массива маршрутов положим объект вида:
{
path: '/:pathMatch(.*)*',
name: '404',
component: NotFoundView
}
main.js
import NotFoundView from './views/NotFoundView.vue'
const router = createRouter({
routes: [{
path: '/',
name: 'home',
component: HomeView
},
{
path: '/settings'
name: 'settings',
component: SettingsView,
children: [{
path: 'profile',
name: 'settings-profile',
component: SettingsProfileView
}]
},
{
path: '/user/:id',
name: 'user',
component: UserView
},
{
path: '/:pathMatch(.*)*',
name: '404',
component: NotFoundView
}
],
history: createWebHistory()
})
views/NotFoundView.vue
<template>
<main>
Страница не найдена
</main>
</template>
Теперь, если мы зайдём на страницу по пути /whatever
или любому несуществующему пути, то увидим надпись «Страница не найдена».
Прочитать про 404 в документации
Защищённые маршруты и метаданные
Предположим, нам нужно запретить переход неавторизованных пользователей по маршруту /settings
. Обозначим дополнительное поле в объекте — метаданные:
const router = createRouter({
routes: [{
path: '/',
name: 'home',
component: HomeView
},
{
path: '/settings'
name: 'settings',
component: SettingsView,
children: [{
path: 'profile',
name: 'settings-profile',
component: SettingsProfileView,
meta: {
requiresAuth: true
}
}]
},
{
path: '/user/:id',
name: 'user',
component: UserView
},
{
path: '/:pathMatch(.*)*',
name: '404',
component: NotFoundView
}],
history: createWebHistory()
})
Теперь мы сможем обращаться к этому полю, когда оперируем объектом текущего маршрута — например, как в примерах выше, с помощью useRoute()
.
Однако чтобы не делать проверку прямо в компонентах, воспользуемся встроенным механизмом Vue Router:
main.js
const router = createRouter({
...
})
// Для упрощения укажем это в переменной
const isAuthenticated = false
router.beforeEach((to, from) => {
if (to.meta.requiresAuth && !isAuthenticated) {
return {
name: 'home'
}
}
})
В этом примере если неавторизованный пользователь попытается зайти на /settings/profile
, выполнится редирект на главную.
Анимация переходов между страницами
☝ Предполагается, что к этому моменту вы уже знакомы с концепцией работы компонента <transition>
во Vue.
Давайте добавим анимацию смены маршрутов в наше приложение. Откроем файл App.vue
и изменим его <template>
.
<template>
<router-view v-slot="{ Component }">
<transition name="fade" mode="out-in">
<component :is="Component" />
</transition>
</router-view>
</template>
В данном примере мы получаем компонент, который рендерится внутри <router-view>
(в нашем случае — корневого). Затем передаём этот компонент внутрь <transition>
, который будет вызывать анимацию при смене компонента.
Если вы откроете приложение в браузере и попробуете перейти по страницам, ничего не произойдёт, ведь пока что у <transition>
не добавлена анимация. Давайте это исправим. Добавим к <transition>
атрибут name и укажем стили.
App.vue
<template>
<router-view v-slot="{ Component }">
<transition name="fade" mode="out-in">
<component :is="Component" />
</transition>
</router-view>
</template>
<style>
.fade-enter-active,
.fade-leave-active {
transition: opacity 0.5s ease;
}
.fade-enter-from,
.fade-leave-to {
opacity: 0;
}
</style>
Теперь всё работает как нужно. Готовый проект в CodeSandbox.
Прочитать про анимации в документации
Заключение
В этой статье мы рассмотрели основные концепции работы Vue Router. Этого достаточно, чтобы написать простое приложение. Но чтобы глубже разобраться в теме, рекомендуем изучить документацию и больше практиковаться.
Больше материалов
«Доктайп» — журнал о фронтенде. Читайте, слушайте и учитесь с нами.
Читать дальше

Случайное число из диапазона
Допустим, вам зачем-то нужно целое случайное число от min
до max
. Вот сниппет, который поможет:
function getRandomInRange(min, max) {
return Math.floor(Math.random() * (max - min + 1)) + min;
}
- Math.random () генерирует случайное число между 0 и 1. Например, нам выпало число
0.54
. - (max — min + 1): определяет количество возможных значений в заданном диапазоне.
10 - 0 + 1 = 11
. Это значит, что у нас есть 11 возможных значений (0, 1, 2, ... 10). - Math.random () * (max — min + 1): умножает случайное число на количество возможных значений:
0.54 * 11 = 5.94
. - Math.floor (): округляет число вниз до ближайшего целого. Так,
Math.floor(5.94) = 5
. - ... + min: смещает диапазон так, чтобы минимальное значение соответствовало
min
. Но в нашем примере, так какmin = 0
, это не изменит результат. Пример:5 + 0 = 5
. - Итак, в нашем примере получилось случайное число 5 из диапазона от 0 до 10.
Чтобы протестировать, запустите:
console.log(getRandomInRange(1, 10)); // Тест
- 7 сентября 2023

В чём разница между var и let
Если вы недавно пишете на JavaScript, то наверняка задавались вопросом, чем отличаются var
и let
, и что выбрать в каждом случае. Объясняем.
var
и let
— это просто два способа объявить переменную. Вот так:
var x = 10;
let y = 20;
Переменная, объявленная через var
, доступна только внутри «своей» функции, или глобально, если она была объявлена вне функции.
function myFunction() {
var z = 30;
console.log(z); // 30
}
myFunction();
console.log(z); // ReferenceError
Это может создавать неожиданные ситуации. Допустим, вы создаёте цикл в функции и хотите, чтобы переменная i
осталась в этой функции. Если вы используете var
, эта переменная «утечёт» за пределы цикла и будет доступна во всей функции.
Переменные, объявленные с помощью let
доступны только в пределах блока кода, в котором они были объявлены.
if (true) {
let a = 40;
console.log(a); // 40
}
console.log(a); // ReferenceError
В JavaScript блок кода — это участок кода, заключённый в фигурные скобки {}
. Это может быть цикл, код в условном операторе или что-нибудь ещё.
if (true) {
let blockScoped = "Я виден только здесь";
console.log(blockScoped); // "Я виден только здесь"
}
// здесь переменная blockScoped недоступна
console.log(blockScoped); // ReferenceError
Если переменная j
объявлена в цикле с let
, она останется только в этом цикле, и попытка обратиться к ней за его пределами вызовет ошибку.
- 30 августа 2023

Быстрый гайд по if, else, else if в JavaScript
Допустим, вы собираетесь идти на прогулку. Если на улице солнечно, вы возьмёте с собой солнечные очки.
Это можно описать с помощью оператора if
.
let weather = "sunny";
if (weather === "sunny") {
console.log("Возьму солнечные очки");
}
А если погода не солнечная, а, скажем, дождливая, вы возьмете зонт.
Этот сценарий можно описать с помощью if-else
.
let weather = "rainy";
if (weather === "sunny") {
console.log("Возьму солнечные очки");
} else {
console.log("Возьму зонт");
}
Условный оператор if-else if-else
Теперь представим, что у вас есть несколько вариантов транспорта для дороги на работу: машина, велосипед, общественный транспорт. Выбор будет зависеть от различных условий, например, погоды и времени суток. Логично, что в дождь безопаснее ехать на автобусе, а в хорошую погоду можно прокатиться на машине или велосипеде, если утро и пробки. То есть схема такая:
И всё это очень легко описывается кодом:
let weather = "sunny";
let time = "morning";
if (weather === "rainy") { // если дождь, то только так
console.log("Еду на автобусе");
} else if (time === "morning") { // если не дождь и утро
console.log("Еду на велике мимо пробок");
} else { // если второе не дождь и не утро
console.log("Еду на машине");
}
Ветвление только может показаться сложным, но вообще оно очень логичное, если понять, какие действия после каких условий выполняются. Разберитесь один раз и поймёте на всю жизнь, 100%.
🐈
- 30 августа 2023

Как исправить ошибки SyntaxError в JavaScript
Ошибки SyntaxError появляются, если разработчик нарушил правила синтаксиса JavaScript, например, пропустил закрывающую скобку или точку с запятой. Давайте посмотрим, что означает каждая ошибка и в чём может быть проблема.
- 14 июля 2023

Ошибка TypeError: что это и как её исправить
Ошибки TypeError появляются, когда разработчики пытаются выполнить операцию с неправильным типом данных. Давайте разберём несколько примеров: почему появилась ошибка и как её исправить.
- 7 июля 2023

3 способа объявить функцию в JavaScript
Функции в JavaScript можно объявить тремя способами: через декларативное объявление, функциональное выражение или с помощью стрелок. Звучит сложно, но на самом деле всё совсем не так.
- 30 июня 2023

Как сделать простой слайдер на HTML и JavaScript
Вы сверстали сайт и сделали его красивым с помощью CSS. Осталось добавить интерактива, и можно добавлять проект в портфолио.
«Оживить» на сайте можно что угодно: меню, модальные окна, корзину, пагинацию… В этой статье мы разберём слайдер — посмотрим, как его сделать на чистом JavaScript. Слайдер пригодится для раздела с отзывами, фотографиями сотрудников, изображениями товаров или чего-нибудь ещё — всё зависит только от вашей фантазии и проекта.
☝ Мы покажем лишь один из возможных вариантов. Это не эталонное решение, да в разработке и не бывает единственно верного способа решить задачу. Но код точно работает, поэтому можете скопировать его в свой проект.
- 20 июня 2023

Полезные команды для работы с Node.js
Перед тем как рассматривать полезные команды при работе с Node.js, её необходимо установить.
Команды помогают узнать версию Node.js,
node -h
— показывает список всех доступных команд Node.js.
node -v
, node --version
— показывает установленную версию Node.js.
npm -h
— показывает список всех доступных команд пакетного менеджера npm
.
npm -v
, npm --version
— показывает установленную версию npm
.
Команда npm update npm -g
позволяет обновить версию npm
.
npm list --depth=0
показывает список установленных пакетов.
Команда npm outdated --depth=0
покажет список установленных пакетов, которые требуют обновления. Если все пакеты обновлены, список будет пустым.
npm install package
— позволяет установить любой пакет по его имени. Если при этом к команде добавить префикс -g
пакет будет установлен глобально на весь компьютер.
Команда npm i package
является укороченной альтернативой предыдущей команды.
Если вы хотите установить конкретную версию пакета, воспользуйтесь префиксом @
с номером версии. Например, npm install package@1.0.1
.
npm uninstall package
— удаляет установленный пакет по имени.
Команда npm list package
— покажет версию установленного пакета, а команда npm view package version
— последнюю версию пакета, которая существует.
Для работы с пакетным менеджером также пригодится файл package.json
, который должен лежать в директории, с которой происходит работа в консоли.
Он содержит различные мета-данные, например, имя проекта, версия, описания и автор. Также он содержит список зависимостей, которые будут установлены, если вызвать из этой папки команду npm install
.
Кроме этого он ещё имеет скрипты, которые вызывают другие команды консоли. Например, для этого файла вызов команды npm start
вызовет запуск задачи Grunt с именем dev
. А команда npm run build
вызовет скрипт build
, который запустит задачу в Grunt с именем build
.
Во время работы часто возникает необходимость установить некоторые пакеты. Если установить пакет с префиксом --save
, то он автоматически запишется в package.json
в раздел dependencies
. Такая же команда с префиксом --save-dev
запишет пакет в раздел devDependencies
.
Что такое nvm
nvm (илиNode Version Manager) — утилита, которая позволяет быстро менять версии Node.js.
Чтобы её установить, достаточно запустить скрипт
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.31.0/install.sh | bash
Теперь можно установить последнюю версию Node.js, например,5.0
с помощью команды nvm install 5.0
. Чтобы начать использовать её, введите команду nvm use 5.0
. Таким образом, можно быстро переключаться между версиями, например, для тестирования.
- 8 июня 2023

Как составлять регулярные выражения
Регулярное выражение — это последовательность символов (селекторов). Оно используется для поиска и обработки строк, слов, чисел и других текстовых данных.
Регулярные выражения выручают при решении разных задач. Например, с их помощью легко искать и менять строки в коде. Но чаще всего регулярные выражения используют для валидации форм. Давайте посмотрим, как это делать.
- 5 июня 2023

Проверка типа интерфейса в TypeScript
Проверка типов интерфейса — одна из ключевых возможностей TypeScript. Она помогает убедиться, что объект или класс содержат необходимый набор свойств и методов, указанных в интерфейсе. Благодаря проверке типов вы можете писать более надёжный код, ведь часть ошибок будет найдена ещё на этапе компиляции.
- 30 мая 2023