Vue Academy · Lekcja

Wysyłanie i resetowanie formularza

@submit.prevent, FormData, resetowanie stanu formularza, wyłączanie wysyłania podczas ładowania.

Wysyłanie i resetowanie formularza to bezpłatna lekcja Vue Academy na CoddyKit. To lekcja 2 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Vue Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Vue Academy zawiera 4 lekcji w sumie.

Obsługa wysyłania formularza

Prawdziwy formularz musi wysyłać dane bez ponownego ładowania strony, obsługiwać stan ładowania i resetować się po zakończeniu. Composition API oraz kilka dyrektyw pozwalają zrobić to w przejrzysty sposób.

Zatrzymanie ponownego ładowania strony

Domyślnie wysłanie formularza powoduje ponowne załadowanie strony. Modyfikator .prevent przy @submit wywołuje preventDefault(), dzięki czemu można obsłużyć wysyłanie w JavaScript.

<form @submit.prevent="onSubmit">
  <button type="submit">Send</button>
</form>

Reaktywny obiekt formularza

Powiązane pola należy zgrupować w jednym obiekcie reaktywnym. Każde pole wejściowe używa v-model z właściwością tego obiektu.

<script setup>
import { reactive } from 'vue'
const form = reactive({ name: '', email: '' })
</script>

<template>
  <input v-model="form.name" />
  <input v-model="form.email" />
</template>

Program obsługi wysyłania

Program obsługi odczytuje reaktywny formularz i wysyła jego dane. Ponieważ użyto modyfikatora .prevent, strona pozostaje bez zmian.

<script setup>
async function onSubmit() {
  await fetch('/api/users', {
    method: 'POST',
    body: JSON.stringify(form)
  })
}
</script>

Śledzenie stanu ładowania

Należy dodać ref loading, aby interfejs mógł reagować podczas oczekiwania na żądanie. Przed żądaniem trzeba ustawić go na true, a po jego zakończeniu na false.

<script setup>
import { ref, reactive } from 'vue'
const loading = ref(false)
const form = reactive({ name: '' })
</script>

Wyłączanie przycisku podczas wysyłania

Należy powiązać :disabled z loading, aby użytkownicy nie mogli wysłać formularza dwukrotnie. Wartość loading należy przełączać przed wywołaniem asynchronicznym i po nim.

<script setup>
async function onSubmit() {
  loading.value = true
  try { await save() } finally { loading.value = false }
}
</script>

<template>
  <button type="submit" :disabled="loading">Send</button>
</template>

Wyświetlanie informacji o wysyłaniu

Flaga ładowania może służyć do zmiany tekstu przycisku lub wyświetlenia wskaźnika ładowania, zapewniając użytkownikom jasną informację, że operacja jest w toku.

<template>
  <button :disabled="loading">
    {{ loading ? 'Sending...' : 'Send' }}
  </button>
</template>

Resetowanie formularza

Aby wyczyścić formularz, należy ponownie przypisać każdemu polu jego wartość początkową. Warto zachować początkową migawkę stanu, aby reset działał niezawodnie.

<script setup>
import { reactive } from 'vue'
const initial = { name: '', email: '' }
const form = reactive({ ...initial })
function reset() { Object.assign(form, initial) }
</script>

Resetowanie po pomyślnym wysłaniu

Wywołaj reset, gdy żądanie zakończy się powodzeniem, aby użytkownik mógł wprowadzić kolejne dane w pustym formularzu.

<script setup>
async function onSubmit() {
  loading.value = true
  try {
    await save()
    reset()
  } finally { loading.value = false }
}
</script>

Połączenie wszystkich elementów

Kompletny wzorzec obejmuje: zapobieganie przeładowaniu, formularz reaktywny, ochronę przed wielokrotnym wysłaniem, wyłączony przycisk i resetowanie po powodzeniu — to podstawa większości formularzy Vue.

Dlaczego try/finally

Umieszczenie operacji asynchronicznej w try/finally gwarantuje zresetowanie loading, nawet jeśli żądanie zgłosi wyjątek. W przeciwnym razie nieudane wysłanie formularza mogłoby pozostawić przycisk trwale wyłączony.

Szybki test

Sprawdź swoją wiedzę na temat wysyłania formularzy.

Podsumowanie

Najważniejsze informacje o wysyłaniu formularzy:

@submit.prevent zapobiega przeładowaniu strony.
Grupuj pola w reaktywnym obiekcie powiązanym za pomocą v-model.
Śledź ref loading i powiąż z nim atrybut :disabled.
Resetuj formularz, ponownie przypisując polom wartości początkowe, najlepiej po pomyślnym wysłaniu.
Używaj try/finally, aby stan loading zawsze był resetowany.

Często zadawane pytania

Czy lekcja „Wysyłanie i resetowanie formularza” jest bezpłatna?

Tak — pełny tekst „Wysyłanie i resetowanie formularza” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Vue Academy, przejdź na CoddyKit PRO. Kurs Vue Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Wysyłanie i resetowanie formularza”?

@submit.prevent, FormData, resetowanie stanu formularza, wyłączanie wysyłania podczas ładowania. Ćwiczysz Vue Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Vue Academy?

Nie wymagamy żadnego doświadczenia. Vue Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 4.

Ile czasu zajmuje lekcja „Wysyłanie i resetowanie formularza”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Vue Academy?

Tak. Każda lekcja Vue Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

v-model dla wszystkich elementów formularza
Wysyłanie i resetowanie formularza
Wzorce ręcznej walidacji
VeeValidate do walidacji opartej na schemacie

← Powrót do Vue Academy