☝ Предполагается, что к моменту прочтения этой статьи вы уже знаете, как создавать простое 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;
}
  1. Math.random () генерирует случайное число между 0 и 1. Например, нам выпало число 0.54.
  2. (max — min + 1): определяет количество возможных значений в заданном диапазоне. 10 - 0 + 1 = 11. Это значит, что у нас есть 11 возможных значений (0, 1, 2, ... 10).
  3. Math.random () * (max — min + 1): умножает случайное число на количество возможных значений: 0.54 * 11 = 5.94.
  4. Math.floor (): округляет число вниз до ближайшего целого. Так, Math.floor(5.94) = 5.
  5. ... + min: смещает диапазон так, чтобы минимальное значение соответствовало min. Но в нашем примере, так как min = 0, это не изменит результат. Пример: 5 + 0 = 5.
  6. Итак, в нашем примере получилось случайное число 5 из диапазона от 0 до 10.

Чтобы протестировать, запустите:

console.log(getRandomInRange(1, 10)); // Тест
JS
  • 7 сентября 2023
В чём разница между var и let

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

Читать дальше
JS
  • 30 августа 2023
Быстрый гайд по if, else, else if в JavaScript

Быстрый гайд по 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%.

🐈

JS
  • 30 августа 2023
Как исправить ошибки SyntaxError в JavaScript

Как исправить ошибки SyntaxError в JavaScript

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

Читать дальше
JS
  • 14 июля 2023
Как сделать простой слайдер на HTML и JavaScript

Как сделать простой слайдер на HTML и JavaScript

Вы сверстали сайт и сделали его красивым с помощью CSS. Осталось добавить интерактива, и можно добавлять проект в портфолио.

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

☝ Мы покажем лишь один из возможных вариантов. Это не эталонное решение, да в разработке и не бывает единственно верного способа решить задачу. Но код точно работает, поэтому можете скопировать его в свой проект.

Читать дальше
JS
  • 20 июня 2023
Полезные команды для работы с Node.js

Полезные команды для работы с Node.js

Перед тем как рассматривать полезные команды при работе с Node.js, её необходимо установить.

Команды помогают узнать версию Node.js,

node -h — показывает список всех доступных команд Node.js.

node -vnode --version — показывает установленную версию Node.js.

npm -h — показывает список всех доступных команд пакетного менеджера npm.

npm -vnpm --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. Таким образом, можно быстро переключаться между версиями, например, для тестирования.

JS
  • 8 июня 2023
Как составлять регулярные выражения

Как составлять регулярные выражения

Регулярное выражение — это последовательность символов (селекторов). Оно используется для поиска и обработки строк, слов, чисел и других текстовых данных.

Регулярные выражения выручают при решении разных задач. Например, с их помощью легко искать и менять строки в коде. Но чаще всего регулярные выражения используют для валидации форм. Давайте посмотрим, как это делать.

Зачем нужны регулярные выражения

Читать дальше
JS
  • 5 июня 2023
Проверка типа интерфейса в TypeScript

Проверка типа интерфейса в TypeScript

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

В чём разница между интерфейсами и типами

Читать дальше
JS
  • 30 мая 2023