The HTMLOutputElement
interface provides properties and methods (beyond those inherited from HTMLElement
) for manipulating the layout and presentation of <output>
elements.
This interface also inherits properties from its parent, HTMLElement
.
HTMLOutputElement.defaultValue
DOMString
representing the default value of the element, initially the empty string.HTMLOutputElement.form
Read only
HTMLFormElement
indicating the form associated with the control, reflecting the form
HTML attribute if it is defined.HTMLOutputElement.htmlFor
Read only
DOMTokenList
reflecting the for
HTML attribute, containing a list of IDs of other elements in the same document that contribute to (or otherwise affect) the calculated value
.HTMLOutputElement.labels
Read only
NodeList
of <label>
elements associated with the element.HTMLOutputElement.name
DOMString
reflecting the name
HTML attribute, containing the name for the control that is submitted with form data.HTMLOutputElement.type
Read only
DOMString
"output"
.HTMLOutputElement.validationMessage
Read only
DOMString
representing a localized message that describes the validation constraints that the control does not satisfy (if any). This is the empty string if the control is not a candidate for constraint validation (willValidate
is false
), or it satisfies its constraints.HTMLOutputElement.validity
Read only
ValidityState
representing the validity states that this element is in.HTMLOutputElement.value
DOMString
representing the value of the contents of the elements. Behaves like the Node.textContent
property.HTMLOutputElement.willValidate
Read only
Boolean
indicating whether the element is a candidate for constraint validation.This interface also inherits methods from its parent, HTMLElement
.
HTMLOutputElement.checkValidity()
Boolean
holding the check result.HTMLOutputElement.reportValidity()
invalid
event and evaluates its result. if the result is true
, then the problems with the constraints of this element are reported to the user. When the problem is reported, the user agent may focus the element and change the scrolling position of the document or perform some other action that brings the element to the user's attention. User agents may report more than one constraint violation if this element suffers from multiple problems at once. If the element is not rendered, then the user agent may report the error for the running script instead of notifying the user.HTMLOutputElement.setCustomValidity()
This element behaves in one of two modes: default mode and value mode.
Initially, the element is in default mode, and so the contents of the element represent both the value of the element and its default value.
If the element is in default mode when the descendants of the element are changed in any way, the defaultValue
property is set to the value of the textContent
property.
Resetting the form puts the element into default mode, and sets the textContent
property to the value of the defaultValue
property.
The element goes into value mode when the contents of the value
property are set. The value
property otherwise behaves like the textContent
property. When the element is in value mode, the default value is accessible only through the defaultValue
property.
Specification | Status | Comment |
---|---|---|
HTML Living Standard The definition of 'HTMLOutputElement' in that specification. | Living Standard | No change |
HTML 5.1 The definition of 'HTMLOutputElement' in that specification. | Recommendation | No change |
HTML5 The definition of 'HTMLOutputElement' in that specification. | Recommendation | Initial definition |
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | 4.0 (2.0) | No support | (Yes) | 5.1 |
labels | (Yes) | No support | 56 (56)[1] | ? | ? | ? |
Feature | Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | 4.0 (2.0) | (Yes) | (Yes) | No support |
labels | (Yes) | No support | 56.0 (56)[1] | ? | ? | No support |
[1] Implemented in bug 556743.
<output>
.
© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLOutputElement