Kurs Vue.js · Moduł 10: Vue Router

Dynamiczne Trasy

2 min czytania ·
W tej lekcji6

Każdy modul bazy NOVA LAB ma swój unikalny identyfikator. Podobnie możemy tworzyć dynamiczne ścieżki w aplikacji - trasy, które przyjmują parametry w URL.

Route Params

Parametr dynamiczny definiujemy przez dwukropek : w sciezce:

const routes = [
  {
    path: '/system/:id',
    name: 'system-detail',
    component: SystemDetail
  },
  {
    path: '/crew/:name',
    name: 'crew-detail',
    component: CrewDetail
  },
  // Wiele parametrow
  {
    path: '/modułe/:moduleId/system/:systemId',
    name: 'modułe-system',
    component: ModuleSystem
  }
]

Odczyt Parametrow - useRoute()

Composable useRoute() daje dostęp do informacji o aktualnym route, włącznie z parametrami:

<script setup>
import { useRoute } from 'vue-router'

const route = useRoute()

// Dostęp do parametrow
console.log(route.params.id) // np. '42'
console.log(route.path)      // np. '/system/42'
console.log(route.name)      // np. 'system-detail'
</script>

<template>
  <div>
    <h1>System #{{ route.params.id }}</h1>
  </div>
</template>

Nawigacja z Parametrami

<template>
  <div v-for="system in systems" :key="system.id">
    <!-- String URL -->
    <RouterLink :to="`/system/${system.id}`">
      {{ system.name }}
    </RouterLink>

    <!-- Object notation (zalecana) -->
    <RouterLink :to="{ name: 'system-detail', params: { id: system.id } }">
      {{ system.name }}
    </RouterLink>
  </div>
</template>

Reaktywnosc na Zmiany Params

Gdy zmieniasz parametr w ramach tego samego route, komponent NIE jest odmontowywany. Używaj watch do reagowania na zmiany:

<script setup>
import { ref, watch } from 'vue'
import { useRoute } from 'vue-router'

const route = useRoute()
const systemData = ref(null)

watch(
  () => route.params.id,
  (newId) => {
    // Załaduj dane nowego systemu
    loadSystem(newId)
  },
  { immediate: true }
)
</script>

Query Parameters

Parametry zapytania (query) to czesc URL po znaku ?:

<script setup>
import { useRoute, useRouter } from 'vue-router'

const route = useRoute()
const router = useRouter()

// URL: /systems?modułe=habitat&sort=priority
console.log(route.query.modułe) // 'habitat'
console.log(route.query.sort)   // 'priority'

// Nawigacja z query
function filterByModule(modułe) {
  router.push({
    name: 'systems',
    query: { modułe, sort: 'priority' }
  })
}
</script>

Opcjonalne i Walidowane Parametry

const routes = [
  // Opcjonalny parametr z ?
  { path: '/system/:id?' },

  // Regex - tylko liczby
  { path: '/system/:id(\\d+)' },

  // Powtarzalny parametr
  { path: '/modules/:ids+' }
]
Kod do tej lekcji: App.vue
<script setup>
import { ref } from 'vue'

// Symulacja nested routes
const currentPath = ref('/mission-control')
const sidebarItems = [
  { path: '/mission-control', label: 'Przeglad', name: 'overview' },
  { path: '/mission-control/systems', label: 'Systemy', name: 'systems' },
  { path: '/mission-control/crew', label: 'Zaloga', name: 'crew' }
]

function navigate(path) {
  currentPath.value = path
}

const isActive = (path) => currentPath.value === path
</script>

<template>
  <div class="nova-lab">
    <h1>NOVA LAB - Nested Routes</h1>

    <div class="layout">
      <aside class="sidebar">
        <h3>Centrum Kontroli Misji</h3>
        <nav>
          <a
            v-for="item in sidebarItems"
            :key="item.path"
            @click.prevent="navigate(item.path)"
            :class="{ active: isActive(item.path) }"
            href="#"
          >
            {{ item.label }}
          </a>
        </nav>

        <div class="config-info">
          <pre>
