Skip to content

Vue router ​

A Vue Router a hivatalos kliens-oldali routing plugin a Vue-ban.

Telepítés ​

Amennyiben a projekt még nem tartalmazza, úgy külön fel kell rakni, például:

bash
pnpm add vue-router

Komponensek ​

  • A RouterView komponens célja, hogy megjelenítse az oldal tartalmát.
  • A RouterLink komponens célja, hogy a megadott útvonalra mutató hivatkozást állítson elő.

Vue Router beüzemelése ​

Az első lépés a példányosítás. Ennek az eszköze a vue-router csomagban található createRouter függvény lesz.

js
import { createRouter, createWebHistory } from 'vue-router';

export const router = createRouter({
    history: createWebHistory(),
    routes,
});

Két dolgot kell neki megadni:

  • az útvonalakat és
  • az előzmények kezelésének módját.

Útvonalak definiálása ​

Az útvonalakat egy tömbben határozhatjuk meg manuálisan. Az alábbi példa egy minimális beállítást mutat be.

js
import HomeView from './HomeView.vue';
import CarIndexView from './CarIndexView.vue';
import CarShowView from './CarShowView.vue';

const routes = [
    { path: '/', component: HomeView },
    { path: '/cars', component: CarIndexView },
    { path: '/cars/:id', component: CarShowView },
]
  • A path az útvonal, ahogy el szeretnénk érni az adott oldalt.
  • A component az annak a komponensnek az elérése, amit meg kell jelenítenie az adott útvonal esetén. Ezeket a komponenseket nézetnek hívjuk. Az itt meghatározott komponens <RouterView>-ban fog megjelenni.

Előzmények módjai ​

Az URL generálását többféleképpen is meg lehet adni. Ezek szintén a 'vue-router'-ben találhatóak meg.

A createWebHistory() olyan URL-eket kezel, mintha szerver-oldali rendereléssel jönnének létre az oldalak. Ehhez konfigurálni kellhet a webszervert is! Ez lesz a javasolt mód!

text
http://example.com/cars/1

A createWebHashHistory() az URL fragment részébe (a # után) írja, hogy hol járunk. A szerver konfigurálása nélkül is működik, azonban rontja a keresőoptimalizálást.

text
http://example.com/#cars/1

A createMemoryHistory() ugyan használható böngészőben, de nem oda való, használatával nem lesznek böngésző előzmények.

A plugin regisztrálása ​

Ahogy a többi plugint, úgy a routert is a mount() előtt kiadott use() segítségével regisztrálhatjuk az applikációnkhoz.

js
import { createApp } from 'vue';
import { createRouter, createWebHistory } from 'vue-router';

const app = createApp(App);
app.use(router);
app.mount('#app');
  • Globálisan regisztrálja a RouterView és RouterLink komponenseket, így importálás nélkül használhatóakká válnak.
  • Engedélyezi a useRouter() és useRoute() composable-ket.
  • Betölti a kezdőoldalt.