Spec-Zone.ru › Web APIs

HTMLOutputElement: метод setCustomValidity()

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

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

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

Метод setCustomValidity() интерфейса HTMLOutputElement устанавливает пользовательское сообщение об ошибке валидации для элемента <output>. Используйте пустую строку, чтобы указать, что у элемента нет пользовательской ошибки валидации.

Элемент <output> не участвует в проверке ограничений. Метод reportValidity() не выведет пользовательское сообщение об ошибке, но установит свойство customError объекта ValidityState элемента в значение true и свойство valid в значение false.

Синтаксис

setCustomValidity(string)

Параметры

string

Строка, содержащая сообщение об ошибке. Пустая строка удаляет любые пользовательские ошибки валидации.

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

Ничего (undefined).

Примеры

В этом примере, если значение value элемента <output> не является ненулевым числом, мы устанавливаем пользовательское сообщение об ошибке. Если это число, мы устанавливаем пользовательскую ошибку в пустую строку:

const cart = document.getElementById("cart-form");
const total = cart.elements("total");
if (parseFloat(total.value)) {
  errorOutput.setCustomValidity("");
} else {
  errorOutput.setCustomValidity("There is an error");
}

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

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

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
setCustomValidity
9Этот метод обновляет только всплывающее окно с ошибкой валидации, а не подсказку, которая появляется при наведении курсора на элемент, см. ошибку 41380670.
14 4 ≤12.1 5.1
18Этот метод обновляет только всплывающее окно с ошибкой валидации, а не подсказку, которая появляется при наведении курсора на элемент, см. ошибку 41380670.
4 ≤12.1 5
1.0Этот метод обновляет только всплывающее окно с ошибкой валидации, а не подсказку, которая появляется при наведении курсора на элемент, см. ошибку 41380670.
3

См. также

  • <output>
  • HTMLOutputElement
  • HTMLOutputElement.validity
  • HTMLOutputElement.checkValidity()
  • HTMLOutputElement.reportValidity()
  • Проверка форм.
  • Практическое руководство: проверка форм на стороне клиента
  • Руководство: проверка ограничений
  • Псевдоклассы 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/HTMLOutputElement/setCustomValidity

Spec-Zone.ru

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