Kurs Vue.js · Moduł 7: Props i zdarzenia
Walidacja Props
W tej lekcji5
Protokoły komunikacyjne NOVA LAB wymagają walidacji każdego sygnału - Vue oferuje rozbudowany system walidacji props, który chroni komponenty przed nieprawidłowymi danymi.
Sam typ to za mało. Liczba -5 jest poprawną liczbą, a napis 'extreme' poprawnym napisem, a jednak opóźnienie transmisji nie może być ujemne, a priorytetu 'extreme' nie przewiduje żadna procedura stacji. Bywa też gorzej: rodzic zapomina podać nazwę modułu i panel pokazuje pustkę. Walidacja props to kontrola sygnału na wejściu - sprawdza parametry, zanim moduł zacznie z nimi pracować.
Required Props
Domyślnie każdy prop jest opcjonalny. Aby wymusić jego obecność, zamiast samego typu podajesz obiekt z polem type oraz flagą required: true:
<script setup>
const props = defineProps({
name: {
type: String,
required: true
},
// Każdy wymagany prop deklarujesz osobno - nie ma formy skróconej
id: {
type: Number,
required: true
}
})
</script>Gdy rodzic pominie wymagany prop, Vue wypisze w konsoli ostrzeżenie o brakującym propsie, ale komponent i tak się wyrenderuje, a brakująca wartość będzie po prostu undefined. Walidacja nie blokuje renderowania - ona alarmuje, i to wyłącznie w trybie deweloperskim. W buildzie produkcyjnym Vue pomija te sprawdzenia, żeby nie spowalniać aplikacji.
Domyślne Wartości
Pole default określa wartość, której komponent użyje, gdy rodzic nie poda propsa albo przekaże jawnie undefined. Dla obiektów i tablic wartość domyślną zwraca funkcja fabryczna - dzięki temu każdy egzemplarz komponentu dostaje własną kopię zamiast jednego wspólnego obiektu:
<script setup>
const props = defineProps({
delay: {
type: Number,
default: 480 // 8 minut w sekundach
},
status: {
type: String,
default: 'standby'
},
// Dla obiektów i tablic - funkcja fabryczna
config: {
type: Object,
default: () => ({ mode: 'auto', retries: 3 })
}
})
</script>Zauważ, czego default nie robi: jeśli rodzic przekaże null, wartość domyślna nie zadziała, bo null to świadomie podana wartość, a nie jej brak. Osiem minut to tylko przykładowe opóźnienie łącza - w rzeczywistości sygnał między Ziemią a Marsem biegnie od około 3 do ponad 20 minut.
Wartości domyślne przez destrukturyzację
Od Vue 3.5 wartości domyślne możesz też zapisać przy destrukturyzacji wyniku defineProps. Kompilator pilnuje, żeby tak wyciągnięte zmienne pozostały reaktywne:
<script setup>
const { delay = 480, status = 'standby' } = defineProps({
delay: Number,
status: String
})
</script>Działa to tak samo jak pole default: gdy rodzic zmieni delay, zmienna delay w komponencie też się zmieni. W tej lekcji zostaniemy jednak przy polu default, bo w nim cały kontrakt propsa - typ, wymagalność i wartość domyślna - stoi w jednym miejscu.
Custom Validator
Funkcja validator pozwala dopisać własną logikę. Dostaje wartość propsa i zwraca true, gdy wartość jest poprawna, albo false, gdy nie jest:
<script setup>
const props = defineProps({
delay: {
type: Number,
default: 480,
validator: (value) => {
// Delay musi być między 0 a 1440 sekund
return value >= 0 && value <= 1440
}
},
priority: {
type: String,
default: 'normal',
validator: (value) => {
return ['low', 'normal', 'high', 'critical'].includes(value)
}
}
})
</script>Gdy walidacja nie przejdzie, Vue wyświetli ostrzeżenie w konsoli (w trybie development). Wartość i tak trafi do komponentu, więc walidator traktuj jak lampkę kontrolną, a nie szlaban. Od Vue 3.4 funkcja dostaje drugi argument - obiekt wszystkich propsów - więc może porównać ze sobą dwa parametry. Walidacja odbywa się jeszcze przed utworzeniem instancji komponentu, dlatego ani w validator, ani w default nie sięgniesz do jego stanu.
Wiele Typów
Czasem ten sam kanał przyjmuje sygnały w dwóch formatach, na przykład identyfikator modułu jako liczbę albo tekst. Wtedy zamiast jednego typu podajesz tablicę typów:
<script setup>
const props = defineProps({
id: [String, Number], // String lub Number
value: [String, Number, null] // dozwolony null
})
</script>Tablica oznacza "którykolwiek z wymienionych". Typem może być String, Number, Boolean, Array, Object, Date, Function, Symbol, Error albo własna klasa. null w tablicy ma znaczenie przede wszystkim przy propsach wymaganych: opcjonalny prop i tak przepuszcza null bez ostrzeżenia, natomiast wymagany prop z typem [String, null] przyjmie jawne null, a zaalarmuje dopiero przy braku wartości.
Moja rada: wymagaj tylko tego, bez czego moduł traci sens, resztę opatrz rozsądną wartością domyślną, a walidatory pisz dla zakresów i list dozwolonych wartości - tam, gdzie sam typ niczego nie gwarantuje. W edytorze poniżej wpisz opóźnienie większe niż 1440 i zajrzyj do konsoli. Umiesz już bezpiecznie odbierać sygnały z centrali, a w następnej lekcji odwrócimy kierunek: moduł wyśle wiadomość zwrotną przez custom events.
Zapamiętaj: walidacja props to kontrola sygnału na wejściu stacji - ostrzega załogę w laboratorium, ale nie zatrzymuje transmisji.
Kod do tej lekcji: App.vue
<script setup>
import { ref } from 'vue'
import SensorPanel from './SensorPanel.vue'
const sensorDelay = ref(480)
const sensorName = ref('Czujnik termiczny')
</script>
<template>
<div class="nova-lab">
<h1>Walidacja props</h1>
<label>
Opóźnienie (0-1440 s):
<input v-model.number="sensorDelay" type="number" />
</label>
<label>
Nazwa:
<input v-model="sensorName" />
</label>
<SensorPanel :name="sensorName" :delay="sensorDelay" />
<p class="hint">Sprawdź konsolę - walidator wyświetli ostrzeżenie dla delay > 1440</p>
</div>
</template>
<style scoped>
.nova-lab {
background: #0a0e27;
color: #00ff88;
min-height: 100vh;
padding: 20px;
font-family: monospace;
}
h1 { color: #00ff88; margin-bottom: 20px; }
label { display: block; margin: 10px 0; color: #00b4d8; }
input {
background: #0a0e27;
border: 2px solid #00ff88;
color: #00ff88;
padding: 8px;
margin-left: 10px;
}
.hint { color: #ff9900; margin-top: 15px; font-style: italic; }
</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 oznaczyć prop jako wymagany?
2. Jak ustawić domyślną wartość prop?
To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Dodaj walidację do props: delay musi być między 0 a 1440 sekund, message jest wymagany.
- Układanie w poziomie
Ułóż definicję prop z walidacją:
- Edytor kodu
Stwórz komponent AlarmSystem z Boolean prop 'active' (default: false) i String prop 'level' (default: 'low').