ElementInternals: метод reportValidity()
Базовая версия 2023
Новое
С марта 2023 года эта функция работает на последних устройствах и версиях браузеров. Эта функция может не работать на старых устройствах или браузерах.
Метод reportValidity() интерфейса ElementInternals проверяет, соответствует ли элемент правилам проверки ограничений, применённым к нему.
Если reportValidity возвращает false, то на элементе срабатывает отменяемое событие invalid.
Этот метод работает аналогично методу ElementInternals.checkValidity(), но дополнительно отправляет значение ElementInternals.validationMessage в пользовательский агент для отображения.
Синтаксис
reportValidity()
Параметры
Нет.
Возвращаемое значение
Булево значение, true если элемент удовлетворяет всем ограничениям валидации.
Исключения
-
NotSupportedErrorDOMException -
Выбрасывается, если у элемента свойство
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