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

CKTIS / JavaScript

HTMLInputElement.validity — състояние на валидност на поле за въвеждане

HTMLInputElement.validity предоставя текущото състояние на проверката на ограниченията на поле за въвеждане като обект ValidityState. Флаговете му обозначават конкретни проблеми, а valid показва дали няма зададен флаг за грешка.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

input.validity
input.validity.valid
input.validity.valueMissing

HTMLInputElement.validity е свойство само за четене, което връща жив обект ValidityState: запазена препратка отразява последващи промени в полето за въвеждане. Флаговете му също са само за четене. Този API на браузъра е дефиниран от HTML, а не от ECMAScript; наличието на Node.js само по себе си не гарантира поддръжка.

valueMissing показва липсваща задължителна стойност, typeMismatch — формат, несъответстващ на типа, а patternMismatch — несъответствие с pattern. Останалите флагове за грешка са tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput и customError. Приложимостта им зависи от типа на полето и ограниченията. valid е true, когато всички флагове за грешка са false.

Четенето на validity не показва съобщение и не задейства invalid. checkValidity() проверява контролата и може да задейства invalid; reportValidity() може допълнително да покаже проблема на потребителя. willValidate определя участието във валидирането: деактивирано поле за въвеждане все пак може да има флагове за грешка, въпреки че не участва в проверката.

setCustomValidity('Blocked') задава customError; изчистете го с setCustomValidity(''). Самото коригиране на стойността не премахва грешката. Примерът показва актуализациите чрез запазения обект state, без повторно прочитане на input.validity. Проверката в браузъра не замества проверките на данните от страна на сървъра.

Примери

const input = document.createElement('input');
input.type = 'email';
input.required = true;
const state = input.validity;

console.log(state.valueMissing, state.valid);
input.value = 'learner@example.com';
console.log(state.valueMissing, state.valid);
input.setCustomValidity('Blocked');
console.log(state.customError, state.valid);
input.setCustomValidity('');
console.log(state.customError, state.valid);

Резултат

true false
false true
true false
false true

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

Източници