Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

:user-valid — poprawne pole po interakcji użytkownika

Pseudoklasa :user-valid wybiera poprawne pola formularza dopiero po spełnieniu warunku interakcji użytkownika. W odróżnieniu od :valid nie sygnalizuje automatycznie poprawności nietkniętego pola.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

input:user-valid { /* declarations */ }

:user-valid to pseudoklasa bez argumentów. W HTML pasuje do elementów input, textarea i select, które podlegają walidacji ograniczeń, spełniają swoje ograniczenia i mają wewnętrzny stan user validity ustawiony na true.

:valid opisuje poprawność bez tego dodatkowego warunku. Pole z poprawną wartością początkową może więc pasować do :valid, ale nie do :user-valid. Przeciwna pseudoklasa :user-invalid oznacza niepoprawność po spełnieniu warunku interakcji; brak dopasowania do niej nie oznacza dopasowania do :user-valid.

Nie zakładaj, że samo ustawienie fokusu lub przypisanie .value uruchomi ten stan. Szczegółowy moment reakcji podczas edycji może zależeć od przeglądarki. Próba wysłania formularza zapewnia wyraźny punkt sprawdzenia, a reset usuwa stan interakcji.

Przykład zaczyna od poprawnej wartości Ada. Naciśnij Submit bez edycji, a potem Reset. Skrypt zapobiega nawigacji, nie zastępuje walidacji. Tekst obok pola uzupełnia kolor obramowania; sam selektor jedynie styluje stan i nie sprawdza danych na serwerze.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:user-valid demo</title>
<style>
  input { border: 2px solid #666; padding: 0.4rem; }
  input:user-valid { border-color: #087a35; }
  .status::after { content: "Not user-valid"; }
  input:user-valid + .status::after { content: "User-valid"; }
</style>
<form id="demo">
  <label for="name">Name (required)</label>
  <input id="name" name="name" required value="Ada">
  <span class="status" aria-live="polite"></span>
  <button type="submit">Submit</button>
  <button type="reset">Reset</button>
</form>
<script>
  document.querySelector('#demo').addEventListener('submit', (event) => {
    event.preventDefault();
  });
</script>
</html>

Wynik

Initially: Not user-valid; gray border.
After Submit without editing: User-valid; green border.
After Reset: Not user-valid; gray border.

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła