Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / CSS

:user-invalid — neplatné polia po interakcii

Pseudotrieda :user-invalid vyberá neplatné ovládacie prvky formulára až po interakcii, ktorá odôvodňuje zobrazenie chyby, napríklad po pokuse o odoslanie formulára. Pomáha predísť tomu, aby boli nedotknuté polia označené ako chybné hneď po otvorení stránky.

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

Syntax

:user-invalid

:user-invalid je pseudotrieda bez argumentov. V HTML zodpovedá prvkom input, textarea a select, ktoré podliehajú validácii obmedzení, tieto obmedzenia nespĺňajú a ich interný stav user validity je nastavený na true. Názov tohto stavu neznamená, že hodnota je platná.

Na rozdiel od :invalid zohľadňuje históriu interakcií: prázdne pole s atribútom required môže byť pri načítaní neplatné, no ešte nemusí zodpovedať :user-invalid. Pokus o odoslanie formulára je dôležitým okamihom na odhalenie chýb; nepredpokladajte však, že vždy stačí iba získať a stratiť fokus. Podrobnosti skoršej aktivácie závisia od pravidiel HTML a prehliadača.

Každý prvok zodpovedajúci :user-invalid zodpovedá aj :invalid. :user-valid sa naopak týka platných údajov po príslušnej interakcii; nie je jednoduchým opakom :user-invalid, pretože nedotknuté pole nemusí zodpovedať ani jednej z nich.

Príklad spája orámovanie s textom chyby namiesto toho, aby sa spoliehal iba na farbu. CSS reaguje na stav validácie, samo však nedefinuje obmedzenia ani nenahrádza kontrolu údajov na serveri.

Príklady

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

Výsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje