From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/htmloutputelement/index.html | 114 ++++++++++++++++++++++++++ 1 file changed, 114 insertions(+) create mode 100644 files/ja/web/api/htmloutputelement/index.html (limited to 'files/ja/web/api/htmloutputelement') diff --git a/files/ja/web/api/htmloutputelement/index.html b/files/ja/web/api/htmloutputelement/index.html new file mode 100644 index 0000000000..83a546ae61 --- /dev/null +++ b/files/ja/web/api/htmloutputelement/index.html @@ -0,0 +1,114 @@ +--- +title: HTMLOutputElement +slug: Web/API/HTMLOutputElement +tags: + - API + - HTML DOM + - Interface + - Reference + - インターフェイス +translation_of: Web/API/HTMLOutputElement +--- +
{{APIRef("HTML DOM")}}
+ +

HTMLOutputElement インターフェイスは、 ({{domxref("HTMLElement")}} から継承したものより詳細に) {{HTMLElement("output")}} 要素のレイアウトと表示を操作するためのプロパティやメソッドを提供します。

+ +

{{InheritanceDiagram(600, 120)}}

+ +

プロパティ

+ +

このインターフェイスは、親である {{domxref("HTMLElement")}} からプロパティを継承しています。

+ +
+
{{domxref("HTMLOutputElement.defaultValue")}}
+
{{domxref("DOMString")}} で、要素の既定値を表し、初期値は空文字列です。
+
{{domxref("HTMLOutputElement.form")}}{{ReadOnlyInline}}
+
{{domxref("HTMLFormElement")}} で、コントロールに関連付けられたフォームを表し、定義されていれば HTML の {{htmlattrxref("form", "output")}} 属性を反映します。
+
{{domxref("HTMLOutputElement.htmlFor")}}{{ReadOnlyInline}}
+
{{domxref("DOMTokenList")}} で、 HTML の {{htmlattrxref("for", "output")}} 要素を反映し、計算値の value に貢献 (または他の形で影響) する同じ文書内の他の要素の ID のリストが入ります。
+
{{domxref("HTMLOutputElement.labels")}}{{ReadOnlyInline}}
+
{{domxref("NodeList")}} で、この要素に関連付けられた {{HTMLElement("label")}} 要素です。
+
{{domxref("HTMLOutputElement.name")}}
+
{{domxref("DOMString")}} で、 HTML の {{htmlattrxref("name", "output")}} 属性を反映し、フォームデータと共に送信されるコントロールの名前が入ります。
+
{{domxref("HTMLOutputElement.type")}}{{ReadOnlyInline}}
+
{{domxref("DOMString")}} で "output" です。
+
{{domxref("HTMLOutputElement.validationMessage")}}{{ReadOnlyInline}}
+
{{domxref("DOMString")}} で、 (もしあれば) 制約検証でコントロールが合格しなかった場合のローカライズされたメッセージを表現します。この属性はコントロールが制約検証の対象にならない場合 (willValidate が false の場合) や、制約を満たしている場合は空文字列になります。
+
{{domxref("HTMLOutputElement.validity")}}{{ReadOnlyInline}}
+
{{domxref("ValidityState")}} で、この要素がある妥当性の状態を表します。
+
{{domxref("HTMLOutputElement.value")}}
+
{{domxref("DOMString")}} で、要素の内容の値を表します。 {{domxref("Node.textContent")}} プロパティと同様です。
+
{{domxref("HTMLOutputElement.willValidate")}}{{ReadOnlyInline}}
+
{{jsxref("Boolean")}} で、要素が制約検証の対象になるかどうかを示します。
+
+ +

メソッド

+ +

このインターフェイスは、親である {{domxref("HTMLElement")}} からメソッドを継承しています。

+ +
+
{{domxref("HTMLOutputElement.checkValidity()")}}
+
要素の妥当性をチェックし、チェック結果を {{jsxref("Boolean")}} で返します。
+
{{domxref("HTMLOutputElement.reportValidity()")}}
+
このメソッドは、もしあれば、要素の制約に関する問題をユーザーに報告します。問題があれば、要素上で {{domxref("HTMLInputElement/invalid_event", "invalid")}} イベントを発生させ、 false を返します。問題がなければ true を返します。
+
問題が報告された場合、ユーザーエージェントは要素にフォーカスを移し、文書のスクロール位置を変更したり、他の動作を行ったりして要素にユーザーの関心を集めることがあります。この要素に複数の問題が同時に発生した場合、ユーザーエージェントは複数の制約検証を報告することがあります。要素が表示されない場合、ユーザーエージェントはユーザーに通知する代わりに実行中のスクリプトにエラーを報告することがあります。
+
{{domxref("HTMLOutputElement.setCustomValidity()")}}
+
独自の検証メッセージをフィールドセットに設定します。メッセージが空文字列でなければ、フィールドセットには独自の検証エラーが発生している状態であり、検証に合格していません。
+
+ +

モード

+ +

この要素は2つのモードのどちらかで動作します。既定モードと値モードです。

+ +

既定モード

+ +

最初は、要素は既定モードであり、要素の中身は要素の値と既定値の両方を表します。

+ +

要素が既定モードである場合、何らかの形で要素の子孫が変更されたとき、 defaultValue プロパティは {{domxref("Node.textContent","textContent")}} プロパティの値が設定されます。

+ +

フォームをリセットすると、要素は既定モードになり、 {{domxref("Node.textContent","textContent")}} プロパティに defaultValue プロパティの値が設定されます。

+ +

値モード

+ +

要素は value プロパティの内容が設定されたときに、値モードへと移行します。 value プロパティはそれ以外は {{domxref("Node.textContent","textContent")}} プロパティと同様の動作をします。要素が値モードである場合、既定値には defaultValue プロパティからしかアクセスできません。

+ +

仕様書

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('HTML WHATWG', "#htmloutputelement", "HTMLOutputElement")}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5.1', "forms.html#the-output-element", "HTMLOutputElement")}}{{Spec2('HTML5.1')}}変更なし
{{SpecName('HTML5 W3C', "forms.html#the-output-element", "HTMLOutputElement")}}{{Spec2('HTML5 W3C')}}初回定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.HTMLOutputElement")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf