Get to know MDN better
このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2016年8月以降、すべてのブラウザーで利用可能です。
* この機能の一部は、対応レベルが異なる場合があります。
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 読取専用文字列で、(もしあれば)制約検証でコントロールが合格しなかった場合のローカライズされたメッセージを表現します。この属性はコントロールが制約検証の対象にならない場合(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 プロパティからしかアクセスできません。
| HTML # htmloutputelement |
ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。
より良いインターネットのための青写真。
このコンテンツの一部は、©1998–2026 個人の mozilla.org 協力者です。コンテンツはクリエイティブ・コモンズ・ライセンスのもとで利用できます。