Kurs Vue.js · Moduł 5: Zdarzenia i formularze

Obsługa Zdarzeń - Przyciski Kontrolne

5 min czytania ·
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, .number i .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. 1. Jak dodać event listener dla kliknięcia w Vue.js?

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

  1. PytanieSkładnia event listenera
  2. PytanieSkrócona składnia v-on
  3. Zadanie z kodemPraktyka: Click handler
  4. PytanieInline handler w Vue
  5. Kliknij w kolejnościSkładnia click handlera
  6. Zadanie z kodemPraktyka: Obsługa zdarzeń myszy
  7. PytanieObiekt event w handlerze
  8. Ułóż w kolejnościSkładnia handlera z $event

Przydatne artykuły