Kurs Vue.js · Moduł 15: TypeScript i Nuxt

Nuxt 3 - podstawy

3 min czytania ·
W tej lekcji8

Nuxt 3 to meta-framework zbudowany na Vue 3, który daje SSR, SSG, routing plikowy i wiele więcej - od razu, bez konfiguracji. Można go porównać do systemu autopilota stacji NOVA LAB - wszystko jest skonfigurowane i gotowe do działania.

Tworzenie projektu Nuxt 3

npx nuxi@latest init nova-lab-app
cd nova-lab-app
npm install
npm run dev

Routing plikowy (File-Based Routing)

W Nuxt 3 nie konfigurujesz routera ręcznie. Struktura plików w folderze pages/ automatycznie tworzy trasy:

pages/
├── index.vue          →  /
├── about.vue          →  /about
├── crew/
│   ├── index.vue      →  /crew
│   └── [id].vue       →  /crew/123
└── modules/
    └── [...slug].vue  →  /modules/any/nested/path

Plik index.vue to strona główna danego katalogu. Pliki z nawiasami kwadratowymi [id].vue to parametry dynamiczne.

Layouts

Layouty definiują wspólną strukturę stron (nawigacja, stopka):

<!-- layouts/default.vue -->
<template>
  <div class="station">
    <nav class="nav">
      <NuxtLink to="/">Home</NuxtLink>
      <NuxtLink to="/about">About</NuxtLink>
      <NuxtLink to="/crew">Crew</NuxtLink>
    </nav>

    <main>
      <slot />
    </main>

    <footer>NOVA LAB &copy; 2087</footer>
  </div>
</template>

Strony automatycznie używają layoutu default. Można zmienić layout na konkretnej stronie:

<!-- pages/dashboard.vue -->
<script setup lang="ts">
definePageMeta({
  layout: 'admin'
})
</script>

useFetch - pobieranie danych

useFetch to composable Nuxta do pobierania danych. Działa zarówno na serwerze (SSR) jak i na kliencie:

<script setup lang="ts">
interface CrewMember {
  id: number
  name: string
  role: string
}

// useFetch działa na serwerze i kliencie
const { data: crew, pending, error } = await useFetch<CrewMember[]>(
  '/api/crew'
)
</script>

<template>
  <div v-if="pending">Ładowanie...</div>
  <div v-else-if="error">Błąd: {{ error.message }}</div>
  <ul v-else>
    <li v-for="member in crew" :key="member.id">
      {{ member.name }} - {{ member.role }}
    </li>
  </ul>
</template>

useFetch automatycznie:

  • Wykonuje request na serwerze podczas SSR
  • Serializuje dane i przesyła je do klienta (unika podwójnego fetchowania)
  • Udostępnia stany pending, error, data, refresh

useAsyncData - bardziej elastyczne

useAsyncData daje pełną kontrolę nad logiką pobierania danych:

<script setup lang="ts">
const { data: stats } = await useAsyncData('station-stats', () => {
  return $fetch('/api/stats')
})

// Z transformacją danych
const { data: modules } = await useAsyncData(
  'modules',
  () => $fetch('/api/modules'),
  {
    transform: (data) => data.filter(m => m.active),
    watch: [selectedSector]  // automatyczne odświeżanie
  }
)
</script>

Auto-imports

Nuxt 3 automatycznie importuje:

  • Composables Vue (ref, computed, watch...)
  • Composables Nuxt (useFetch, useRoute, useState...)
  • Komponenty z components/
  • Utility z utils/ i composables/

Nie trzeba pisać import { ref } from 'vue' - Nuxt robi to za nas!

<script setup lang="ts">
// Bez importów! Nuxt auto-importuje ref, computed, useFetch
const count = ref(0)
const doubled = computed(() => count.value * 2)

const { data } = await useFetch('/api/data')
</script>

Struktura projektu Nuxt 3

nova-lab-app/
├── pages/          # Routing plikowy
├── components/     # Auto-importowane komponenty
├── composables/    # Auto-importowane composables
├── layouts/        # Layouty stron
├── server/         # API endpoints (Nitro)
│   └── api/        # /api/* routes
├── public/         # Pliki statyczne
├── app.vue         # Root komponent
└── nuxt.config.ts  # Konfiguracja Nuxt

Server API (Nitro)

Nuxt 3 używa Nitro do obsługi endpointów API:

