Appearance
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-routerKomponensek
- A
RouterViewkomponens célja, hogy megjelenítse az oldal tartalmát. - A
RouterLinkkomponens 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
pathaz útvonal, ahogy el szeretnénk érni az adott oldalt. - A
componentaz 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/1A 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/1A 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ésRouterLinkkomponenseket, így importálás nélkül használhatóakká válnak. - Engedélyezi a
useRouter()ésuseRoute()composable-ket. - Betölti a kezdőoldalt.