KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

:user-valid — geldig veld na interactie van de gebruiker

De pseudoklasse :user-valid selecteert geldige formuliervelden pas zodra aan de voorwaarde voor gebruikersinteractie is voldaan. Anders dan :valid geeft deze niet automatisch aan dat een onaangeroerd veld geldig is.

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

Syntax

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

:user-valid is een pseudoklasse zonder argumenten. In HTML komt deze overeen met input-, textarea- en select-elementen die in aanmerking komen voor validatie van beperkingen, aan hun beperkingen voldoen en waarvan de interne toestand user validity op true staat.

:valid beschrijft geldigheid zonder die extra voorwaarde. Een veld met een geldige beginwaarde kan daarom wel overeenkomen met :valid, maar niet met :user-valid. De tegenhanger :user-invalid geeft ongeldigheid aan nadat aan de interactievoorwaarde is voldaan; als een veld daar niet mee overeenkomt, betekent dat niet dat het wel met :user-valid overeenkomt.

Ga er niet van uit dat alleen een besturingselement focussen of .value toewijzen deze toestand activeert. Het precieze moment waarop dat tijdens het bewerken gebeurt, kan afhangen van de browser. Een poging om het formulier te verzenden biedt een duidelijk controlemoment; resetten wist de interactietoestand.

Het voorbeeld begint met de geldige waarde Ada. Klik op Submit zonder iets te wijzigen en daarna op Reset. Het script voorkomt navigatie, niet validatie. De tekst naast het veld vormt een aanvulling op de randkleur; de selector geeft alleen een toestand vorm en valideert geen gegevens op de server.

Voorbeelden

<!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>

Resultaat

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

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