Kurs Vue.js · Moduł 15: TypeScript i Nuxt
TypeScript z Vue.js
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-tsVite 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 automatycznieJawne typowanie jest przydatne, gdy typ nie może być wnioskowany:
const data = ref<string | null>(null) // może być string lub nullInterfejsy 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. Jaką główną korzyść daje użycie TypeScript z Vue.js?
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.