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

CKTIS / JavaScript

ValidityState: обща валидност и причини за грешки

Използвай `element.validity`, за да различиш валидно поле от липсваща задължителна стойност, неправилен формат или твърде кратка стойност, въведена от потребителя.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;

element.validity връща обект ValidityState за елемент на формуляр. Булевите му свойства са само за четене и отразяват текущото състояние: запазената препратка не е моментна снимка. Това е API на уеб платформата, а не част от ECMAScript.

valid е true само ако няма активен флаг за грешка, включително флагове, които не са разгледани тук, като customError. Няколко флага могат едновременно да са true. valueMissing е true, когато липсва стойност, изисквана от required, например при празно задължително поле за имейл.

typeMismatch е true, ако непразна стойност не отговаря на правилата за синтаксис на HTML за type="email" или type="url". При имейл multiple позволява списък с адреси, разделени със запетаи. Празно задължително поле за имейл има valueMissing, а не typeMismatch. Проверката на синтаксиса не потвърждава, че адресът съществува.

tooShort е true, когато minlength се прилага за input или textarea, флагът за промяна на стойността (dirty value flag) е активен, последната промяна на стойността е направена от потребителя и непразната стойност, достъпна чрез API, има по-малко кодови единици UTF-16 от минимума. Само minlength не прави полето задължително. Присвояването на .value не предизвиква тази грешка, дори след извикване на checkValidity() или reportValidity().

Използвай valid, за да провериш общото състояние на полето, а флаговете за грешки — за да избереш подходящо съобщение. Проверявай изпратените данни и на сървъра: проверката в браузъра може да бъде заобиколена.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ValidityState example</title>
</head>
<body>
  <label for="email">Email:</label>
  <input id="email" type="email" required minlength="8" autocomplete="off">
  <button type="button">Next</button>

  <script>
    (() => {
      const input = document.getElementById('email');
      const state = input.validity;
      const log = (step) => console.log([
        step, state.valid, state.valueMissing, state.typeMismatch, state.tooShort
      ].join(' '));

      input.value = '';
      log('empty');
      input.value = 'not-an-email';
      log('wrong-format');
      input.value = 'a@b.co';
      log('scripted-short');

      input.value = '';
      input.addEventListener('change', () => log('user-short'), { once: true });
    })();
  </script>
</body>
</html>

Резултат

empty false true false false
wrong-format false false true false
scripted-short true false false false
user-short false false false true

Отвори примера като HTML страница в браузър и виж изхода в конзолата на браузъра. След първите три реда напиши `a@b.co` в полето и натисни Tab. След етикета на стъпката идват `valid`, `valueMissing`, `typeMismatch` и `tooShort` в този ред. Един и същ адрес от шест кодови единици е синтактично валиден и в двата случая, но нарушава `minLength = 8` само след ръчно въвеждане.

Свързани уроци

  • JavaScript · Урок 22 · Средно · Версия: 3

Източници