HTMLFieldSetElement
インターフェイスは、 (HTMLElement
から継承したものより詳細に) <fieldset>
要素のレイアウトと表示を操作するための特別なプロパティやメソッドを提供します。
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25 236,20 236,30 226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25 351,20 351,30 341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25 501,20 501,30 491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/HTMLFieldSetElement" target="_top"><rect x="301" y="65" width="190" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="396" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLFieldSetElement</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
プロパティ
親である HTMLElement
からプロパティを継承しています。
HTMLFieldSetElement.disabled
-
Boolean
で、 HTML のdisabled
属性を反映し、ユーザーがこのコントロールと対話できるかどうかを示します。 HTMLFieldSetElement.elements
読取専用- このフィールドセットに所属する要素です。このプロパティの型は、ブラウザーが実装している仕様書のバージョンによって異なります。
HTMLFieldSetElement.form
読取専用-
HTMLFormControlsCollection
またはHTMLCollection
で、この要素がフォーム内にあった場合、含んでいるフォーム要素を参照します。
このフィールドセットがフォーム要素の子孫でなかった場合は、この属性は関連付けられた同じ文書内の何れかのフォームになるか、一致するものがなければnull
になります。 HTMLFieldSetElement.name
-
DOMString
で、 HTML のname
属性を反映し、フォームを送信するときに使われるフィールドセットの名前が入ります。 HTMLFieldSetElement.type
読取専用-
DOMString
で "fieldset
" です。 HTMLFieldSetElement.validationMessage
-
DOMString
で、 (もしあれば) 制約検証でコントロールが合格しなかった場合のローカライズされたメッセージを表現します。この属性はコントロールが制約検証の候補にならない場合 (willValidate
がfalse
の場合) や、制約を満たしている場合は空文字列になります。 HTMLFieldSetElement.validity
-
ValidityState
で、この要素がある妥当性の状態を表します。 HTMLFieldSetElement.willValidate
-
Boolean
でfalse
です。<fieldset>
オブジェクトは制約検証の対象になることがないからです。
メソッド
親である HTMLElement
からメソッドを継承しています。
HTMLFieldSetElement.checkValidity()
- 常に
true
を返します。<fieldset>
オブジェクトは制約検証の対象になることがないためです。 HTMLFieldSetElement.reportValidity()
- 常に
true
を返します。<fieldset>
オブジェクトは制約検証の対象になることがないためです。 HTMLFieldSetElement.setCustomValidity()
- 独自の検証メッセージをフィールドセットに設定します。メッセージが空文字列でなければ、フィールドセットには独自の検証エラーが発生している状態であり、検証に合格していません。
仕様書
仕様書 | 状態 | 備考 |
---|---|---|
HTML Living Standard HTMLFieldSetElement の定義 |
現行の標準 | |
HTML 5.1 HTMLFieldSetElement の定義 |
勧告 | |
HTML5 HTMLFieldSetElement の定義 |
勧告 | disabled , elements , name , type , valdiationMessage , validity , and willValidate プロパティが追加された。checkValidity() , setCustomValidity() メソッドが追加された。 |
Document Object Model (DOM) Level 2 HTML Specification HTMLFieldSetElement の定義 |
廃止された | 変更なし |
Document Object Model (DOM) Level 1 Specification HTMLFieldSetElement の定義 |
廃止された | 初回定義 |
ブラウザーの互換性
BCD tables only load in the browser
このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。
関連情報
- このインターフェイスを実装している HTML 要素:
<fieldset>