HTMLOutputElement
Базовая поддержка Широко доступно *
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с октября 2018 года.
* Некоторые части этой функции могут иметь различный уровень поддержки.
Интерфейс HTMLOutputElement предоставляет свойства и методы (помимо унаследованных от HTMLElement) для управления макетом и представлением элементов <output>.
Свойства экземпляра
Этот интерфейс также наследует свойства от своего родителя, HTMLElement.
HTMLOutputElement.defaultValue-
Строка, представляющая значение по умолчанию элемента, по умолчанию пустая строка.
-
HTMLOutputElement.formТолько для чтения -
Объект
HTMLFormElement, указывающий форму, связанную с элементом управления, отражающий атрибут HTMLform, если он определён. -
HTMLOutputElement.htmlForТолько для чтения -
DOMTokenList, отражающий атрибут HTMLfor, содержащий список идентификаторов других элементов в том же документе, которые влияют на вычисленное значениеvalue. -
HTMLOutputElement.labelsТолько для чтения 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