Spec-Zone.ru › Web APIs

HTMLOutputElement

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

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

* Некоторые части этой функции могут иметь различный уровень поддержки.

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

Интерфейс HTMLOutputElement предоставляет свойства и методы (помимо унаследованных от HTMLElement) для управления макетом и представлением элементов <output>.

EventTarget Node Element HTMLElement HTMLOutputElement

Свойства экземпляра

Этот интерфейс также наследует свойства от своего родителя, HTMLElement.

HTMLOutputElement.defaultValue

Строка, представляющая значение по умолчанию элемента, по умолчанию пустая строка.

HTMLOutputElement.form Только для чтения

Объект HTMLFormElement, указывающий форму, связанную с элементом управления, отражающий атрибут HTML form, если он определён.

HTMLOutputElement.htmlFor Только для чтения

DOMTokenList, отражающий атрибут HTML for, содержащий список идентификаторов других элементов в том же документе, которые влияют на вычисленное значение value.

HTMLOutputElement.labels Только для чтения

NodeList элементов <label>, связанных с элементом.

HTMLOutputElement.name

Строка, отражающая атрибут HTML name, содержащая имя для элемента управления, которое отправляется с данными формы.

HTMLOutputElement.type Только для чтения

Строка "output".

HTMLOutputElement.validationMessage Только для чтения

Строка, представляющая локализованное сообщение, описывающее ограничения проверки, которым элемент не удовлетворяет (если таковые имеются). Это пустая строка, если элемент не является кандидатом для проверки ограничений (willValidate является false), или он удовлетворяет своим ограничениям.

HTMLOutputElement.validity Только для чтения

ValidityState, представляющий состояния валидности, в которых находится этот элемент.

HTMLOutputElement.value

Строка, представляющая значение содержимого элементов. Ведёт себя как свойство Node.textContent.

HTMLOutputElement.willValidate Только для чтения

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

Методы экземпляра

Этот интерфейс также наследует методы от своего родителя, HTMLElement.

HTMLOutputElement.checkValidity()

Проверяет валидность элемента и возвращает булево значение, содержащее результат проверки.

HTMLOutputElement.reportValidity()

Этот метод сообщает пользователю о проблемах с ограничениями элемента, если таковые имеются. Если есть проблемы, генерирует событие invalid в элементе и возвращает false; если проблем нет, возвращает true.

При сообщении о проблеме пользовательский агент может сфокусировать элемент и изменить положение прокрутки документа или выполнить другое действие, которое обратит внимание пользователя на элемент. Пользовательские агенты могут сообщать о более чем одной ошибке нарушения ограничения, если этот элемент имеет сразу несколько проблем. Если элемент не отображается, пользовательский агент может сообщить об ошибке для выполняемого скрипта вместо уведомления пользователя.

HTMLOutputElement.setCustomValidity()

Устанавливает пользовательское сообщение валидности для элемента. Если это сообщение не пустая строка, элемент имеет ошибку пользовательской валидности и не проходит проверку.

Режимы

Этот элемент работает в одном из двух режимов: режим по умолчанию и режим значение.

Режим по умолчанию

Изначально элемент находится в режиме по умолчанию, и содержимое элемента представляет собой как значение элемента, так и его значение по умолчанию.

Если элемент находится в режиме по умолчанию при изменении потомков элемента каким-либо образом, свойство defaultValue устанавливается в значение свойства textContent.

Сброс формы переводит элемент в режим по умолчанию и устанавливает свойство textContent в значение свойства defaultValue.

Режим значения

Элемент переходит в режим значения, когда содержимое свойства value устанавливается. Свойство value в противном случае ведёт себя как свойство textContent. Когда элемент находится в режиме значения, значение по умолчанию доступно только через свойство defaultValue.

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

Спецификация
HTML
# htmloutputelement

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
HTMLOutputElement Нет Нет Нет Нет 15 Нет Нет Нет 15 Нет Нет
HTMLOutputElement 9 14 4 ≤12.1 5.1 18 4 ≤12.1 5 1.0 3
checkValidity 9 14 4 ≤12.1 5.1 18 4 ≤12.1 5 1.0 3
defaultValue 9 14 4 ≤12.1 5.1 18 4 ≤12.1 5 1.0 3
form 9 14 4 ≤12.1 5.1 18 4 ≤12.1 5 1.0 3
htmlFor
9До Chrome 50 эта свойство возвращало устаревённое свойство DOMSettableTokenList вместо DOMTokenList.
14 4
15До Opera 37 эта свойство возвращало устаревённое свойство DOMSettableTokenList вместо DOMTokenList.
5.1
18До Chrome Android 50 эта свойство возвращало устаревённое свойство DOMSettableTokenList вместо DOMTokenList.
4
14До Opera Android 37 эта свойство возвращало устаревённое свойство DOMSettableTokenList вместо DOMTokenList.
5
1.0До Samsung Internet 5.0 эта свойство возвращало устаревённое свойство DOMSettableTokenList вместо DOMTokenList.
3До Chrome 50 эта свойство возвращало устаревённое свойство DOMSettableTokenList вместо DOMTokenList.
labels 9 18 56 ≤12.1 5.1 18 56 ≤12.1 5 1.0 3
name 9 14 4 ≤12.1 5.1 18 4 ≤12.1 5 1.0 3
reportValidity 40 14 49 27 10.1 40 49 27 10.3 4.0 40
setCustomValidity
9Этот метод обновляет только всплывающее окно с ошибкой валидации, а не всплывающую подсказку при наведении курсора на элемент, см. ошибка 41380670.
14 4 ≤12.1 5.1
18Этот метод обновляет только всплывающее окно с ошибкой валидации, а не всплывающую подсказку при наведении курсора на элемент, см. ошибка 41380670.
4 ≤12.1 5
1.0Этот метод обновляет только всплывающее окно с ошибкой валидации, а не всплывающую подсказку при наведении курсора на элемент, см. ошибка 41380670.
3
type 9 14 4 15 5.1 18 4 14 5 1.0 3
validationMessage 9 14 4 ≤12.1 5.1 18 4 ≤12.1 5 1.0 3
validity 9 14 4 ≤12.1 5.1 18 4 ≤12.1 5 1.0 3
value 9 14 4 ≤12.1 5.1 18 4 ≤12.1 5 1.0 3
willValidate 9 14 4 ≤12.1 5.1 18 4 ≤12.1 5 1.0 3

См. также

  • Элемент HTML, реализующий этот интерфейс: <output>.

© 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

Spec-Zone.ru

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