CKTIS / JavaScript
Zdarzenia `submit` i `input` w formularzach HTML
Używaj `input`, aby reagować na edycję pól, a `submit`, aby obsługiwać wysyłanie formularza we właściwym momencie cyklu walidacji.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
form.addEventListener("submit", onSubmit);
form.addEventListener("input", onInput);
form.requestSubmit();
form.requestSubmit(submitter);
form.submit();input powstaje na edytowanej kontrolce i propaguje się w górę drzewa DOM. W procedurze nasłuchującej na formularzu event.target wskazuje kontrolkę, a event.currentTarget wskazuje formularz na czas obsługi zdarzenia. Kontrolka powiązana z formularzem atrybutem form, lecz umieszczona poza nim, nie przekazuje mu zdarzenia tylko z racji tego powiązania. Używaj input do aktualizowania podglądu w trakcie edycji; change oznacza zatwierdzenie wartości, w polu tekstowym zwykle przy utracie fokusu. Przypisanie do .value samo nie wywołuje input.
submit powstaje na formularzu, nie na przycisku. To propagujące się i anulowalne zdarzenie typu SubmitEvent. Zamiast nasłuchiwać click na przycisku, obsługuj submit: obejmuje ono także niejawne wysyłanie, np. klawiszem Enter, gdy przeglądarka je obsługuje. event.submitter wskazuje przycisk wysyłający lub ma wartość null, gdy żaden przycisk nie zainicjował wysłania. Aby zatrzymać domyślne wysłanie, wywołaj event.preventDefault() w nasłuchiwaczu, zanim wykonasz await.
form.requestSubmit() stosuje zwykłe reguły wysyłania bez wyboru przycisku. form.requestSubmit(button) używa podanego przycisku i uwzględnia jego ustawienia, np. formaction i formnovalidate. Jeśli walidacja ograniczeń nie jest pominięta i wykryje błędy, nieprawidłowe kontrolki otrzymują invalid, a submit nie występuje. Gdy argument jest elementem, który nie jest przyciskiem wysyłającym, metoda zgłasza TypeError; przycisk należący do innego formularza lub do żadnego powoduje NotFoundError.
Bezpośrednie form.submit() pomija walidację ograniczeń i nie emituje submit. Kontrolka o name lub id równym submit może przesłonić tę metodę. Walidacja w przeglądarce nie zastępuje walidacji na serwerze. Są to interfejsy platformy WWW, nie ECMAScript 2024; sprawdź obsługę w docelowym środowisku.
Przykłady
<!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>Wynik
invalid set: Ada input: Ada submit: save
Zapisz przykład jako plik HTML i otwórz go w przeglądarce. Otwórz konsolę i odśwież stronę. Pierwsze żądanie daje `invalid`. Po `set: Ada` dopiero ręcznie wyemitowane zdarzenie powoduje `input: Ada`; drugie żądanie daje `submit: save`, lecz nasłuchiwacz anuluje wysłanie.
Powiązane lekcje
- JavaScript · Lekcja 15 · Zaawansowany · Wersja: 4
Źródła
- 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