KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

:user-invalid — ongeldige velden na interactie

De pseudoklasse :user-invalid selecteert ongeldige formulierbesturingselementen pas nadat een interactie het tonen van een fout rechtvaardigt, bijvoorbeeld een poging om het formulier te verzenden. Zo worden onaangeraakte velden niet meteen bij het openen van de pagina als fout gemarkeerd.

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

Syntax

:user-invalid

:user-invalid is een pseudoklasse zonder argumenten. In HTML komt deze overeen met input-, textarea- en select-elementen die onderhevig zijn aan constraint validation, niet aan de voorwaarden voldoen en waarvan de interne status user validity op true staat. De naam van die status betekent niet dat de waarde geldig is.

Anders dan :invalid houdt deze pseudoklasse rekening met eerdere interacties: een leeg veld met required kan bij het laden al ongeldig zijn zonder al overeen te komen met :user-invalid. Een poging het formulier te verzenden is een belangrijk moment om fouten te tonen; ga er echter niet van uit dat alleen focus krijgen en verliezen altijd voldoende is. Details over eerdere activering hangen af van de HTML-regels en de browser.

Elk element dat overeenkomt met :user-invalid komt ook overeen met :invalid. :user-valid betreft juist geldige invoer na een passende interactie; het is niet simpelweg de ontkenning van :user-invalid, want een onaangeraakt veld kan met geen van beide overeenkomen.

Het voorbeeld combineert een rand met fouttekst, in plaats van alleen op kleur te vertrouwen. CSS reageert op de validatiestatus, maar stelt zelf geen voorwaarden vast en vervangt geen gegevensvalidatie op de server.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Showing errors with :user-invalid</title>
  <style>
    input { border: 2px solid #555; }
    input:user-invalid { border-color: #b00020; }
    .error { display: none; }
    input:user-invalid + .error { display: block; }
  </style>
</head>
<body>
  <form id="demo">
    <label for="email">Email (required)</label>
    <input id="email" type="email" required aria-describedby="email-error">
    <p id="email-error" class="error">Enter a valid email address.</p>
    <button type="submit">Check</button>
    <button type="reset">Reset</button>
  </form>
  <script>
    const form = document.querySelector('#demo');
    const field = document.querySelector('#email');
    const error = document.querySelector('#email-error');

    // Keep validation local, even if the field contains a valid address.
    form.addEventListener('submit', event => event.preventDefault());
    field.addEventListener('invalid', event => event.preventDefault());

    function report(stage) {
      const visible = getComputedStyle(error).display !== 'none';
      console.log(`${stage}: :invalid=${field.matches(':invalid')}, :user-invalid=${field.matches(':user-invalid')}, error=${visible ? 'visible' : 'hidden'}`);
    }

    report('Before validation');
    form.requestSubmit();
    report('After empty submit attempt');
    form.reset();
    report('After reset');
  </script>
</body>
</html>

Resultaat

Before validation: :invalid=true, :user-invalid=false, error=hidden
After empty submit attempt: :invalid=true, :user-invalid=true, error=visible
After reset: :invalid=true, :user-invalid=false, error=hidden

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen