База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / CSS

:user-invalid — невалидни полета след взаимодействие

Псевдокласът :user-invalid избира невалидни контроли на формуляр едва след взаимодействие, което оправдава показването на грешка, например опит за изпращане на формуляра. Така се избягва непокътнатите полета да бъдат отбелязани като грешни веднага при отваряне на страницата.

Версия: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Синтаксис

:user-invalid

:user-invalid е псевдоклас без аргументи. В HTML той съвпада с елементи input, textarea и select, които подлежат на проверка на ограниченията, не изпълняват тези ограничения и чието вътрешно състояние user validity е зададено на true. Името на това състояние не означава, че стойността е валидна.

За разлика от :invalid, той отчита историята на взаимодействията: празно поле с required може да е невалидно при зареждането, без все още да съвпада с :user-invalid. Опитът за изпращане на формуляра е важен момент за показване на грешки; все пак не приемайте, че само получаването и загубата на фокус винаги са достатъчни. Подробностите за по-ранното задействане зависят от правилата на HTML и от браузъра.

Всеки елемент, който съвпада с :user-invalid, съвпада и с :invalid. За разлика от него, :user-valid се отнася до валидни данни след подходящо взаимодействие; той не е просто отрицанието на :user-invalid, защото непокътнато поле може да не съвпада с нито един от двата псевдокласа.

Примерът съчетава рамка с текст за грешка, вместо да разчита само на цвета. CSS реагира на състоянието на проверката, но сам не определя ограниченията и не заменя проверката на данните на сървъра.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници