Kurs Vue.js · Moduł 5: Zdarzenia i formularze
Obsługa Zdarzeń - Przyciski Kontrolne
W tej lekcji5
Witaj w Symulatorze Sterowania NOVA LAB! Do tej pory panele stacji tylko wyświetlały dane: liczyły, filtrowały i raportowały. Załoga musi jednak nimi sterować, a przycisk, który nie reaguje na kliknięcie, jest tylko dekoracją. W czystym JavaScripcie każdy przycisk wymagałby odszukania elementu, podpięcia nasłuchu przez addEventListener i pamiętania o jego usunięciu, gdy panel znika. Vue robi to za Ciebie jedną dyrektywą.
Czego się nauczysz
- obsługi zdarzeń - jak podpiąć procedurę pod przycisk, klawisz albo ruch myszy.
- modyfikatorów zdarzeń - jak zablokować przeładowanie strony, zatrzymać propagację i reagować na konkretne klawisze.
- v-model - jak związać pola formularza ze zmiennymi w obie strony.
- modyfikatorów v-model - jak oczyścić sygnał z pól dzięki
.lazy,.numberi.trim. - zaawansowanych formularzy - wyboru wielu opcji, opcji generowanych z tablicy i walidacji.
- formularza w praktyce i projektu - pełnej rejestracji modułu i panelu rejestracji misji.
Podstawowa Obsługa Zdarzeń
Dyrektywa v-on nasłuchuje zdarzenia DOM i uruchamia kod, gdy ono nastąpi. Pełny zapis to v-on:click, a skrót używany na co dzień to @click. Wartością może być nazwa funkcji, czyli method handler, albo krótki kod JavaScript, czyli inline handler. Vue rozróżnia je samo: nazwa w rodzaju handleClick albo ścieżka panel.start to metoda, a wszystko inne, na przykład count++ czy initiateSystem('OXYGEN'), to kod inline. Najpierw szablon panelu z pięcioma wariantami przycisku.
<template>
<div class="control-panel" style="background: #0a0e27; color: #00ff88;">
<!-- Pełna składnia -->
<button v-on:click="handleClick" style="background: #00b4d8; color: #0a0e27;">Aktywuj</button>
<!-- Skrócona składnia (zalecana) -->
<button @click="handleClick" style="background: #00b4d8; color: #0a0e27;">Aktywuj</button>
<!-- Inline handler -->
<button @click="powerLevel++" style="background: #00b4d8; color: #0a0e27;">Moc: {{ powerLevel }}%</button>
<!-- Z argumentem -->
<button @click="initiateSystem('OXYGEN')" style="background: #00b4d8; color: #0a0e27;">Start O2</button>
<!-- Z event object -->
<button @click="logEvent($event)" style="background: #00b4d8; color: #0a0e27;">Log Command</button>
</div>
</template>Dwa pierwsze przyciski robią dokładnie to samo i różnią się tylko zapisem. Trzeci zwiększa powerLevel bezpośrednio w szablonie. Czwarty wywołuje funkcję z argumentem, a piąty przekazuje jej specjalną zmienną $event, pod którą Vue podstawia natywny obiekt zdarzenia. Teraz skrypt z funkcjami, które te przyciski wywołują.
<script setup>
import { ref } from 'vue'
const powerLevel = ref(0)
function handleClick() {
console.log('System activated!')
}
function initiateSystem(systemName) {
console.log(`Initializing ${systemName} system...`)
}
function logEvent(event) {
console.log('Event:', event.type, event.target)
}
</script>Zwróć uwagę na handleClick: w szablonie podaliśmy samą nazwę, bez nawiasów, więc Vue wywoła funkcję i przekaże jej obiekt zdarzenia jako pierwszy argument. Tu go nie używamy, ale jest dostępny. Co się nie zmieniło w porównaniu z czystym JavaScriptem: to nadal zwykłe funkcje i zwykłe zdarzenia przeglądarki. Vue dokłada tylko podpięcie nasłuchu i jego automatyczne odpięcie, gdy komponent znika ze strony.
Zdarzenie i własny argument
Czasem procedura potrzebuje zarówno obiektu zdarzenia, jak i własnej informacji, na przykład nazwy systemu. W inline handlerze przekazujesz wtedy $event obok argumentu. Równoważną formą jest funkcja strzałkowa, która dostaje zdarzenie jako parametr.
<template>
<button @click="logAction($event, 'oxygen')">Log O2</button>
<button @click="(event) => logAction(event, 'water')">Log H2O</button>
</template>
<script setup>
function logAction(event, system) {
console.log(system, event.type)
}
</script>Oba przyciski wywołują tę samą funkcję i wypisują nazwę systemu oraz typ zdarzenia, czyli click. Kolejność argumentów ustalasz sam, byle zgadzała się z definicją funkcji. Pamiętaj, że w inline handlerze zdarzenie oznacza tylko $event - zwykłe event czy e są dla szablonu nieznanymi zmiennymi.
Typowe Zdarzenia
Po @ możesz wpisać nazwę dowolnego zdarzenia DOM. Poniższy szablon to katalog najczęstszych: zdarzenia myszy, klawiatury i formularzy, a także przewijania i ładowania obrazka. Funkcje obsługi pominęliśmy, bo liczą się tu same nazwy zdarzeń.
<template>
<!-- Mouse events -->
<div @click="onClick" @dblclick="onDoubleClick">Klik</div>
<div @mouseenter="onEnter" @mouseleave="onLeave">Hover</div>
<div @mousedown="onDown" @mouseup="onUp">Press</div>
<!-- Keyboard events -->
<input @keydown="onKeyDown" @keyup="onKeyUp" @keypress="onKeyPress" />
<!-- Form events -->
<form @submit="onSubmit">
<input @input="onInput" @change="onChange" @focus="onFocus" @blur="onBlur" />
</form>
<!-- Other -->
<div @scroll="onScroll">Scrollable content</div>
<img @load="onLoad" @error="onError" :src="imageUrl" />
</template>mouseenter i mouseleave zgłaszają wejście kursora na element i wyjście z niego, a w przeciwieństwie do mouseover nie odpalają się ponownie, gdy kursor przechodzi między elementami w środku. input przychodzi po każdej zmianie treści pola, a change po jej zatwierdzeniu. focus i blur oznaczają wejście do pola i wyjście z niego. Uwaga na keypress: według MDN to zdarzenie jest przestarzałe (deprecated), więc w nowym kodzie używaj keydown. Vue nie wymyśla tu własnych zdarzeń - wszystkie są natywnymi zdarzeniami przeglądarki.
Dostęp do Event Object
Method handler dostaje obiekt zdarzenia automatycznie jako pierwszy parametr. Najczęściej przydają się: target, czyli element, na którym zdarzenie wystąpiło, clientX i clientY z położeniem kursora w oknie, buttons z maską wciśniętych przycisków myszy, a przy klawiaturze key, code oraz flagi ctrlKey i shiftKey.
<template>
<button @click="handleClick">Kliknij</button>
<input @keyup="handleKey" />
</template>
<script setup>
function handleClick(event) {
console.log('Target:', event.target)
console.log('Position:', event.clientX, event.clientY)
console.log('Buttons:', event.buttons)
}
function handleKey(event) {
console.log('Key:', event.key)
console.log('Code:', event.code)
console.log('Ctrl:', event.ctrlKey)
console.log('Shift:', event.shiftKey)
}
</script>key podaje wartość klawisza, na przykład "Enter" albo "a", a code jego fizyczne miejsce na klawiaturze, na przykład "KeyA", niezależnie od układu. Do skrótów reagujących na znak polecam key, bo na nim opierają się modyfikatory klawiszy z następnej lekcji. code wybieraj przy sterowaniu zależnym od położenia klawiszy, takim jak WASD. Przy buttons pamiętaj, że w zdarzeniu click przycisk bywa już puszczony, a to, który przycisk wywołał zdarzenie, podaje pole button.
Pamiętaj: @ to przewód między przyciskiem na panelu a procedurą w komputerze pokładowym - podajesz nazwę funkcji albo krótką komendę, a Vue sam podłącza i odłącza kabel.
Kod do tej lekcji: App.vue
<script setup>
import { ref } from 'vue'
const signalsSent = ref(0)
const lastSignalType = ref('')
const emergencyActive = ref(false)
const sendSignal = (type) => {
signalsSent.value++
lastSignalType.value = type
}
const activateEmergency = (event) => {
event.preventDefault()
emergencyActive.value = true
setTimeout(() => {
emergencyActive.value = false
}, 3000)
}
const sendOnce = () => {
console.log('Jednorazowy sygnał wysłany!')
}
</script>
<template>
<div class="communication-panel">
<div class="panel-header">
<h2>Panel Komunikacyjny NOVA LAB</h2>
<p class="subtitle">Strefa Komunikacji - Obsługa Zdarzeń</p>
</div>
<div class="stats">
<div class="stat-item">
<span class="label">Wysłane sygnały:</span>
<span class="value">{{ signalsSent }}</span>
</div>
<div class="stat-item">
<span class="label">Ostatni typ:</span>
<span class="value">{{ lastSignalType || 'Brak' }}</span>
</div>
</div>
<div class="signal-buttons">
<button @click="sendSignal('Rutynowy')" class="signal-btn routine">
Sygnał Rutynowy
</button>
<button @click="sendSignal('Pilny')" class="signal-btn urgent">
Sygnał Pilny
</button>
<button @click.once="sendOnce" class="signal-btn once">
Jednorazowy (.once)
</button>
</div>
<div class="emergency-section">
<a href="#" @click.prevent="activateEmergency" class="emergency-link">
Aktywuj Alarm (.prevent)
</a>
<div v-if="emergencyActive" class="emergency-alert">
ALARM AKTYWNY!
</div>
</div>
<div class="event-info">
<h3>Modyfikatory zdarzeń:</h3>
<ul>
<li><code>.prevent</code> - zapobiega domyślnej akcji</li>
<li><code>.stop</code> - zatrzymuje propagację wydarzenia</li>
<li><code>.once</code> - zdarzenie wykonuje się tylko raz</li>
</ul>
</div>
</div>
</template>
<style scoped>
.communication-panel {
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: 800px;
margin: 0 auto;
}
.panel-header {
text-align: center;
margin-bottom: 30px;
padding-bottom: 20px;
border-bottom: 2px solid #00b4d8;
}
.panel-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;
}
.stats {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 15px;
margin-bottom: 30px;
}
.stat-item {
background: rgba(0, 180, 216, 0.1);
padding: 15px;
border-radius: 8px;
border: 1px solid #00b4d8;
display: flex;
justify-content: space-between;
align-items: center;
}
.label {
color: #00b4d8;
font-size: 14px;
}
.value {
color: #00ff88;
font-size: 20px;
font-weight: bold;
}
.signal-buttons {
display: grid;
gap: 15px;
margin-bottom: 30px;
}
.signal-btn {
background: linear-gradient(135deg, #00b4d8 0%, #0077b6 100%);
color: white;
border: none;
padding: 15px 30px;
border-radius: 8px;
font-size: 16px;
font-weight: bold;
cursor: pointer;
transition: all 0.3s ease;
font-family: 'Courier New', monospace;
}
.signal-btn:hover {
transform: translateY(-2px);
box-shadow: 0 5px 15px rgba(0, 180, 216, 0.4);
}
.signal-btn.urgent {
background: linear-gradient(135deg, #ff6b35 0%, #d64545 100%);
}
.signal-btn.once {
background: linear-gradient(135deg, #9d4edd 0%, #7209b7 100%);
}
.emergency-section {
text-align: center;
margin-bottom: 30px;
padding: 20px;
background: rgba(255, 107, 53, 0.1);
border-radius: 8px;
border: 1px solid #ff6b35;
}
.emergency-link {
color: #ff6b35;
font-size: 18px;
text-decoration: none;
font-weight: bold;
padding: 10px 20px;
display: inline-block;
border: 2px solid #ff6b35;
border-radius: 8px;
transition: all 0.3s ease;
}
.emergency-link:hover {
background: rgba(255, 107, 53, 0.2);
transform: scale(1.05);
}
.emergency-alert {
margin-top: 15px;
padding: 15px;
background: #ff6b35;
color: white;
border-radius: 8px;
font-weight: bold;
animation: pulse 1s infinite;
}
@keyframes pulse {
0%, 100% { opacity: 1; }
50% { opacity: 0.7; }
}
.event-info {
background: rgba(0, 255, 136, 0.05);
padding: 20px;
border-radius: 8px;
border: 1px solid #00ff88;
}
.event-info h3 {
color: #00ff88;
margin-top: 0;
font-size: 18px;
}
.event-info ul {
margin: 0;
padding-left: 20px;
}
.event-info li {
color: #00b4d8;
margin: 8px 0;
}
.event-info code {
background: rgba(0, 255, 136, 0.2);
padding: 2px 6px;
border-radius: 4px;
color: #00ff88;
font-weight: bold;
}
</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 dodać event listener dla kliknięcia w Vue.js?
2. Jaki symbol jest skrótem dla dyrektywy v-on?
To 2 z 4 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Dodaj @click handler zwiększający licznik i wyświetl wartość.
- Klikanie w kolejności
Ułóż składnię dodania click handlera w Vue:
- Edytor kodu
Dodaj obsługę @mouseenter, @mouseleave i @dblclick na elemencie div.
- Układanie w poziomie
Ułóż poprawną składnię handlera przekazującego event i argument: