Spec-Zone.ru › Web APIs

ElementInternals: метод reportValidity()

Базовая версия 2023
Новое

С марта 2023 года эта функция работает на последних устройствах и версиях браузеров. Эта функция может не работать на старых устройствах или браузерах.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Метод reportValidity() интерфейса ElementInternals проверяет, соответствует ли элемент правилам проверки ограничений, применённым к нему.

Если reportValidity возвращает false, то на элементе срабатывает отменяемое событие invalid.

Этот метод работает аналогично методу ElementInternals.checkValidity(), но дополнительно отправляет значение ElementInternals.validationMessage в пользовательский агент для отображения.

Синтаксис

reportValidity()

Параметры

Нет.

Возвращаемое значение

Булево значение, true если элемент удовлетворяет всем ограничениям валидации.

Исключения

NotSupportedError DOMException

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

Примеры

В следующем примере используется ElementInternals.setValidity(), чтобы указать, что элемент не соответствует правилам валидации. Вызов reportValidity() возвращает false, и значение "my message" отправляется в пользовательский агент для отображения.

После повторного вызова setValidity, на этот раз указав, что все правила помечены как false, reportValidity() возвращает true.

let element = document.getElementById("join-checkbox");
element.internals_.setValidity({ valueMissing: true }, "my message");
console.log(element.internals_.reportValidity()); // false
element.internals_.setValidity({});
console.log(element.internals_.reportValidity()); // true

Спецификации

Спецификация
HTML
# dom-elementinternals-reportvalidity

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
reportValidity 77 79 98 64 16.4 77 98 55 16.4 12.0 77

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/reportValidity

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API