HTMLOutputElement
interface provides properties and methods (beyond those inherited from
HTMLElement
) for manipulating the layout and presentation of
<output>
元素。
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="../API/EventTarget.html" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25 236,20 236,30 226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25 351,20 351,30 341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25 501,20 501,30 491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="../API/HTMLOutputElement" target="_top"><rect x="321" y="65" width="170" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="406" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLOutputElement</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
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
只读
HTMLFormElement
indicating the form associated with the control, reflecting the
form
HTML attribute if it is defined.
HTMLOutputElement.htmlFor
只读
DOMTokenList
反射
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
只读
NodeList
of
<label>
elements associated with the element.
HTMLOutputElement.name
DOMString
反射
名称
HTML attribute, containing the name for the control that is submitted with form data.
HTMLOutputElement.type
只读
DOMString
"
output
".
HTMLOutputElement.validationMessage
只读
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
只读
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
特性。
HTMLOutputElement.willValidate
只读
布尔
indicating whether the element is a candidate for constraint validation.
This interface also inherits methods from its parent,
HTMLElement
.
HTMLOutputElement.checkValidity()
布尔
holding the check result.
HTMLOutputElement.reportValidity()
无效
event at the element, and returns
false
; if there are no problems, it returns
true
.
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()
Sets a custom validity message for the element. If this message is not the empty string, then the element is suffering from a custom validity error, and does not validate.
This element behaves in one of two modes: default mode and value 模式。
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
特性。
Resetting the form puts the element into default mode, and sets the
textContent
property to the value of the
defaultValue
特性。
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
特性。
| 桌面 | 移动 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
HTMLOutputElement
|
Chrome Yes | Edge ≤18 | Firefox 4 | IE No | Opera Yes | Safari 5 | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android Yes | Safari iOS No | Samsung Internet Android Yes |
checkValidity
|
Chrome Yes | Edge 14 | Firefox 4 | IE No | Opera Yes | Safari 5 | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android Yes | Safari iOS No | Samsung Internet Android Yes |
defaultValue
|
Chrome Yes | Edge 14 | Firefox 4 | IE No | Opera Yes | Safari 5 | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android Yes | Safari iOS No | Samsung Internet Android Yes |
form
|
Chrome Yes | Edge 14 | Firefox 4 | IE No | Opera Yes | Safari 5 | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android Yes | Safari iOS No | Samsung Internet Android Yes |
htmlFor
|
Chrome
Yes
|
Edge 14 | Firefox 4 | IE No |
Opera
Yes
|
Safari 5 |
WebView Android
Yes
|
Chrome Android
Yes
|
Firefox Android 4 |
Opera Android
Yes
|
Safari iOS No |
Samsung Internet Android
Yes
|
labels
|
Chrome Yes | Edge 18 | Firefox 56 | IE No | Opera Yes | Safari Yes | WebView Android Yes | Chrome Android Yes | Firefox Android 56 | Opera Android ? | Safari iOS No | Samsung Internet Android Yes |
名称
|
Chrome Yes | Edge 14 | Firefox 4 | IE No | Opera Yes | Safari 5 | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android Yes | Safari iOS No | Samsung Internet Android Yes |
reportValidity
|
Chrome 40 | Edge 14 | Firefox 4 | IE No | Opera 27 | Safari 5 | WebView Android 40 | Chrome Android 40 | Firefox Android 4 | Opera Android 27 | Safari iOS No | Samsung Internet Android 4.0 |
setCustomValidity
|
Chrome Yes | Edge 14 | Firefox 4 | IE No | Opera Yes | Safari 5 | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android Yes | Safari iOS No | Samsung Internet Android Yes |
type
|
Chrome Yes | Edge 14 | Firefox 4 | IE No | Opera Yes | Safari 5 | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android Yes | Safari iOS No | Samsung Internet Android Yes |
validationMessage
|
Chrome Yes | Edge 14 | Firefox 4 | IE No | Opera Yes | Safari 5 | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android Yes | Safari iOS No | Samsung Internet Android Yes |
validity
|
Chrome Yes | Edge 14 | Firefox 4 | IE No | Opera Yes | Safari 5 | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android Yes | Safari iOS No | Samsung Internet Android Yes |
value
|
Chrome Yes | Edge 14 | Firefox 4 | IE No | Opera Yes | Safari 5 | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android Yes | Safari iOS No | Samsung Internet Android Yes |
willValidate
|
Chrome Yes | Edge 14 | Firefox 4 | IE No | Opera Yes | Safari 5 | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android Yes | Safari iOS No | Samsung Internet Android Yes |
完整支持
不支持
兼容性未知
见实现注意事项。
<output>
.
HTMLOutputElement
BeforeUnloadEvent
DOMStringMap
ErrorEvent
GlobalEventHandlers
HTMLAnchorElement
HTMLAreaElement
HTMLAudioElement
HTMLBRElement
HTMLBaseElement
HTMLBaseFontElement
HTMLBodyElement
HTMLButtonElement
HTMLCanvasElement
HTMLContentElement
HTMLDListElement
HTMLDataElement
HTMLDataListElement
HTMLDialogElement
HTMLDivElement
HTMLDocument
HTMLElement
HTMLEmbedElement
HTMLFieldSetElement
HTMLFormControlsCollection
HTMLFormElement
HTMLFrameSetElement
HTMLHRElement
HTMLHeadElement
HTMLHeadingElement
HTMLHtmlElement
HTMLIFrameElement
HTMLImageElement
HTMLInputElement
HTMLIsIndexElement
HTMLKeygenElement
HTMLLIElement
HTMLLabelElement
HTMLLegendElement
HTMLLinkElement
HTMLMapElement
HTMLMediaElement
HTMLMetaElement
HTMLMeterElement
HTMLModElement
HTMLOListElement
HTMLObjectElement
HTMLOptGroupElement
HTMLOptionElement
HTMLOptionsCollection
HTMLParagraphElement
HTMLParamElement
HTMLPictureElement
HTMLPreElement
HTMLProgressElement
HTMLQuoteElement
HTMLScriptElement
HTMLSelectElement
HTMLShadowElement
HTMLSourceElement
HTMLSpanElement
HTMLStyleElement
HTMLTableCaptionElement
HTMLTableCellElement
HTMLTableColElement
HTMLTableDataCellElement
HTMLTableElement
HTMLTableHeaderCellElement
HTMLTableRowElement
HTMLTableSectionElement
HTMLTemplateElement
HTMLTextAreaElement
HTMLTimeElement
HTMLTitleElement
HTMLTrackElement
HTMLUListElement
HTMLUnknownElement
HTMLVideoElement
HashChangeEvent
历史
ImageData
定位
MessageChannel
MessageEvent
MessagePort
Navigator
NavigatorGeolocation
NavigatorID
NavigatorLanguage
NavigatorOnLine
NavigatorPlugins
PageTransitionEvent
Plugin
PluginArray
PopStateEvent
PortCollection
PromiseRejectionEvent
RadioNodeList
Transferable
ValidityState
Window
WindowBase64
WindowEventHandlers
WindowTimers