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

Typowanie Props

2 min czytania ·
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. 1. Która składnia definiuje typowane propsy w Vue 3 z TypeScript?

  2. 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.

  1. PytanieSkładnia defineProps generyczna
  2. PytanieOpcjonalny prop w TypeScript
  3. Zadanie z kodemPraktyka: defineProps z withDefaults
  4. Ułóż w kolejnościSkładnia withDefaults
  5. PytanieUnion type w Props
  6. Zadanie z kodemPraktyka: Typowane emity

Przydatne artykuły