CKTIS / JavaScript
Formularze i sprawdzanie poprawności
Użyj `input`, aby reagować na edycję pola, a `submit`, aby obsłużyć wysłanie formularza po przejściu standardowej walidacji. `HTMLFormElement` udostępnia też metody do jawnego sprawdzania poprawności formularza.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
field.addEventListener("input", handler); form.addEventListener("submit", handler); form.checkValidity(); form.reportValidity(); form.requestSubmit();HTMLFormElement to interfejs przeglądarkowego DOM reprezentujący element form. Właściwość form.elements daje dostęp do kontrolek powiązanych z formularzem. To Web API, a nie część języka ECMAScript.
Zdarzenie input pozwala reagować na edycję pola przez użytkownika, na przykład aktualizować podpowiedź podczas pisania. Samo przypisanie wartości do field.value w JavaScript nie wywołuje input. Atrybut required sprawia, że puste pole tekstowe nie przechodzi walidacji. form.checkValidity() zwraca wynik sprawdzenia jako wartość logiczną. form.reportValidity() również zwraca wynik jako wartość logiczną i dodatkowo informuje użytkownika o błędach walidacji, chyba że zdarzenie invalid danej kontrolki zostanie anulowane. Anulowanie tego zdarzenia nie zmienia wyniku walidacji: metoda zwraca false, ale nie wyświetla błędu dla tej kontrolki.
Przy standardowej próbie wysłania przeglądarka najpierw sprawdza ograniczenia. Jeśli pole jest niepoprawne, przeglądarka blokuje wysłanie i nie wywołuje zdarzenia submit. Jeśli walidacja się powiedzie, submit jest wywoływane na formularzu, nie na przycisku. W jego obsłudze event.preventDefault() zatrzymuje domyślne wysłanie.
Aby rozpocząć ten sam proces z kodu, użyj form.requestSubmit(). Bezpośrednie wywołanie form.submit() omija zarówno walidację, jak i zdarzenie submit. Walidacja w przeglądarce pomaga użytkownikowi poprawić dane, ale nie zastępuje walidacji na serwerze.
Przykłady
<!doctype html>
<meta charset="utf-8">
<title>Form validity</title>
<form id="profile">
<label>Name <input name="displayName" required></label>
<button type="submit">Save</button>
</form>
<pre id="log"></pre>
<script>
const form = document.querySelector('#profile');
const field = form.elements.namedItem('displayName');
const log = document.querySelector('#log');
const append = (line) => { log.textContent += line + '\n'; };
field.addEventListener('input', () => {
append(`input: ${form.checkValidity()}`);
});
form.addEventListener('submit', (event) => {
event.preventDefault();
append(`submit: ${field.value}`);
});
append(`initial: ${form.checkValidity()}`);
</script>Wynik
initial: false input: true submit: A
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.