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

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