Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła