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.