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