Kurs Vue.js · Moduł 5: Zdarzenia i formularze
Formularze w Praktyce - Rejestracja Modułu
Dział inżynierii NOVA LAB dostał zlecenie: jeden formularz, w którym zarejestruje się każdy nowy moduł stacji, od śluzy po laboratorium. Moduł ma nazwę, typ, rok i status, parametry techniczne, kategorie, opis i opcje serwisowe. Kilkanaście pól wrzuconych jedno pod drugim to ściana, której nikt nie przeczyta. Zbudujemy więc formularz podzielony na grupy, z polami, które pojawiają się tylko wtedy, gdy mają sens, z resetem i z podglądem danych.
Grupy pól: fieldset i legend
Element <fieldset> grupuje powiązane pola, a <legend> jest podpisem tej grupy. Czytniki ekranu odczytują go przed polami, więc operator korzystający z czytnika wie, w której sekcji jest. Etykieta <label> z atrybutem for wskazuje id pola, dzięki czemu kliknięcie w napis ustawia kursor w polu. Pierwsza grupa zaczyna się od nazwy i typu modułu.
<template>
<form @submit.prevent="submitModule" class="module-form" style="background: #0a0e27; color: #00ff88;">
<h2>Rejestracja modułu misji</h2>
<!-- Podstawowe informacje -->
<fieldset style="border-color: #00b4d8;">
<legend>Informacje podstawowe</legend>
<div class="form-group">
<label for="name">Nazwa modułu *</label>
<input
id="name"
v-model.trim="module.name"
required
minlength="3"
style="background: #1a1e37; color: #00ff88;"
/>
</div>
<div class="form-group">
<label for="type">Typ *</label>
<input id="type" v-model.trim="module.type" required style="background: #1a1e37; color: #00ff88;" />
</div>Nazwa ma atrybuty required i minlength="3", czyli wbudowaną walidację HTML. Przeglądarka sprawdza takie atrybuty, zanim w ogóle wyśle zdarzenie submit, i przy błędzie pokazuje własny komunikat - @submit.prevent niczego tu nie wyłącza. v-model.trim usuwa przy tym zbędne spacje. Dalej rząd z rokiem i statusem.
<div class="form-row">
<div class="form-group">
<label for="year">Rok wdrożenia</label>
<input
id="year"
v-model.number="module.year"
type="number"
min="2020"
max="2100"
style="background: #1a1e37; color: #00ff88;"
/>
</div>
<div class="form-group">
<label for="status">Status</label>
<select id="status" v-model="module.status" style="background: #1a1e37; color: #00ff88;">
<option value="">Wybierz...</option>
<option value="ACTIVE">Aktywny</option>
<option value="STANDBY">Gotowość</option>
<option value="MAINTENANCE">Konserwacja</option>
<option value="OFFLINE">Offline</option>
</select>
</div>
</div>
</fieldset>Rok ma min i max dla przeglądarki oraz .number dla Vue. Computed isValid roku nie sprawdza, więc wpis 1999 zatrzyma dopiero przeglądarka po kliknięciu przycisku wysyłania. Lista statusów zaczyna się od pustej opcji zachęcającej do wyboru. Druga grupa pokazuje, że v-model działa też na zagnieżdżonych ścieżkach, takich jak module.params.maxPower.
<!-- Parametry -->
<fieldset style="border-color: #00b4d8;">
<legend>Parametry</legend>
<div class="form-row">
<div class="form-group">
<label>Max moc (MW)</label>
<input v-model.number="module.params.maxPower" type="number" style="background: #1a1e37; color: #00ff88;" />
</div>
<div class="form-group">
<label>Temperatura (K)</label>
<input v-model.number="module.params.temperature" type="number" style="background: #1a1e37; color: #00ff88;" />
</div>
<div class="form-group" v-if="needsPressure">
<label>Ciśnienie (kPa)</label>
<input v-model.number="module.params.pressure" type="number" style="background: #1a1e37; color: #00ff88;" />
</div>
</div>
</fieldset>Pole ciśnienia ma v-if="needsPressure", więc istnieje tylko wtedy, gdy computed zwraca true. Przy wartości false Vue usuwa je z DOM, a nie tylko ukrywa. Usunięcie pola nie czyści jednak danych: wpisane wcześniej ciśnienie zostaje w module.params.pressure. Kategorie w trzeciej grupie generuje v-for z tablicy.
<!-- Kategorie -->
<fieldset>
<legend>Kategorie</legend>
<div class="checkbox-group">
<label v-for="cat in availableCategories" :key="cat.value">
<input
type="checkbox"
v-model="module.categories"
:value="cat.value"
/>
{{ cat.label }}
</label>
</div>
</fieldset>Każdy checkbox bierze swoją wartość z :value="cat.value", a wszystkie zapisują do jednej tablicy module.categories, dokładnie jak grupa checkboxów z lekcji o v-model. Czwarta grupa to opis w obszarze tekstowym.
<!-- Opis -->
<fieldset>
<legend>Opis</legend>
<textarea
v-model="module.description"
rows="4"
placeholder="Opisz moduł misji..."
></textarea>
<p class="char-count">
{{ module.description.length }} / 500 znaków
</p>
</fieldset>Atrybut rows="4" ustala widoczną wysokość pola. Licznik pod spodem tylko informuje o długości opisu i niczego nie ogranicza: twardy limit dałby dopiero atrybut maxlength="500". Piąta grupa zawiera opcje i pole warunkowe.
<!-- Opcje -->
<fieldset>
<legend>Opcje</legend>
<label class="checkbox-label">
<input type="checkbox" v-model="module.isActive" />
Moduł aktywny
</label>
<label class="checkbox-label">
<input type="checkbox" v-model="module.needsMaintenance" />
Wymaga konserwacji
</label>
<div v-if="module.needsMaintenance" class="form-group">
<label>Budżet konserwacji (USD)</label>
<input v-model.number="module.maintenanceCost" type="number" min="0" />
</div>
</fieldset>To wzorzec pola warunkowego: checkbox z v-model steruje zmienną, a v-if na tej zmiennej pokazuje dodatkowe pole z budżetem konserwacji. isActive startuje od true, więc pole jest zaznaczone od początku, bo v-model bierze stan z JavaScriptu. Na końcu szablonu są przyciski i podgląd danych.
<!-- Przyciski -->
<div class="form-actions">
<button type="button" @click="resetForm">Wyczyść</button>
<button type="submit" :disabled="!isValid">Zarejestruj moduł</button>
</div>
<!-- Podgląd -->
<details>
<summary>Podgląd danych</summary>
<pre>{{ JSON.stringify(module, null, 2) }}</pre>
</details>
</form>
</template>type="button" przy przycisku czyszczenia jest kluczowy, bo przycisk w formularzu domyślnie ma typ submit i bez tego atrybutu czyszczenie wysłałoby formularz. <details> z <summary> tworzy rozwijany podgląd, a JSON.stringify(module, null, 2) formatuje dane z wcięciem o dwie spacje. Przejdźmy do skryptu.
<script setup>
import { reactive, computed } from 'vue'
const initialState = {
name: '',
type: '',
year: null,
status: '',
params: { maxPower: null, temperature: null, pressure: null },
categories: [],
description: '',
isActive: true,
needsMaintenance: false,
maintenanceCost: null
}
const module = reactive({
...initialState,
params: { ...initialState.params },
categories: []
})initialState opisuje pusty formularz, a reactive tworzy z niego stan. Uwaga na pułapkę: rozwinięcie ...initialState kopiuje tylko pierwszy poziom obiektu. Gdyby params nie dostało osobnej kopii, wpisanie mocy zmieniłoby także initialState.params, a reset przywróciłby wpisane liczby zamiast pustych pól. Dlatego params i categories dostają własne kopie. Dalej lista kategorii i dwa computed.
const availableCategories = [
{ value: 'lifesupport', label: 'Podtrzymywanie życia' },
{ value: 'energy', label: 'Energetyczny' },
{ value: 'research', label: 'Badawczy' },
{ value: 'communication', label: 'Komunikacyjny' },
{ value: 'navigation', label: 'Nawigacyjny' }
]
const needsPressure = computed(() => {
return ['lifesupport', 'research'].some(c => module.categories.includes(c))
})
const isValid = computed(() => {
return module.name.length >= 3 && module.type
})availableCategories to zwykła tablica, bo nigdy się nie zmienia i nie potrzebuje reaktywności. needsPressure używa metody some, która zwraca true, gdy choć jeden element spełnia warunek. isValid pełni rolę isFormValid z poprzedniej lekcji: wymaga nazwy z co najmniej trzema znakami i niepustego typu. Zostały reset i wysyłka.
function resetForm() {
Object.assign(module, {
...initialState,
params: { ...initialState.params },
categories: []
})
}
function submitModule() {
if (isValid.value) {
console.log('Rejestruję:', JSON.parse(JSON.stringify(module)))
alert('Moduł został zarejestrowany!')
}
}
</script>Object.assign wpisuje wartości początkowe do istniejącego obiektu module, więc szablon pozostaje podpięty do tego samego stanu. Podmiana całego obiektu na nowy odcięłaby szablon od danych. params i categories znów dostają świeże kopie. JSON.parse(JSON.stringify(module)) daje w konsoli zwykłą migawkę danych zamiast obiektu reaktywnego. Polecam pójść o krok dalej i zamienić initialState na funkcję zwracającą nowy obiekt przy każdym wywołaniu - pułapka płytkiej kopii znika wtedy całkowicie. W projekcie modułu wykorzystasz ten sam porządek: stan, v-model, walidacja na @blur, computed isFormValid i @submit.prevent.
Pamiętaj: dobry formularz rejestracji działa jak dobrze zaprojektowany moduł stacji - każda grupa ma swój przedział, a reset przywraca fabryczne ustawienia bez zostawiania śladów.
Kod do tej lekcji: App.vue
<script setup>
import { ref, computed } from 'vue'
const missionForm = ref({
commander: '',
destination: '',
duration: '',
crewSize: '',
missionType: 'exploration',
equipment: [],
emergencyProtocol: false,
launchDate: '',
objectives: ''
})
const errors = ref({})
const submitted = ref(false)
const submittedData = ref(null)
const missionTypes = [
{ value: 'exploration', label: 'Eksploracja' },
{ value: 'research', label: 'Badania' },
{ value: 'construction', label: 'Budowa' },
{ value: 'rescue', label: 'Ratunkowa' }
]
const equipmentOptions = [
{ id: 'rover', name: 'Łazik' },
{ id: 'drill', name: 'Wiertło' },
{ id: 'lab', name: 'Laboratorium' },
{ id: 'satellite', name: 'Satelita' },
{ id: 'drone', name: 'Dron' }
]
const validateForm = () => {
errors.value = {}
if (!missionForm.value.commander.trim()) {
errors.value.commander = 'Dowódca jest wymagany'
}
if (!missionForm.value.destination.trim()) {
errors.value.destination = 'Miejsce docelowe jest wymagane'
}
const duration = Number(missionForm.value.duration)
if (!duration || duration < 1 || duration > 365) {
errors.value.duration = 'Czas trwania: 1-365 dni'
}
const crew = Number(missionForm.value.crewSize)
if (!crew || crew < 1 || crew > 50) {
errors.value.crewSize = 'Załoga: 1-50 osób'
}
if (!missionForm.value.launchDate) {
errors.value.launchDate = 'Data startu jest wymagana'
}
if (missionForm.value.objectives.trim().length < 20) {
errors.value.objectives = 'Cele muszą mieć minimum 20 znaków'
}
return Object.keys(errors.value).length === 0
}
const handleSubmit = () => {
if (validateForm()) {
submitted.value = true
submittedData.value = {
...missionForm.value,
submittedAt: new Date().toLocaleString('pl-PL')
}
// Symulacja wysłania
setTimeout(() => {
resetForm()
}, 5000)
}
}
const resetForm = () => {
missionForm.value = {
commander: '',
destination: '',
duration: '',
crewSize: '',
missionType: 'exploration',
equipment: [],
emergencyProtocol: false,
launchDate: '',
objectives: ''
}
errors.value = {}
submitted.value = false
submittedData.value = null
}
const isFormValid = computed(() => {
return missionForm.value.commander.trim() &&
missionForm.value.destination.trim() &&
missionForm.value.duration &&
missionForm.value.crewSize &&
missionForm.value.launchDate &&
missionForm.value.objectives.trim().length >= 20
})
</script>
<template>
<div class="mission-control">
<div class="control-header">
<h2>Centrum Kontroli Misji NOVA LAB</h2>
<p class="subtitle">Kompletny System Zgłaszania Misji</p>
</div>
<div v-if="submitted" class="success-panel">
<div class="success-message">
<h3>Misja Zarejestrowana Pomyślnie!</h3>
<p>Dane zostały przesłane do Centrum Dowodzenia NOVA LAB</p>
</div>
<div class="submitted-data">
<h4>Szczegóły Misji:</h4>
<div class="data-grid">
<div><strong>Dowódca:</strong> {{ submittedData.commander }}</div>
<div><strong>Cel:</strong> {{ submittedData.destination }}</div>
<div><strong>Czas trwania:</strong> {{ submittedData.duration }} dni</div>
<div><strong>Załoga:</strong> {{ submittedData.crewSize }} osób</div>
<div><strong>Typ:</strong> {{ missionTypes.find(t => t.value === submittedData.missionType)?.label }}</div>
<div><strong>Sprzęt:</strong> {{ submittedData.equipment.length }} elementów</div>
<div><strong>Data startu:</strong> {{ submittedData.launchDate }}</div>
<div><strong>Wysłano:</strong> {{ submittedData.submittedAt }}</div>
</div>
</div>
<button @click="resetForm" class="reset-btn">
Nowa Misja
</button>
</div>
<form v-else @submit.prevent="handleSubmit" class="mission-form">
<div class="form-section">
<h3>Podstawowe Informacje</h3>
<div class="form-field">
<label for="commander">Dowódca Misji:</label>
<input
id="commander"
v-model.trim="missionForm.commander"
type="text"
placeholder="Imię i nazwisko"
class="form-input"
:class="{ error: errors.commander }"
/>
<span v-if="errors.commander" class="error-text">{{ errors.commander }}</span>
</div>
<div class="form-field">
<label for="destination">Miejsce Docelowe:</label>
<input
id="destination"
v-model.trim="missionForm.destination"
type="text"
placeholder="np. Krater Gale, Mars"
class="form-input"
:class="{ error: errors.destination }"
/>
<span v-if="errors.destination" class="error-text">{{ errors.destination }}</span>
</div>
<div class="form-row">
<div class="form-field">
<label for="duration">Czas trwania (dni):</label>
<input
id="duration"
v-model.number="missionForm.duration"
type="number"
placeholder="1-365"
class="form-input"
:class="{ error: errors.duration }"
/>
<span v-if="errors.duration" class="error-text">{{ errors.duration }}</span>
</div>
<div class="form-field">
<label for="crew">Wielkość załogi:</label>
<input
id="crew"
v-model.number="missionForm.crewSize"
type="number"
placeholder="1-50"
class="form-input"
:class="{ error: errors.crewSize }"
/>
<span v-if="errors.crewSize" class="error-text">{{ errors.crewSize }}</span>
</div>
</div>
<div class="form-field">
<label for="launch">Data startu:</label>
<input
id="launch"
v-model="missionForm.launchDate"
type="date"
class="form-input"
:class="{ error: errors.launchDate }"
/>
<span v-if="errors.launchDate" class="error-text">{{ errors.launchDate }}</span>
</div>
</div>
<div class="form-section">
<h3>Konfiguracja Misji</h3>
<div class="form-field">
<label>Typ misji:</label>
<div class="radio-group">
<label
v-for="type in missionTypes"
:key="type.value"
class="radio-label"
>
<input
v-model="missionForm.missionType"
type="radio"
:value="type.value"
/>
{{ type.label }}
</label>
</div>
</div>
<div class="form-field">
<label>Wyposażenie:</label>
<div class="checkbox-group">
<label
v-for="item in equipmentOptions"
:key="item.id"
class="checkbox-label"
>
<input
v-model="missionForm.equipment"
type="checkbox"
:value="item.id"
/>
{{ item.name }}
</label>
</div>
</div>
<div class="form-field">
<label class="checkbox-label emergency">
<input
v-model="missionForm.emergencyProtocol"
type="checkbox"
/>
Aktywuj Protokół Ratunkowy
</label>
</div>
</div>
<div class="form-section">
<h3>Cele Misji</h3>
<div class="form-field">
<label for="objectives">Szczegółowy opis celów:</label>
<textarea
id="objectives"
v-model.trim="missionForm.objectives"
placeholder="Opisz główne cele i zadania misji (minimum 20 znaków)..."
class="form-textarea"
:class="{ error: errors.objectives }"
rows="6"
></textarea>
<div class="char-counter">
Znaki: {{ missionForm.objectives.length }}
</div>
<span v-if="errors.objectives" class="error-text">{{ errors.objectives }}</span>
</div>
</div>
<div class="form-actions">
<button
type="submit"
class="submit-btn"
:class="{ disabled: !isFormValid }"
:disabled="!isFormValid"
>
Zarejestruj Misję
</button>
<button
type="button"
@click="resetForm"
class="cancel-btn"
>
Anuluj
</button>
</div>
<div class="form-status" :class="{ valid: isFormValid }">
{{ isFormValid ? 'Formularz gotowy do wysłania' : 'Uzupełnij wszystkie wymagane pola' }}
</div>
</form>
</div>
</template>
<style scoped>
.mission-control {
background: linear-gradient(135deg, #0a0e27 0%, #1a1e3f 100%);
color: #00ff88;
padding: 30px;
border-radius: 15px;
border: 2px solid #00b4d8;
font-family: 'Courier New', monospace;
max-width: 1000px;
margin: 0 auto;
}
.control-header {
text-align: center;
margin-bottom: 30px;
padding-bottom: 20px;
border-bottom: 2px solid #00b4d8;
}
.control-header h2 {
color: #00ff88;
margin: 0 0 10px 0;
font-size: 28px;
text-shadow: 0 0 10px #00ff88;
}
.subtitle {
color: #00b4d8;
margin: 0;
font-size: 14px;
}
.success-panel {
text-align: center;
}
.success-message {
background: rgba(0, 255, 136, 0.1);
border: 2px solid #00ff88;
border-radius: 12px;
padding: 30px;
margin-bottom: 30px;
}
.success-message h3 {
color: #00ff88;
margin: 0 0 10px 0;
font-size: 24px;
}
.success-message p {
color: #00b4d8;
margin: 0;
}
.submitted-data {
background: rgba(0, 180, 216, 0.05);
border: 1px solid #00b4d8;
border-radius: 8px;
padding: 20px;
margin-bottom: 20px;
text-align: left;
}
.submitted-data h4 {
color: #00ff88;
margin-top: 0;
}
.data-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
gap: 15px;
color: #00b4d8;
}
.data-grid strong {
color: #00ff88;
}
.reset-btn {
background: linear-gradient(135deg, #00b4d8 0%, #0077b6 100%);
color: white;
border: none;
padding: 15px 40px;
border-radius: 8px;
font-size: 16px;
font-weight: bold;
cursor: pointer;
font-family: 'Courier New', monospace;
}
.mission-form {
display: flex;
flex-direction: column;
gap: 30px;
}
.form-section {
background: rgba(0, 180, 216, 0.05);
padding: 25px;
border-radius: 12px;
border: 1px solid #00b4d8;
}
.form-section h3 {
color: #00ff88;
margin: 0 0 20px 0;
font-size: 20px;
}
.form-field {
margin-bottom: 20px;
}
.form-field:last-child {
margin-bottom: 0;
}
.form-field > label {
display: block;
color: #00b4d8;
margin-bottom: 8px;
font-size: 14px;
font-weight: bold;
}
.form-input,
.form-textarea {
width: 100%;
background: rgba(0, 180, 216, 0.1);
border: 2px solid #00b4d8;
border-radius: 8px;
padding: 12px 15px;
color: #00ff88;
font-size: 16px;
font-family: 'Courier New', monospace;
box-sizing: border-box;
}
.form-input:focus,
.form-textarea:focus {
outline: none;
border-color: #00ff88;
box-shadow: 0 0 15px rgba(0, 255, 136, 0.3);
}
.form-input.error,
.form-textarea.error {
border-color: #ff6b35;
}
.form-textarea {
resize: vertical;
}
.form-row {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 15px;
}
.error-text {
display: block;
margin-top: 5px;
color: #ff6b35;
font-size: 12px;
}
.char-counter {
margin-top: 5px;
color: #00b4d8;
font-size: 12px;
}
.radio-group,
.checkbox-group {
display: flex;
flex-direction: column;
gap: 10px;
}
.radio-label,
.checkbox-label {
display: flex;
align-items: center;
gap: 10px;
padding: 10px 15px;
background: rgba(0, 180, 216, 0.05);
border: 1px solid #00b4d8;
border-radius: 6px;
cursor: pointer;
color: #00ff88;
}
.radio-label:hover,
.checkbox-label:hover {
background: rgba(0, 180, 216, 0.15);
}
.checkbox-label.emergency {
background: rgba(255, 107, 53, 0.1);
border-color: #ff6b35;
color: #ff6b35;
font-weight: bold;
}
.form-actions {
display: flex;
gap: 15px;
justify-content: center;
}
.submit-btn,
.cancel-btn {
padding: 15px 40px;
border: none;
border-radius: 8px;
font-size: 16px;
font-weight: bold;
cursor: pointer;
font-family: 'Courier New', monospace;
transition: all 0.3s ease;
}
.submit-btn {
background: linear-gradient(135deg, #00ff88 0%, #00b368 100%);
color: #0a0e27;
}
.submit-btn:hover:not(.disabled) {
transform: translateY(-2px);
box-shadow: 0 5px 20px rgba(0, 255, 136, 0.4);
}
.submit-btn.disabled {
opacity: 0.5;
cursor: not-allowed;
}
.cancel-btn {
background: linear-gradient(135deg, #ff6b35 0%, #d64545 100%);
color: white;
}
.cancel-btn:hover {
transform: translateY(-2px);
box-shadow: 0 5px 20px rgba(255, 107, 53, 0.4);
}
.form-status {
text-align: center;
padding: 15px;
background: rgba(255, 107, 53, 0.1);
border: 2px solid #ff6b35;
border-radius: 8px;
color: #ff6b35;
font-weight: bold;
}
.form-status.valid {
background: rgba(0, 255, 136, 0.1);
border-color: #00ff88;
color: #00ff88;
}
</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 najlepiej zresetować formularz w Vue?
2. Jak pokazać dodatkowe pole tylko gdy checkbox jest zaznaczony?
To 2 z 4 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Układanie w poziomie
Ułóż składnię warunkowego wyświetlenia pola z v-if:
- Edytor kodu
Zbuduj formularz z fieldset, walidacją, reset i submit.
- Układanie w poziomie
Ułóż poprawną składnię fieldset z legend:
- Klikanie w kolejności
Ułóż składnię formularza z handlerem submit:
- Edytor kodu
Zbuduj formularz z walidacją @blur, przyciskiem reset i disabled submit.
- Układanie w pionie
Ułóż kroki tworzenia reaktywnego formularza w Vue:
- Klikanie w kolejności
Ułóż definicję computed sprawdzającego formularz:
- Układanie w poziomie
Ułóż poprawną składnię textarea z v-model od góry do dołu:
Zadania po tej lekcji
- PytanieReset formularza
- PytanieWarunkowe pola formularza
- Ułóż w kolejnościSkładnia warunkowego pola
- Zadanie z kodemPraktyka: Kompletny formularz
- PytanieElementy formularza HTML
- PytanieFieldset i legend
- Ułóż w kolejnościSkładnia fieldset
- Kliknij w kolejnościBudowa formularza z @submit.prevent
- Zadanie z kodemPraktyka: Formularz z walidacją i resetem
- Ułóż w kolejnościStruktura reaktywnego formularza
- Kliknij w kolejnościBudowa computed isFormValid
- Ułóż w kolejnościSkładnia textarea z v-model