CKTIS / JavaScript
Události `submit` a `input` ve formulářích HTML
`input` slouží k reakci na úpravy polí, zatímco `submit` umožňuje obsloužit odeslání formuláře ve správném okamžiku ověřování.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
form.addEventListener("submit", onSubmit);
form.addEventListener("input", onInput);
form.requestSubmit();
form.requestSubmit(submitter);
form.submit();input vzniká na upravovaném prvku a šíří se vzhůru stromem DOM. V posluchači na formuláři označuje event.target prvek a event.currentTarget po dobu obsluhy označuje formulář. Je-li prvek mimo formulář a je s ním spojen atributem form, toto spojení samo o sobě událost do formuláře nepřenese. Používej input pro průběžnou odezvu; change oznamuje potvrzení změny, u textového pole obvykle při ztrátě fokusu. Přiřazení do .value samo o sobě input nevyvolá.
submit vzniká na formuláři, nikoli na tlačítku. Jde o událost typu SubmitEvent, která se šíří vzhůru a lze ji zrušit. Naslouchej jí místo click na tlačítku, abys zachytil i implicitní odeslání, například klávesou Enter, pokud to prohlížeč podporuje. event.submitter označuje odesílací tlačítko nebo má hodnotu null, pokud odeslání nespustilo žádné tlačítko. Chceš-li výchozí odeslání zastavit, zavolej v posluchači event.preventDefault() před jakýmkoli await.
form.requestSubmit() postupuje podle běžných pravidel odeslání bez výběru tlačítka. form.requestSubmit(button) použije dané tlačítko a respektuje jeho nastavení, například formaction a formnovalidate. Pokud se ověření vstupních omezení nevynechá a selže, neplatné prvky dostanou invalid a submit se nevyvolá. Prvek, který není odesílacím tlačítkem, způsobí TypeError; odesílací tlačítko, které nepatří k tomuto formuláři, způsobí NotFoundError.
Přímé volání form.submit() vynechá ověření vstupních omezení a nevyvolá submit. Prvek s name nebo id rovným submit může metodu zastínit. Ověření v prohlížeči nenahrazuje ověření na serveru. Jde o API webové platformy, nikoli o součást ECMAScriptu 2024; ověř podporu v cílovém prostředí.
Příklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Form submit and input events</title>
</head>
<body>
<script>
(() => {
const form = document.createElement("form");
const field = document.createElement("input");
field.type = "text";
field.required = true;
const button = document.createElement("button");
button.type = "submit";
button.value = "save";
button.textContent = "Save";
form.append(field, button);
field.addEventListener("invalid", (event) => {
event.preventDefault();
console.log("invalid");
});
form.addEventListener("input", (event) => {
if (event.target === field) console.log(`input: ${field.value}`);
});
form.addEventListener("submit", (event) => {
event.preventDefault();
console.log(`submit: ${event.submitter.value}`);
});
document.body.append(form);
try {
form.requestSubmit(button);
field.value = "Ada";
console.log(`set: ${field.value}`);
field.dispatchEvent(new Event("input", { bubbles: true }));
form.requestSubmit(button);
} finally {
form.remove();
}
})();
</script>
</body>
</html>Výsledek
invalid set: Ada input: Ada submit: save
Ulož příklad jako soubor HTML a otevři ho v prohlížeči. Otevři konzoli a znovu načti stránku. První požadavek vypíše `invalid`. Po `set: Ada` vypíše `input: Ada` až ručně vyvolaná událost; druhý požadavek vypíše `submit: save`, ale posluchač odeslání zruší.
Související lekce
- JavaScript · Lekce 15 · Pokročilá · Verze: 4
Zdroje
- HTML Standard — Form submission algorithm
- HTML Standard — Constraints: Security
- HTMLFormElement: submit event
- Element: input event
- HTMLElement: change event
- HTMLFormElement: requestSubmit() method
- HTMLFormElement: submit() method
- Event: currentTarget property
- Event: preventDefault() method
- EventTarget: dispatchEvent() method