Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori