HTMLOutputElement
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2018.
HTMLOutputElement
インターフェイスは、(HTMLElement
から継承したもの以外に)<output>
要素のレイアウトや表示を操作するためのプロパティやメソッドを提供します。
インスタンスプロパティ
このインターフェイスには、親である HTMLElement
から継承したプロパティがあります。
HTMLOutputElement.defaultValue
-
文字列で、要素の既定値を表します。初期値は空文字列です。
HTMLOutputElement.form
読取専用-
HTMLFormElement
で、コントロールに関連付けられたフォームを表し、定義されていれば HTML のform
属性を反映します。 HTMLOutputElement.htmlFor
読取専用-
DOMTokenList
で、HTML のfor
要素を反映し、計算値のvalue
に寄与する(または他の形で影響する)同じ文書内の他の要素の ID のリストが入ります。 HTMLOutputElement.labels
読取専用HTMLOutputElement.name
-
文字列で、 HTML の
name
属性を反映し、フォームデータと共に送信されるコントロールの名前が入ります。 HTMLOutputElement.type
読取専用-
文字列で "
output
" です。 HTMLOutputElement.validationMessage
読取専用-
文字列で、(もしあれば)制約検証でコントロールが合格しなかった場合のローカライズされたメッセージを表現します。この属性はコントロールが制約検証の対象にならない場合(
willValidate
がfalse
の場合)や、制約を満たしている場合は空文字列になります。 HTMLOutputElement.validity
読取専用-
ValidityState
で、この要素がある妥当性の状態を表します。 HTMLOutputElement.value
-
文字列で、要素の内容の値を表します。
Node.textContent
プロパティと同様です。 HTMLOutputElement.willValidate
読取専用-
論理値で、要素が制約検証の対象になるかどうかを示します。
インスタンスメソッド
このインターフェイスには、親である HTMLElement
から継承したメソッドもあります。
HTMLOutputElement.checkValidity()
-
要素の妥当性をチェックし、チェック結果を論理値で返します。
HTMLOutputElement.reportValidity()
-
このメソッドは、もしあれば、要素の制約に関する問題をユーザーに報告します。問題があれば、要素上で
invalid
イベントを発生させ、false
を返します。問題がなければtrue
を返します。問題が報告された場合、ユーザーエージェントは要素にフォーカスを移し、文書のスクロール位置を変更したり、他の動作を行ったりして要素にユーザーの関心を集めることがあります。この要素に複数の問題が同時に発生した場合、ユーザーエージェントは複数の制約検証を報告することがあります。要素が表示されない場合、ユーザーエージェントはユーザーに通知する代わりに実行中のスクリプトにエラーを報告することがあります。
HTMLOutputElement.setCustomValidity()
-
独自の検証メッセージをこの要素に設定します。メッセージが空文字列でなければ、この要素は独自の検証エラーが発生している状態であり、検証に合格していません。
モード
この要素は 2 つのモードのどちらかで動作します。既定モードと値モードです。
既定モード
初期状態では、要素は既定モードになっており、要素のコンテンツは要素の値と既定値の両方を表します。
要素が既定モードである場合、何らかの形で要素の子孫が変更されたとき、defaultValue
プロパティは textContent
プロパティの値が設定されます。
フォームをリセットすると、要素は既定モードになり、textContent
プロパティに defaultValue
プロパティの値が設定されます。
値モード
要素は value
プロパティの内容が設定されたときに、値モードへと移行します。 value
プロパティはそれ以外は textContent
プロパティと同様の動作をします。要素が値モードである場合、既定値には defaultValue
プロパティからしかアクセスできません。
仕様書
Specification |
---|
HTML Standard # htmloutputelement |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
- このインターフェイスを実装している HTML 要素:
<output>