Spec-Zone.ru › Web APIs

HTMLButtonElement: метод checkValidity()

Базовая поддержка Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с декабря 2018 года.

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

Метод checkValidity() интерфейса HTMLButtonElement возвращает логическое значение, указывающее, соответствует ли элемент правилам проверки ограничений, применённым к нему. Если значение ложно, метод также вызывает событие invalid в элементе. Поскольку для checkValidity() нет стандартного поведения браузера, отмена этого события invalid не имеет эффекта. Он всегда возвращает true, если свойство <button> элемента type имеет значение "button" или "reset", потому что такие кнопки никогда не являются кандидатами для проверки ограничений.

Примечание: Элемент HTML <button> типа "submit" с непустым validationMessage считается невалидным, соответствует псевдоклассу CSS :invalid и заставит checkValidity() вернуть false. Используйте метод HTMLButtonElement.setCustomValidity() для установки HTMLButtonElement.validationMessage в пустую строку, чтобы установить состояние validity как валидное.

Синтаксис

checkValidity()

Параметры

Нет.

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

Возвращает true , если значение элемента не имеет проблем с валидностью; в противном случае возвращает false.

Примеры

В следующем примере вызов checkValidity() возвращает либо true , либо false.

const element = document.getElementById("myButton");
console.log(element.checkValidity());

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

Спецификация
HTML
# dom-cva-checkvalidity-dev

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

Рабочие столы Мобильные
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
checkValidity 4 12 4 ≤12.1 5 18 4 ≤12.1 5 1.0 ≤37

См. также

  • HTMLButtonElement.reportValidity()
  • <button>
  • <form>
  • Обучение: Клиентская валидация форм
  • Руководство: Валидация ограничений
  • Псевдоклассы CSS :valid и :invalid

© 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/HTMLButtonElement/checkValidity

Spec-Zone.ru

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