Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

onsubmit — obravnava poskusa oddaje obrazca

Atribut onsubmit določa kodo JavaScript, ki obravnava dogodek submit. Omogoča odziv na poskus oddaje obrazca in preklic privzete oddaje; ne potrjuje, da so podatki dosegli strežnik.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

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

onsubmit je atribut za obravnavo dogodka submit. Običajno je nameščen na elementu form, ne na gumbu za oddajo. Čeprav je na voljo na vseh elementih HTML, je cilj tega dogodka obrazec; dogodek se širi do prednikov. Vrednost atributa je koda JavaScript, ne ciljni naslov obrazca.

Dogodek se sproži pred privzeto oddajo, na primer po aktiviranju gumba za oddajo ali klicu form.requestSubmit(). Če brskalnik izvaja preverjanje omejitev in obrazec pri njem ne uspe, se dogodek submit ne sproži. Metoda form.submit() zaobide tako preverjanje kot dogodek submit.

Koda atributa prejme parameter event. Klic event.preventDefault() ali izvedba return false prekliče privzeto oddajo. S tem se širjenje dogodka ne ustavi. Sam klic funkcije, ki vrne false, brez posredovanja njenega rezultata z return ne prekliče oddaje.

JavaScript lahko funkcijo dodeli tudi form.onsubmit; naslednja dodelitev nadomesti prejšnjo funkcijo te lastnosti. Primer uporablja atribut, prekliče oddajo in spremeni besedilo stanja. JavaScript mora biti omogočen, varnostna politika pa mora dovoljevati obravnavo dogodkov v atributih.

Primeri

<!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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri