ElementInternals: метод setValidity()

Метод setValidity() интерфейса ElementInternals устанавливает действительность элемента.

flags Необязательно

Объект со словарем, содержащим один или несколько флагов, указывающих состояние действительности элемента:

valueMissing

Булево значение, равное true если у элемента есть атрибут required, но нет значения, или false в противном случае. Если true, элемент соответствует псевдоклассу CSS :invalid.

typeMismatch

Булево значение, равное true если значение не соответствует требуемому синтаксису (когда type равен email или url), или false если синтаксис верен. Если true, элемент соответствует псевдоклассу CSS :invalid.

patternMismatch

Булево значение, равное true если значение не соответствует указанному pattern, и false если соответствует. Если true, элемент соответствует псевдоклассу CSS :invalid.

tooLong

Булево значение, равное true если значение превышает указанный maxlength для объектов HTMLInputElement или HTMLTextAreaElement, или false если длина меньше или равна максимальной длине. Если true, элемент соответствует псевдоклассам CSS :invalid и :out-of-range.

tooShort

Булево значение, равное true если значение не соответствует указанному minlength для объектов HTMLInputElement или HTMLTextAreaElement, или false если длина больше или равна минимальной. Если true, элемент соответствует псевдоклассам CSS :invalid и :out-of-range.

rangeUnderflow

Булево значение, равное true если значение меньше минимального, указанного в атрибуте min, или false если оно больше или равно минимальному. Если true, элемент соответствует псевдоклассам CSS :invalid и :out-of-range.

rangeOverflow

Булево значение, равное true если значение больше максимального, указанного в атрибуте max, или false если оно меньше или равно максимальному. Если true, элемент соответствует псевдоклассам CSS :invalid и :out-of-range и CSS.

stepMismatch

Булево значение, равное true если значение не соответствует правилам, определённым атрибутом step (то есть не делится нацело на значение шага), или false если соответствует правилу шага. Если true, элемент соответствует псевдоклассам CSS :invalid и :out-of-range.

badInput

Булево значение, равное true если пользователь ввёл данные, которые браузер не может преобразовать.

customError

Булево значение, указывающее, было ли сообщение об ошибке элемента установлено в непустую строку путём вызова метода элемента setCustomValidity().

Примечание: Чтобы установить все флаги в false, указывая, что этот элемент проходит проверку всех ограничений, передайте пустой объект {}. В этом случае не нужно также передавать message.

message Необязательно

Строка, содержащая сообщение, которое будет установлено, если какие-либо flags являются true. Этот параметр необязателен только если все flags являются false.

anchor Необязательно

Элемент HTMLElement, который может использоваться пользовательским агентом для сообщения о проблемах с отправкой формы.

None (undefined).

NotSupportedError DOMException

Выбрасывается, если свойство элемента formAssociated не установлено в значение true.

TypeError

Выбрасывается, если один или несколько flags имеет значение true.

NotFoundError DOMException

Выбрасывается, если anchor задано, но якорная ссылка не является потомком элемента, включающим тени.

В следующем примере setValidity вызывается с пустым параметром flags, чтобы указать, что элемент соответствует правилам проверки ограничений.

this.internals_.setValidity({});

В следующем примере setValidity вызывается с флагом valueMissing установленным в true. Тогда также должен быть передан параметр message содержащий сообщение.

this.internals_.setValidity({ valueMissing: true }, "my message");