CKTIS / HTML
onsubmit — obrada pokušaja slanja obrasca
Atribut onsubmit određuje JavaScript kod koji obrađuje događaj submit. Omogućuje reakciju na pokušaj slanja obrasca i otkazivanje zadanog slanja; ne potvrđuje da su podaci stigli do poslužitelja.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
onsubmit="JavaScript statements"
form.onsubmit = function (event) { /* handler */ };onsubmit je atribut za obradu događaja submit. Obično se postavlja na element form, a ne na gumb za slanje. Iako je dostupan na svim HTML elementima, obrazac je cilj tog događaja, koji se širi prema pretcima. Vrijednost atributa je JavaScript kod, a ne odredišna adresa obrasca.
Događaj se pojavljuje prije zadanog slanja, primjerice nakon aktiviranja gumba za slanje ili poziva form.requestSubmit(). Ako preglednik provodi provjeru ograničenja i obrazac je ne prođe, događaj submit se ne pojavljuje. Metoda form.submit() zaobilazi i tu provjeru i događaj submit.
Kod atributa prima parametar event. Poziv event.preventDefault() ili izvođenje return false otkazuje zadano slanje. Time se ne zaustavlja širenje događaja. Sam poziv funkcije koja vraća false, bez prosljeđivanja njezina rezultata pomoću return, ne otkazuje slanje.
JavaScript može dodijeliti funkciju i svojstvu form.onsubmit; sljedeća dodjela zamjenjuje prethodnu funkciju tog svojstva. Primjer upotrebljava atribut, otkazuje slanje i mijenja tekst statusa. JavaScript mora biti omogućen, a sigurnosna politika mora dopuštati ugrađene rukovatelje događaja.
Primjeri
<!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>Rezultat
Submission canceled
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.