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> 要素のレイアウトや表示を操作するためのプロパティやメソッドを提供します。

EventTarget Node Element HTMLElement HTMLOutputElement

インスタンスプロパティ

このインターフェイスには、親である HTMLElement から継承したプロパティがあります。

HTMLOutputElement.defaultValue

文字列で、要素の既定値を表します。初期値は空文字列です。

HTMLOutputElement.form 読取専用

HTMLFormElement で、コントロールに関連付けられたフォームを表し、定義されていれば HTML の form 属性を反映します。

HTMLOutputElement.htmlFor 読取専用

DOMTokenList で、HTML の for 要素を反映し、計算値の value に寄与する(または他の形で影響する)同じ文書内の他の要素の ID のリストが入ります。

HTMLOutputElement.labels 読取専用

NodeList で、この要素に関連付けられた <label> 要素です。

HTMLOutputElement.name

文字列で、 HTML の name 属性を反映し、フォームデータと共に送信されるコントロールの名前が入ります。

HTMLOutputElement.type 読取専用

文字列で "output" です。

HTMLOutputElement.validationMessage 読取専用

文字列で、(もしあれば)制約検証でコントロールが合格しなかった場合のローカライズされたメッセージを表現します。この属性はコントロールが制約検証の対象にならない場合(willValidatefalse の場合)や、制約を満たしている場合は空文字列になります。

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>