Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Udalosti `submit` a `input` vo formulároch HTML

Udalosť `input` slúži na reakciu na úpravy polí a `submit` umožňuje spracovať odoslanie formulára v správnom okamihu overovania.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

form.addEventListener("submit", onSubmit);
form.addEventListener("input", onInput);
form.requestSubmit();
form.requestSubmit(submitter);
form.submit();

input vzniká na upravovanom prvku a šíri sa nahor stromom DOM. V poslucháčovi na formulári označuje event.target prvok a event.currentTarget počas obsluhy označuje formulár. Ak je prvok mimo formulára a je s ním prepojený atribútom form, samotné prepojenie udalosť do formulára neprenesie. Použi input na priebežnú odozvu; change oznamuje potvrdenie zmeny, pri textovom poli zvyčajne po strate fokusu. Priradenie do .value samo osebe nevyvolá input.

submit vzniká na formulári, nie na tlačidle. Je to udalosť typu SubmitEvent, ktorá sa šíri nahor a dá sa zrušiť. Počúvaj ju namiesto click na tlačidle, aby si zachytil aj implicitné odoslanie, napríklad klávesom Enter, ak to prehliadač podporuje. event.submitter označuje odosielacie tlačidlo alebo má hodnotu null, ak odoslanie nespustilo žiadne tlačidlo. Ak chceš zastaviť predvolené odoslanie, zavolaj v poslucháčovi event.preventDefault() pred akýmkoľvek await.

form.requestSubmit() postupuje podľa bežných pravidiel odosielania bez výberu tlačidla. form.requestSubmit(button) použije dané tlačidlo a zohľadní jeho nastavenia, napríklad formaction a formnovalidate. Ak sa overenie vstupných obmedzení nepreskočí a zlyhá, neplatné prvky dostanú invalid a submit sa nevyvolá. Prvok, ktorý nie je odosielacím tlačidlom, spôsobí TypeError; odosielacie tlačidlo, ktoré nepatrí k danému formuláru, spôsobí NotFoundError.

Priame volanie form.submit() preskočí overenie vstupných obmedzení a nevyvolá submit. Prvok s name alebo id rovným submit môže prekryť metódu. Overovanie v prehliadači nenahrádza overovanie na serveri. Ide o API webovej platformy, nie o súčasť ECMAScriptu 2024; over podporu v cieľovom prostredí.

Prí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ýsledok

invalid
set: Ada
input: Ada
submit: save

Ulož príklad ako súbor HTML a otvor ho v prehliadači. Otvor konzolu a znova načítaj stránku. Prvá požiadavka vypíše `invalid`. Po `set: Ada` spôsobí výpis `input: Ada` až ručne vyvolaná udalosť; druhá požiadavka vypíše `submit: save`, ale poslucháč odoslanie zruší.

Súvisiace lekcie

  • JavaScript · Lekcia 15 · Pokročilá · Verzia: 4

Zdroje