Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

onsubmit — zpracování pokusu o odeslání formuláře

Atribut onsubmit určuje JavaScriptový kód, který zpracovává událost submit. Umožňuje reagovat na pokus o odeslání formuláře a zrušit výchozí odeslání; nepotvrzuje, že data dorazila na server.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

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

onsubmit je atribut obsluhy události submit. Obvykle se umisťuje na prvek form, nikoli na tlačítko pro odeslání. Je sice dostupný na všech prvcích HTML, ale cílem této události je formulář; událost se šíří k předkům. Hodnotou atributu je JavaScriptový kód, nikoli cílová adresa formuláře.

Událost nastane před výchozím odesláním, například po aktivaci tlačítka pro odeslání nebo po zavolání form.requestSubmit(). Pokud prohlížeč provádí validaci omezení a formulář jí neprojde, událost submit nenastane. Metoda form.submit() obchází validaci i událost submit.

Kód atributu obdrží parametr event. Volání event.preventDefault() nebo provedení return false zruší výchozí odeslání. Tím se nezastaví šíření události. Pouhé zavolání funkce, která vrací false, bez předání jejího výsledku pomocí return odeslání nezruší.

JavaScript může také přiřadit funkci k form.onsubmit; další přiřazení nahradí předchozí funkci této vlastnosti. Příklad používá atribut, ruší odeslání a mění text stavu. Je třeba mít zapnutý JavaScript a bezpečnostní zásady, které povolují obslužné rutiny událostí zapsané přímo v HTML.

Pří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ýsledek

Submission canceled

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje