Kurs Vue.js · Moduł 7: Props i zdarzenia

Walidacja Props

4 min czytania ·
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. 1. Jak oznaczyć prop jako wymagany?

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

  1. PytanieProp required
  2. PytanieDomyślna wartość prop
  3. Zadanie z kodemPraktyka: Props z walidacją
  4. Ułóż w kolejnościDefinicja walidowanego prop
  5. PytanieCustom validator
  6. Zadanie z kodemPraktyka: Boolean i default props

Przydatne artykuły