// server/api/crew.ts
export default defineEventHandler((event) => {
  return [
    { id: 1, name: 'Dr. Nova', role: 'Commander' },
    { id: 2, name: 'Atlas', role: 'Navigator' },
    { id: 3, name: 'Echo', role: 'Engineer' }
  ]
})
Kod do tej lekcji: App.vue
<script setup lang="ts">
import { ref } from 'vue'

// Symulacja struktury Nuxt 3
// (Sandpack nie obsluguje Nuxt, wiec symulujemy koncepcje)

type Page = 'home' | 'crew' | 'modules' | 'crew-detail'

const currentPage = ref<Page>('home')
const selectedCrewId = ref<number | null>(null)

// Symulacja useFetch
interface CrewMember {
  id: number
  name: string
  role: string
}

interface StationModule {
  id: string
  name: string
  status: string
}

// Dane "z API"
const crewData: CrewMember[] = [
  { id: 1, name: 'Dr. Nova', role: 'Commander' },
  { id: 2, name: 'Atlas', role: 'Navigator' },
  { id: 3, name: 'Echo', role: 'Engineer' },
  { id: 4, name: 'Vega', role: 'Scientist' }
]

const modulesData: StationModule[] = [
  { id: 'm1', name: 'Life Support', status: 'online' },
  { id: 'm2', name: 'Navigation', status: 'online' },
  { id: 'm3', name: 'Science Lab', status: 'maintenance' }
]

// Symulacja loading state
const pending = ref(false)

function navigate(page: Page, id?: number) {
  pending.value = true
  setTimeout(() => {
    currentPage.value = page
    if (id) selectedCrewId.value = id
    pending.value = false
  }, 300)
}

function getCrewMember(id: number) {
  return crewData.find(c => c.id === id)
}
</script>

<template>
  <div class="nova-lab">
    <nav class="nav">
      <button @click="navigate('home')" :class="{ active: currentPage === 'home' }">Home</button>
      <button @click="navigate('crew')" :class="{ active: currentPage === 'crew' }">Crew</button>
      <button @click="navigate('modules')" :class="{ active: currentPage === 'modules' }">Modules</button>
    </nav>

    <div v-if="pending" class="loading">Ladowanie...</div>

    <div v-else>
      <!-- pages/index.vue -->
      <div v-if="currentPage === 'home'" class="page">
        <h1>NOVA LAB - Nuxt 3 Demo</h1>
        <p>Symulacja file-based routing i useFetch</p>
        <div class="info-box">
          <p><strong>pages/</strong> index.vue -> /</p>
          <p><strong>pages/</strong> crew/index.vue -> /crew</p>
          <p><strong>pages/</strong> crew/[id].vue -> /crew/:id</p>
          <p><strong>pages/</strong> modules.vue -> /modules</p>
        </div>
      </div>

      <!-- pages/crew/index.vue -->
      <div v-if="currentPage === 'crew'" class="page">
        <h1>Zaloga</h1>
        <p class="note">Dane pobrane przez useFetch('/api/crew')</p>
        <div
          v-for="member in crewData"
          :key="member.id"
          class="card clickable"
          @click="navigate('crew-detail', member.id)"
        >
          <strong>{{ member.name }}</strong>
          <span>{{ member.role }}</span>
        </div>
      </div>

      <!-- pages/crew/[id].vue -->
      <div v-if="currentPage === 'crew-detail' && selectedCrewId" class="page">
        <button @click="navigate('crew')" class="back-btn">Wstecz</button>
        <h1>{{ getCrewMember(selectedCrewId)?.name }}</h1>
        <p>Rola: {{ getCrewMember(selectedCrewId)?.role }}</p>
        <p class="note">Route: /crew/{{ selectedCrewId }}</p>
      </div>

      <!-- pages/modules.vue -->
      <div v-if="currentPage === 'modules'" class="page">
        <h1>Moduly stacji</h1>
        <p class="note">useAsyncData('modules', () => $fetch('/api/modules'))</p>
        <div v-for="mod in modulesData" :key="mod.id" class="card">
          <strong>{{ mod.name }}</strong>
          <span :class="mod.status">{{ mod.status }}</span>
        </div>
      </div>
    </div>
  </div>
</template>

<style scoped>
.nova-lab {
  background: #0a0e27;
  color: #00ff88;
  min-height: 100vh;
  padding: 20px;
  font-family: monospace;
}
h1 { color: #00ff88; margin-bottom: 10px; }
.nav {
  display: flex;
  gap: 8px;
  margin-bottom: 15px;
  border-bottom: 1px solid rgba(0,180,216,0.3);
  padding-bottom: 12px;
}
.nav button {
  background: rgba(0,180,216,0.1);
  color: #00b4d8;
  border: 1px solid #00b4d8;
  padding: 8px 18px;
  border-radius: 6px;
  cursor: pointer;
  font-family: monospace;
}
.nav button.active { background: #00b4d8; color: white; }
.page { padding: 10px 0; }
.card {
  display: flex;
  justify-content: space-between;
  background: rgba(0,180,216,0.08);
  border: 1px solid #00b4d8;
  padding: 12px 16px;
  margin: 6px 0;
  border-radius: 8px;
}
.card.clickable { cursor: pointer; }
.card.clickable:hover { background: rgba(0,180,216,0.15); }
.note { color: #666; font-size: 12px; margin-bottom: 10px; }
.info-box {
  background: rgba(0,255,136,0.05);
  border: 1px solid rgba(0,255,136,0.2);
  padding: 14px;
  border-radius: 8px;
  margin-top: 10px;
  font-size: 13px;
}
.info-box p { margin: 4px 0; color: #ccc; }
.loading { color: #f39c12; text-align: center; padding: 40px; }
.back-btn {
  background: none;
  color: #00b4d8;
  border: 1px solid #00b4d8;
  padding: 6px 14px;
  border-radius: 6px;
  cursor: pointer;
  margin-bottom: 10px;
  font-family: monospace;
}
.online { color: #00ff88; }
.maintenance { color: #f39c12; }
.offline { color: #e74c3c; }
</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 Nuxt 3 tworzy routing aplikacji?

  2. 2. W którym folderze Nuxt 3 umieszcza się pliki, które automatycznie stają się trasami (routes) aplikacji?

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

Zadania praktyczne w grze

  • Edytor kodu

    Użyj onMounted do dostępu do window - obiekt niedostępny na serwerze.

  • Układanie w poziomie

    Ułóż ścieżkę pliku dla dynamicznego route /crew/123 w Nuxt:

  • Układanie w pionie

    Uporządkuj kroki Incremental Static Regeneration:

  • Klikanie w kolejności

    Ułóż stany useFetch w kolejności typowego przepływu:

  • Układanie w poziomie

    Ułóż strukturę layoutu Nuxt z komponentem NuxtLink:

  • Układanie w pionie

    Uporządkuj strategie od najlepszego SEO do najsłabszego:

  • Klikanie w kolejności

    Ułóż polecenia do stworzenia i uruchomienia projektu Nuxt 3:

  • Układanie w pionie

    Uporządkuj koncepcje TypeScript w Vue od najprostszych do najbardziej zaawansowanych:

  • Układanie w pionie

    Uporządkuj cykl życia danych pobranych przez useFetch w Nuxt SSR:

  • Układanie w poziomie

    Ułóż nazwę głównego pliku konfiguracyjnego Nuxt 3:

  • Edytor kodu

    Zdefiniuj interfejsy StationModule i Alert, typuj props, emits i computed.

  1. PytanieFile-based routing w Nuxt
  2. PytanieStruktura projektu Nuxt 3
  3. PytanieuseFetch w Nuxt 3
  4. Zadanie z kodemPraktyka: SSR-safe kod
  5. Ułóż w kolejnościDynamiczny route w Nuxt
  6. PytanieAuto-imports w Nuxt 3
  7. Ułóż w kolejnościISR - przepływ danych
  8. Kliknij w kolejnościStany useFetch
  9. PytanieKiedy używać SSR
  10. Ułóż w kolejnościLayouts w Nuxt 3
  11. Ułóż w kolejnościSSR vs SPA - różnice w SEO
  12. Kliknij w kolejnościTworzenie projektu Nuxt 3
  13. Ułóż w kolejnościTypowanie Vue - od podstaw do zaawansowanych
  14. Ułóż w kolejnościCykl życia useFetch w Nuxt
  15. Ułóż w kolejnościPlik konfiguracji Nuxt
  16. PytanieWindow w SSR
  17. Zadanie z kodemPraktyka: Typowany panel stacji

Przydatne artykuły