children: [
  { path: '', component: Overview },
  { path: 'systems', component: Systems },
  { path: 'crew', component: Crew }
]</pre>
        </div>
      </aside>

      <main class="content">
        <div v-if="currentPath === '/mission-control'" class="child-page">
          <h2>Przeglad Misji</h2>
          <p>Domyslny widok (path: '')</p>
          <div class="stats">
            <div class="stat">
              <span class="label">Status misji</span>
              <span class="value ok">AKTYWNA</span>
            </div>
            <div class="stat">
              <span class="label">Dzien misji</span>
              <span class="value">247</span>
            </div>
            <div class="stat">
              <span class="label">Zaloga</span>
              <span class="value">12 osob</span>
            </div>
          </div>
        </div>

        <div v-else-if="currentPath === '/mission-control/systems'" class="child-page">
          <h2>Systemy Bazy</h2>
          <p>Child route: path: 'systems'</p>
          <ul class="systems-list">
            <li>Oxygen Generator - ONLINE</li>
            <li>Water Recycler - ONLINE</li>
            <li>Power Grid - WARNING</li>
            <li>Communications - ONLINE</li>
          </ul>
        </div>

        <div v-else-if="currentPath === '/mission-control/crew'" class="child-page">
          <h2>Zaloga</h2>
          <p>Child route: path: 'crew'</p>
          <ul class="crew-list">
            <li>Dr. Nova - Commander</li>
            <li>Eng. Kowalski - Systems</li>
            <li>Dr. Chen - Science</li>
          </ul>
        </div>
      </main>
    </div>
  </div>
</template>

<style scoped>
.nova-lab {
  background: #0a0e27;
  color: #00ff88;
  min-height: 100vh;
  padding: 20px;
  font-family: monospace;
}
h1 { color: #00ffff; margin-bottom: 15px; }
h2 { color: #00b4d8; }
h3 { color: #00ffff; margin-bottom: 10px; }
p { color: #c0c0c0; }
.layout {
  display: grid;
  grid-template-columns: 220px 1fr;
  gap: 15px;
}
.sidebar {
  background: rgba(0, 180, 216, 0.05);
  border: 1px solid #1a1e37;
  padding: 15px;
}
.sidebar nav { display: flex; flex-direction: column; gap: 5px; }
.sidebar a {
  color: #00ff88;
  text-decoration: none;
  padding: 8px;
  border-left: 2px solid transparent;
  cursor: pointer;
}
.sidebar a.active {
  border-left-color: #00ffff;
  color: #00ffff;
  background: rgba(0, 255, 255, 0.05);
}
.config-info { margin-top: 15px; }
.config-info pre {
  font-size: 10px;
  color: #888;
  background: #1a1e37;
  padding: 8px;
}
.content {
  background: rgba(0, 180, 216, 0.05);
  border: 1px solid #1a1e37;
  padding: 15px;
}
.child-page { min-height: 200px; }
.stats { display: flex; gap: 15px; margin-top: 15px; flex-wrap: wrap; }
.stat {
  background: #1a1e37;
  padding: 10px 15px;
  border: 1px solid #00b4d8;
}
.stat .label { display: block; color: #888; font-size: 11px; }
.stat .value { display: block; color: #00ff88; font-size: 18px; margin-top: 4px; }
.stat .value.ok { color: #00ff88; }
ul { color: #c0c0c0; margin-top: 10px; }
li { margin: 5px 0; }
</style>

Hasła z dokumentacji w tej lekcji

Widzisz błąd w tej lekcji?

Sprawdź się

Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.

  1. 1. Jak zdefiniować dynamiczny parametr w path Vue Router?

  2. 2. Jak uzyskać dostęp do parametrów aktualnego route w Composition API?

To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Edytor kodu

    Stwórz route /system/:id i komponent odczytujący params.id przez useRoute().

  • Układanie w pionie

    Uporządkuj kroki obsługi dynamicznego route:

  • Klikanie w kolejności

    Ułóż programatyczną nawigację z parametrami:

  • Edytor kodu

    Nawiguj z query params i odczytaj je w komponencie przez useRoute().query.

  • Układanie w poziomie

    Ułóż składnię RouterLink z dynamicznym parametrem:

  1. PytanieDefinicja dynamicznego parametru
  2. PytanieComposable useRoute
  3. Zadanie z kodemPraktyka: Route z parametrem dynamicznym
  4. Ułóż w kolejnościPrzepływ dynamicznych tras
  5. PytanieQuery parameters
  6. Kliknij w kolejnościNawigacja z parametrami
  7. Zadanie z kodemPraktyka: Query parameters i filtrowanie
  8. Ułóż w kolejnościSkładnia RouterLink z parametrem

Przydatne artykuły