Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onsubmit — obsługa próby wysłania formularza

Atrybut onsubmit określa kod JavaScript obsługujący zdarzenie submit. Pozwala zareagować na próbę wysłania formularza i anulować domyślne wysłanie; nie potwierdza dostarczenia danych do serwera.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

onsubmit="JavaScript statements"
form.onsubmit = function (event) { /* handler */ };

onsubmit jest atrybutem obsługi zdarzenia submit. Zwykle umieszcza się go na elemencie form, a nie na przycisku wysyłania. Choć jest dostępny na wszystkich elementach HTML, to formularz jest celem tego zdarzenia; zdarzenie propaguje się do przodków. Wartością atrybutu jest kod JavaScript, nie adres docelowy formularza.

Zdarzenie występuje przed domyślnym wysłaniem, np. po aktywowaniu przycisku wysyłania lub wywołaniu form.requestSubmit(). Jeśli przeglądarka wykonuje walidację ograniczeń i formularz jej nie przejdzie, submit nie wystąpi. Metoda form.submit() pomija zarówno tę walidację, jak i zdarzenie submit.

W kodzie atrybutu dostępny jest parametr event. Wywołanie event.preventDefault() lub wykonanie return false anuluje domyślne wysłanie. Nie oznacza to zatrzymania propagacji zdarzenia. Samo wywołanie funkcji zwracającej false bez przekazania wyniku przez return nie anuluje wysłania.

W JavaScript można też przypisać funkcję do form.onsubmit; kolejne przypisanie zastępuje poprzednią funkcję tej właściwości. Przykład używa atrybutu, anuluje wysłanie i zmienia tekst statusu. Wymaga włączonego JavaScript oraz polityki bezpieczeństwa zezwalającej na obsługę zdarzeń zapisaną w atrybutach.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onsubmit demo</title>
<form onsubmit="event.preventDefault(); document.getElementById('result').textContent = 'Submission canceled';">
  <button type="submit">Submit</button>
</form>
<p id="result" role="status">Ready</p>
</html>

Wynik

Submission canceled

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła