☝ Предполагается, что к моменту прочтения этой статьи вы уже знаете, как создавать простое 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. Этого достаточно, чтобы написать простое приложение. Но чтобы глубже разобраться в теме, рекомендуем изучить документацию и больше практиковаться.

Больше материалов


«Доктайп» — журнал о фронтенде. Читайте, слушайте и учитесь с нами.

ТелеграмПодкастБесплатные учебники

Читать дальше

FormControl и FormGroup в Angular

FormControl и FormGroup в Angular

Если вы разрабатываете веб-приложение, вам рано или поздно придётся собирать данные от пользователя. К счастью, реактивные формы в Angular позволяют делать это без лишней сложности — без нагромождения директив и с минимальным количеством шаблонного кода. Более того, их просто валидировать, так что можно обойтись даже без end-to-end тестов.

Говоря проще, form control’ы в Angular дают полный контроль разработчику — ничего не происходит автоматически, и каждое решение по вводу и управлению принимается явно и осознанно. В этом руководстве мы покажем, как объединять form control’ы в form group’ы, чтобы структурировать форму и упростить доступ к её элементам — как к логическим блокам. Чтобы лучше понять, как работают form group’ы в Angular, мы шаг за шагом соберём реактивную форму.

Для работы с примером скачайте стартовый проект с GitHub и откройте его в VS Code. Если ещё не обновляли Angular, поставьте актуальную на момент написания версию — Angular v18.

Читать дальше
JS
  • 1 июня 2025
AOT против JIT-компилятора: что лучше для разработки на Angular?

AOT против JIT-компилятора: что лучше для разработки на Angular?

Angular — один из самых популярных фреймворков для фронтенда — предлагает два подхода к компиляции: предварительная компиляция и динамическая компиляция во время выполнения. Оба метода играют важную роль в оптимизации приложений на Angular и повышении их производительности. В этом материале мы рассмотрим различия между ними, их преимущества и разберёмся, когда стоит использовать каждый из подходов.

Читать дальше
JS
  • 25 мая 2025
Динамические формы в Angular 19: пошаговое руководство

Динамические формы в Angular 19: пошаговое руководство

Формы — неотъемлемая часть большинства веб-приложений: будь то регистрация, ввод данных или опросы. Модуль реактивных форм в Angular отлично подходит для создания статичных форм, но во многих случаях требуется, чтобы форма могла динамически адаптироваться в зависимости от действий пользователя или внешних данных.

В этой статье мы рассмотрим, как создавать динамические формы с использованием автономных компонентов в Angular 19, применяя модульный подход, который избавляет от необходимости использовать традиционные модули Angular. В сопроводительном репозитории на GitHub для оформления форм используется Tailwind CSS, однако в статье внимание сосредоточено исключительно на логике динамических форм. Tailwind и связанные с ним настройки намеренно не включены в примеры, чтобы сохранить акцент на основной теме.

Читать дальше
JS
  • 25 мая 2025
Как обнаружить изменения в Angular: пошаговая инструкция

Как обнаружить изменения в Angular: пошаговая инструкция

Как разработчики на Angular, мы нередко задумываемся, как фреймворк отслеживает изменения в данных и затем отображает их во вьюхе. Этот процесс называется стратегией обнаружения изменений в Angular. В этом материале мы разберёмся, как это работает, и научимся выбирать подходящую стратегию для разных сценариев.

Читать дальше
JS
  • 24 мая 2025
Компоненты в Angular 18: пошаговое руководство

Компоненты в Angular 18: пошаговое руководство

Angular развивается стремительно, и с выходом версии 18 появились новые возможности, которые разработчики могут использовать в своей работе. Одним из ключевых изменений в Angular 18 стало удаление традиционного файла app.module.ts — ему на смену пришли standalone-компоненты. Если вы только начинаете работать с Angular или переходите с более ранней версии, это пошаговое руководство поможет вам разобраться в базовых принципах компонентов в Angular 18. Независимо от вашего уровня — новичок вы или опытный разработчик — этот туториал покажет, как создавать, управлять и эффективно использовать компоненты в Angular.

Читать дальше
JS
  • 19 мая 2025
Полное руководство по Angular @if

Полное руководство по Angular @if

Одно из самых заметных нововведений в Angular — это встроенный синтаксис для управляющих конструкций, который появился в версии 17. Он решает одну из самых частых задач, с которой сталкивается каждый разработчик: показывать или скрывать элементы на странице в зависимости от условия. Раньше для этого использовали привычную структурную директиву *ngIf. Теперь у нас есть более современная альтернатива — синтаксис @if, часть нового подхода к управлению шаблоном.

В этом гайде мы сравним оба варианта, разберёмся, чем @if лучше, и покажем, как можно перейти на него автоматически. Также поговорим об одной распространённой ошибке — о том, как не стоит использовать @if вместе с пайпом async.

Читать дальше
JS
  • 18 мая 2025
Модули Angular для организации кода и ленивой загрузки

Модули Angular для организации кода и ленивой загрузки

Модули — один из ключевых инструментов Angular для построения масштабируемых и поддерживаемых приложений. В этой статье мы подробно рассмотрим:

  • что такое модули в Angular;
  • зачем они нужны;
  • как их использовать для структурирования кода;
  • как реализовать «ленивую» загрузку модулей;
  • и чем отличаются Feature, Core и Shared модули.

Если вы только начинаете изучать Angular или хотите углубить свои знания, эта статья поможет вам лучше понять, как правильно организовать архитектуру Angular-приложения.

Читать дальше
JS
  • 12 мая 2025
Навигация в Angular: RouterLink, Router.navigate и Router.navigateByUrl

Навигация в Angular: RouterLink, Router.navigate и Router.navigateByUrl

Директива RouterLink позволяет настраивать переходы между маршрутами прямо в шаблоне Angular. А методы Router.navigate и Router.navigateByUrl, доступные в классе Router, дают возможность управлять навигацией программно — прямо из кода компонентов.

Разберёмся, как работают RouterLink, Router.navigate и Router.navigateByUrl.

Читать дальше
JS
  • 11 мая 2025
Полное руководство по Lazy Loading в Angular

Полное руководство по Lazy Loading в Angular

Если вы создаёте большое Angular-приложение, вам наверняка важно, чтобы оно загружалось быстро. Представьте, что вы устраиваете вечеринку и хотите подавать закуски не сразу, а по мере прихода гостей, чтобы не перегрузить кухню. «Ленивая» загрузка в Angular работает примерно так же: вместо того чтобы загружать всё приложение целиком сразу, вы подгружаете только те части, которые нужны — и только когда они нужны.

В этом пошаговом руководстве мы разберём, как реализовать lazy loading в Angular.

Читать дальше
JS
  • 10 мая 2025
Все (ну или почти все) способы автоматически перезагрузить страницу раз в N секунд

Все (ну или почти все) способы автоматически перезагрузить страницу раз в N секунд

Иногда страницу нужно просто перезагрузить. Полностью. Не компонент, не блок, а именно целиком. Без обсуждений, без лишней логики. Например, чтобы:

  • экран с результатами обновлялся каждые 10 секунд;
  • интерфейс на стенде показывал последние данные без кнопок;
  • страницы в интранете не устаревали, пока никто не смотрит.

Это можно сделать в любой связке: HTML, JS, Python, PHP, Go, Node.js — не важно. Ну и если говорить совсем прямо, то совсем разных способов всего три, а остальное просто вариации.

Читать дальше
JS
  • 5 мая 2025