HTMLOutputElement インターフェイスは、<output> 要素のレイアウトと表示を操作するためのプロパティとメソッドを (HTMLElement から継承したものを介して) 提供します。
<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="https://developer.mozilla.org/ja/docs/Web/API/EventTarget" 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="https://developer.mozilla.org/ja/docs/Web/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="https://developer.mozilla.org/ja/docs/Web/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="https://developer.mozilla.org/ja/docs/Web/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="https://developer.mozilla.org/ja/docs/Web/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;}
プロパティ
このインターフェイスは、親の HTMLElement からプロパティを継承しています。
HTMLOutputElement.defaultValue- A
DOMStringrepresenting the default value of the element, initially the empty string. HTMLOutputElement.form読取専用- An
HTMLFormElementindicating the form associated with the control, reflecting theformHTML attribute if it is defined. HTMLOutputElement.htmlFor読取専用- A
DOMTokenListreflecting theforHTML attribute, containing a list of IDs of other elements in the same document that contribute to (or otherwise affect) the calculatedvalue. HTMLOutputElement.labels読取専用- A
NodeListof<label>elements associated with the element. HTMLOutputElement.name- A
DOMStringreflecting thenameHTML attribute, containing the name for the control that is submitted with form data. HTMLOutputElement.type読取専用- The
DOMString"output". HTMLOutputElement.validationMessage読取専用- A
DOMStringrepresenting 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 (willValidateisfalse), or it satisfies its constraints. HTMLOutputElement.validity読取専用- A
ValidityStaterepresenting the validity states that this element is in. HTMLOutputElement.value- A
DOMStringrepresenting the value of the contents of the elements. Behaves like theNode.textContentproperty. HTMLOutputElement.willValidate読取専用- A
Booleanindicating whether the element is a candidate for constraint validation.
メソッド
This interface also inherits methods from its parent, HTMLElement.
HTMLOutputElement.checkValidity()- Checks the validity of the element and returns a
Booleanholding the check result. HTMLOutputElement.reportValidity()- This method reports the problems with the constraints on the element, if any, to the user. If there are problems, fires an invalid event at the element, and returns
false; if there are no problems, it returnstrue. - 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 mode.
Default 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.
Value mode
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.
仕様
| 仕様書 | ステータス | コメント |
|---|---|---|
| HTML Living Standard HTMLOutputElement の定義 |
現行の標準 | |
| HTML 5.1 HTMLOutputElement の定義 |
勧告 | 変更なし |
| HTML5 HTMLOutputElement の定義 |
勧告 | 初期定義 |
ブラウザの互換性
| デスクトップ | モバイル | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
HTMLOutputElement | Chrome 完全対応 あり | Edge 完全対応 あり | Firefox 完全対応 4 | IE 未対応 なし | Opera 完全対応 あり | Safari 完全対応 5 | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 あり |
checkValidity | Chrome 完全対応 あり | Edge 完全対応 14 | Firefox 完全対応 4 | IE 未対応 なし | Opera 完全対応 あり | Safari 完全対応 5 | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 あり |
defaultValue | Chrome 完全対応 あり | Edge 完全対応 14 | Firefox 完全対応 4 | IE 未対応 なし | Opera 完全対応 あり | Safari 完全対応 5 | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 あり |
form | Chrome 完全対応 あり | Edge 完全対応 14 | Firefox 完全対応 4 | IE 未対応 なし | Opera 完全対応 あり | Safari 完全対応 5 | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 あり |
htmlFor | Chrome
完全対応
あり
| Edge 完全対応 14 | Firefox 完全対応 4 | IE 未対応 なし | Opera
完全対応
あり
| Safari 完全対応 5 | WebView Android
完全対応
あり
| Chrome Android
完全対応
あり
| Firefox Android 完全対応 4 | Opera Android
完全対応
あり
| Safari iOS 未対応 なし | Samsung Internet Android 完全対応 あり |
labels | Chrome 完全対応 あり | Edge 完全対応 18 | Firefox 完全対応 56 | IE 未対応 なし | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 56 | Opera Android ? | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 あり |
name | Chrome 完全対応 あり | Edge 完全対応 14 | Firefox 完全対応 4 | IE 未対応 なし | Opera 完全対応 あり | Safari 完全対応 5 | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 あり |
reportValidity | Chrome 完全対応 40 | Edge 完全対応 14 | Firefox 完全対応 4 | IE 未対応 なし | Opera 完全対応 27 | Safari 完全対応 5 | WebView Android 完全対応 40 | Chrome Android 完全対応 40 | Firefox Android 完全対応 4 | Opera Android 完全対応 27 | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 4.0 |
setCustomValidity | Chrome 完全対応 あり | Edge 完全対応 14 | Firefox 完全対応 4 | IE 未対応 なし | Opera 完全対応 あり | Safari 完全対応 5 | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 あり |
type | Chrome 完全対応 あり | Edge 完全対応 14 | Firefox 完全対応 4 | IE 未対応 なし | Opera 完全対応 あり | Safari 完全対応 5 | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 あり |
validationMessage | Chrome 完全対応 あり | Edge 完全対応 14 | Firefox 完全対応 4 | IE 未対応 なし | Opera 完全対応 あり | Safari 完全対応 5 | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 あり |
validity | Chrome 完全対応 あり | Edge 完全対応 14 | Firefox 完全対応 4 | IE 未対応 なし | Opera 完全対応 あり | Safari 完全対応 5 | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 あり |
value | Chrome 完全対応 あり | Edge 完全対応 14 | Firefox 完全対応 4 | IE 未対応 なし | Opera 完全対応 あり | Safari 完全対応 5 | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 あり |
willValidate | Chrome 完全対応 あり | Edge 完全対応 14 | Firefox 完全対応 4 | IE 未対応 なし | Opera 完全対応 あり | Safari 完全対応 5 | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 あり |
凡例
- 完全対応
- 完全対応
- 未対応
- 未対応
- 実装状況不明
- 実装状況不明
- 実装ノートを参照してください。
- 実装ノートを参照してください。
あわせて参照
- The HTML element implementing this interface:
<output>.