HTMLOutputElement

HTMLOutputElement インターフェイスは、<output> 要素のレイアウトと表示を操作するためのプロパティとメソッドを (HTMLElement から継承したものを介して) 提供します。

プロパティ

このインターフェイスは、親の HTMLElement からプロパティを継承しています。

HTMLOutputElement.defaultValue
DOMString representing the default value of the element, initially the empty string.
HTMLOutputElement.form読取専用
An HTMLFormElement indicating the form associated with the control, reflecting the form HTML attribute if it is defined.
HTMLOutputElement.htmlFor読取専用
A 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読取専用
A 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読取専用
The 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
A DOMString representing the value of the contents of the elements. Behaves like the Node.textContent property.
HTMLOutputElement.willValidate読取専用
A Boolean indicating 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 Boolean holding 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 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 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 の定義
勧告 初期定義

ブラウザの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
HTMLOutputElementChrome 完全対応 ありEdge 完全対応 ありFirefox 完全対応 4IE 未対応 なしOpera 完全対応 ありSafari 完全対応 5WebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 未対応 なしSamsung Internet Android 完全対応 あり
defaultValueChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 4IE 未対応 なしOpera 完全対応 ありSafari 完全対応 5WebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 未対応 なしSamsung Internet Android 完全対応 あり
formChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 4IE 未対応 なしOpera 完全対応 ありSafari 完全対応 5WebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 未対応 なしSamsung Internet Android 完全対応 あり
htmlForChrome 完全対応 あり
補足
完全対応 あり
補足
補足 Before Chrome 50, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList.
Edge 完全対応 14Firefox 完全対応 4IE 未対応 なしOpera 完全対応 あり
補足
完全対応 あり
補足
補足 Before Opera 37, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList.
Safari 完全対応 5WebView Android 完全対応 あり
補足
完全対応 あり
補足
補足 Before Chrome 50, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList.
Chrome Android 完全対応 あり
補足
完全対応 あり
補足
補足 Before Chrome 50, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList.
Firefox Android 完全対応 4Opera Android 完全対応 あり
補足
完全対応 あり
補足
補足 Before Opera 37, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList.
Safari iOS 未対応 なしSamsung Internet Android 完全対応 あり
labelsChrome 完全対応 ありEdge 完全対応 18Firefox 完全対応 56IE 未対応 なしOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 56Opera Android ? Safari iOS 未対応 なしSamsung Internet Android 完全対応 あり
nameChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 4IE 未対応 なしOpera 完全対応 ありSafari 完全対応 5WebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 未対応 なしSamsung Internet Android 完全対応 あり
typeChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 4IE 未対応 なしOpera 完全対応 ありSafari 完全対応 5WebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 未対応 なしSamsung Internet Android 完全対応 あり
validationMessageChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 4IE 未対応 なしOpera 完全対応 ありSafari 完全対応 5WebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 未対応 なしSamsung Internet Android 完全対応 あり
validityChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 4IE 未対応 なしOpera 完全対応 ありSafari 完全対応 5WebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 未対応 なしSamsung Internet Android 完全対応 あり
valueChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 4IE 未対応 なしOpera 完全対応 ありSafari 完全対応 5WebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 未対応 なしSamsung Internet Android 完全対応 あり
willValidateChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 4IE 未対応 なしOpera 完全対応 ありSafari 完全対応 5WebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 未対応 なしSamsung Internet Android 完全対応 あり
checkValidityChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 4IE 未対応 なしOpera 完全対応 ありSafari 完全対応 5WebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 未対応 なしSamsung Internet Android 完全対応 あり
reportValidityChrome 完全対応 40Edge 完全対応 14Firefox 完全対応 4IE 未対応 なしOpera 完全対応 27Safari 完全対応 5WebView Android 完全対応 40Chrome Android 完全対応 40Firefox Android 完全対応 4Opera Android 完全対応 27Safari iOS 未対応 なしSamsung Internet Android 完全対応 4.0
setCustomValidityChrome 完全対応 ありEdge 完全対応 14Firefox 完全対応 4IE 未対応 なしOpera 完全対応 ありSafari 完全対応 5WebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 未対応 なしSamsung Internet Android 完全対応 あり

凡例

完全対応  
完全対応
未対応  
未対応
実装状況不明  
実装状況不明
実装ノートを参照してください。
実装ノートを参照してください。

あわせて参照

  • The HTML element implementing this interface: <output>.

ドキュメントのタグと貢献者

このページの貢献者: silverskyvicto, mdnwebdocs-bot, fscholz, jsx, ethertank
最終更新者: silverskyvicto,