Kurs Vue.js · Moduł 15: TypeScript i Nuxt
Typowanie Props
W tej lekcji5
W Laboratorium Kwantowym każdy moduł stacji musi precyzyjnie deklarować jakie dane przyjmuje. W Vue 3 z TypeScript używamy generycznej składni defineProps<{}>() do typowania propsow.
defineProps z generycznym typem
Zamiast runtime validation (obiekt z type, required), możemy użyć składni TypeScript:
<script setup lang="ts">
// Składnia generyczna - typy sprawdzane w czasie kompilacji
const props = defineProps<{
title: string
count: number
isActive: boolean
}>()
</script>To równoważne tradycyjnej składni:
<script setup>
// Stara składnia - runtime validation
const props = defineProps({
title: { type: String, required: true },
count: { type: Number, required: true },
isActive: { type: Boolean, required: true }
})
</script>Wyodrębnianie interfejsu
Gdy komponent ma wiele propsow, warto wyodrębnic interfejs:
<script setup lang="ts">
interface StationModuleProps {
name: string
status: 'online' | 'offline' | 'maintenance'
powerLevel: number
crew?: string[] // opcjonalny prop (?)
}
const props = defineProps<StationModuleProps>()
</script>Znak ? oznacza, że prop jest opcjonalny - nie musi być przekazany.
withDefaults
TypeScript generics nie pozwalają na wartości domyślne w defineProps. Do tego służy withDefaults:
<script setup lang="ts">
interface PanelProps {
title: string
variant?: 'primary' | 'danger' | 'success'
maxItems?: number
showHeader?: boolean
}
const props = withDefaults(defineProps<PanelProps>(), {
variant: 'primary',
maxItems: 10,
showHeader: true
})
</script>Teraz props.variant będzie 'primary' jeśli nie zostanie przekazany.
Union Types w Props
TypeScript pozwala definiować precyzyjne typy:
<script setup lang="ts">
type AlertLevel = 'info' | 'warning' | 'critical'
interface AlertProps {
level: AlertLevel
message: string
code?: number
}
const props = defineProps<AlertProps>()
</script>
<template>
<div :class="['alert', props.level]">
{{ props.message }}
</div>
</template>Złożone typy Props
Props mogą zawierać zagnieżdżone obiekty i tablice:
<script setup lang="ts">
interface Coordinate {
x: number
y: number
z: number
}
interface SensorData {
id: string
location: Coordinate
readings: number[]
metadata?: Record<string, unknown>
}
interface SensorPanelProps {
sensors: SensorData[]
selectedId: string | null
onSelect?: (id: string) => void
}
const props = defineProps<SensorPanelProps>()
</script>Record<string, unknown> to typ słownikowy - obiekt z kluczami string i wartościami dowolnego typu.
Kod do tej lekcji: App.vue
<script setup lang="ts">
import { ref } from 'vue'
import ModuleCard from './ModuleCard.vue'
interface StationModule {
id: string
name: string
status: 'online' | 'offline' | 'maintenance'
power: number
}
const modules = ref<StationModule[]>([
{ id: 'm1', name: 'Life Support', status: 'online', power: 95 },
{ id: 'm2', name: 'Navigation', status: 'online', power: 88 },
{ id: 'm3', name: 'Science Lab', status: 'maintenance', power: 40 },
{ id: 'm4', name: 'Communications', status: 'offline', power: 0 }
])
</script>
<template>
<div class="nova-lab">
<h1>NOVA LAB - Typowane Props</h1>
<ModuleCard
v-for="mod in modules"
:key="mod.id"
:module="mod"
:show-power="true"
/>
</div>
</template>
<style scoped>
.nova-lab {
background: #0a0e27;
color: #00ff88;
min-height: 100vh;
padding: 20px;
font-family: monospace;
}
h1 { color: #00ff88; margin-bottom: 15px; }
</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. Która składnia definiuje typowane propsy w Vue 3 z TypeScript?
2. Jak oznaczyć prop jako opcjonalny w interfejsie TypeScript?
To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Użyj withDefaults(defineProps<Props>(), { ... }) do ustawienia domyślnych wartości.
- Układanie w poziomie
Ułóż poprawną składnię withDefaults z defineProps:
- Edytor kodu
Użyj defineEmits<{}> do zdefiniowania zdarzenia 'command' z typowanymi argumentami.