CKTIS / HTML
onsubmit — spracovanie pokusu o odoslanie formulára
Atribút onsubmit určuje JavaScriptový kód, ktorý spracúva udalosť submit. Umožňuje reagovať na pokus o odoslanie formulára a zrušiť predvolené odoslanie; nepotvrdzuje, že údaje dorazili na server.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onsubmit="JavaScript statements"
form.onsubmit = function (event) { /* handler */ };onsubmit je atribút obsluhy udalosti submit. Zvyčajne sa umiestňuje na prvok form, nie na tlačidlo odoslania. Hoci je dostupný na všetkých prvkoch HTML, cieľom tejto udalosti je formulár; udalosť sa šíri k predkom. Hodnotou atribútu je JavaScriptový kód, nie cieľová adresa formulára.
Udalosť nastane pred predvoleným odoslaním, napríklad po aktivácii tlačidla odoslania alebo zavolaní form.requestSubmit(). Ak prehliadač vykonáva validáciu obmedzení a formulár ňou neprejde, udalosť submit nenastane. Metóda form.submit() obchádza validáciu aj udalosť submit.
Kód atribútu dostane parameter event. Zavolanie event.preventDefault() alebo vykonanie return false zruší predvolené odoslanie. Nezastaví sa tým šírenie udalosti. Samotné zavolanie funkcie, ktorá vracia false, bez odovzdania jej výsledku pomocou return odoslanie nezruší.
JavaScript môže tiež priradiť funkciu k form.onsubmit; ďalšie priradenie nahradí predchádzajúcu funkciu tejto vlastnosti. Príklad používa atribút, ruší odoslanie a mení text stavu. JavaScript musí byť zapnutý a bezpečnostné pravidlá musia povoľovať obslužné rutiny udalostí zapísané priamo v HTML.
Príklady
<!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>Výsledok
Submission canceled
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.