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

TypeScript z Vue.js

2 min czytania ·
W tej lekcji5

Witaj w Laboratorium Kwantowym NOVA LAB! Rok 2087 - systemy stacji kosmicznej wymagają najwyższej precyzji. Każdy błąd w typie danych może doprowadzić do katastrofy. Dlatego nasi inżynierowie używają TypeScript - statycznego systemu typów, który wykrywa błędy jeszcze zanim kod zostanie uruchomiony.

Dlaczego TypeScript z Vue?

TypeScript to nadzbiór JavaScriptu, który dodaje typy statyczne. W połączeniu z Vue 3 daje nam:

  • Autouzupełnianie w edytorze kodu (IntelliSense)
  • Wykrywanie błędów przed uruchomieniem aplikacji
  • Lepsza dokumentacja - typy opisują kształt danych
  • Refaktoryzacja - edytor rozumie strukturę kodu

Konfiguracja projektu Vue z TypeScript

Tworzenie projektu Vue z TypeScript jest proste dzięki Vite:

npm create vite@latest nova-lab -- --template vue-ts

Vite automatycznie konfiguruje TypeScript i tworzy plik tsconfig.json:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "strict": true,
    "jsx": "preserve",
    "paths": {
      "@/*": ["./src/*"]
    }
  },
  "include": ["src/**/*.ts", "src/**/*.vue"]
}

Atrybut lang="ts"

W komponentach Vue SFC (Single File Components) dodajemy lang="ts" do bloku <script setup>:

<script setup lang="ts">
import { ref } from 'vue'

const stationName = ref<string>('NOVA LAB')
const crewCount = ref<number>(42)
const isOnline = ref<boolean>(true)
</script>

Bez lang="ts" Vue traktuje kod jako zwykły JavaScript. Z lang="ts" kompilator TypeScript sprawdza typy i wychwytuje błędy.

Podstawowe typy w Vue

<script setup lang="ts">
import { ref } from 'vue'

// Proste typy
const name: string = 'Mars Station'
const year: number = 2087
const active: boolean = true

// Tablice
const modules: string[] = ['Lab', 'Hangar', 'Bridge']
const temperatures: number[] = [-63, -58, -71]

// Ref z typem generycznym
const status = ref<string>('operational')
const energy = ref<number>(98.5)
</script>

TypeScript automatycznie wnioskuje (infer) typy, więc nie zawsze trzeba je podawać jawnie:

const count = ref(0)       // ref<number> - wnioskowane automatycznie
const label = ref('test')  // ref<string> - wnioskowane automatycznie

Jawne typowanie jest przydatne, gdy typ nie może być wnioskowany:

const data = ref<string | null>(null)  // może być string lub null

Interfejsy TypeScript

Interfejsy definiują kształt obiektów:

interface CrewMember {
  id: number
  name: string
  role: string
  active: boolean
}

const engineer: CrewMember = {
  id: 1,
  name: 'Dr. Nova',
  role: 'Chief Engineer',
  active: true
}
Kod do tej lekcji: App.vue
<script setup lang="ts">
import { ref } from 'vue'

// Podstawowe typy
const stationName = ref<string>('NOVA LAB')
const crewCount = ref<number>(42)
const isOnline = ref<boolean>(true)

// Interfejs
interface CrewMember {
  id: number
  name: string
  role: string
  active: boolean
}

// Tablica z typem
const crew = ref<CrewMember[]>([
  { id: 1, name: 'Dr. Nova', role: 'Commander', active: true },
  { id: 2, name: 'Atlas', role: 'Navigator', active: true },
  { id: 3, name: 'Echo', role: 'Engineer', active: false }
])

// Typ unii
const status = ref<'online' | 'offline' | 'maintenance'>('online')

function toggleStatus() {
  const states: Array<'online' | 'offline' | 'maintenance'> = ['online', 'offline', 'maintenance']
  const idx = states.indexOf(status.value)
  status.value = states[(idx + 1) % states.length]
}
</script>

<template>
  <div class="nova-lab">
    <h1>{{ stationName }}</h1>
    <p>Crew: {{ crewCount }} | Status: <span :class="status">{{ status }}</span></p>
    <button @click="toggleStatus" class="btn">Zmien status</button>

    <h2>Zaloga</h2>
    <div v-for="member in crew" :key="member.id" class="card">
      <strong>{{ member.name }}</strong> - {{ member.role }}
      <span :class="member.active ? 'active' : 'inactive'">
        {{ member.active ? 'Aktywny' : 'Nieaktywny' }}
      </span>
    </div>
  </div>
</template>

<style scoped>
.nova-lab {
  background: #0a0e27;
  color: #00ff88;
  min-height: 100vh;
  padding: 20px;
  font-family: monospace;
}
h1 { color: #00ff88; margin-bottom: 5px; }
h2 { color: #00b4d8; margin-top: 20px; }
.btn {
  background: #00b4d8;
  color: white;
  border: none;
  padding: 8px 16px;
  border-radius: 8px;
  cursor: pointer;
  margin: 10px 0;
}
.card {
  background: rgba(0, 180, 216, 0.1);
  border: 1px solid #00b4d8;
  padding: 12px 16px;
  margin: 6px 0;
  border-radius: 8px;
  display: flex;
  justify-content: space-between;
  align-items: center;
}
.online { color: #00ff88; }
.offline { color: #e74c3c; }
.maintenance { color: #f39c12; }
.active { color: #00ff88; font-size: 12px; }
.inactive { color: #e74c3c; font-size: 12px; }
</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ą główną korzyść daje użycie TypeScript z Vue.js?

  2. 2. Jaki atrybut dodajemy do bloku <script setup>, aby włączyć TypeScript?

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

Zadania praktyczne w grze

  • Edytor kodu

    Typuj ref jako string, number, boolean i stwórz interfejs dla obiektu załogi.

  • Klikanie w kolejności

    Ułóż kroki konfiguracji projektu Vue z TypeScript:

  • Edytor kodu

    Zdefiniuj interfejs ModuleProps i użyj defineProps z generycznym typem.

  1. PytanieCel TypeScript w Vue
  2. PytanieAtrybut lang w script
  3. Zadanie z kodemPraktyka: Podstawowe typy w Vue
  4. PytanieWnioskowanie typów ref
  5. Kliknij w kolejnościKonfiguracja Vue + TypeScript
  6. Zadanie z kodemPraktyka: Interfejs TypeScript

Przydatne artykuły