aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/htmlfieldsetelement/index.html
blob: 20cb64d732c1e5fa2045468351a55bf391229486 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
---
title: HTMLFieldSetElement
slug: Web/API/HTMLFieldSetElement
tags:
  - API
  - HTML DOM
  - Interface
  - Reference
  - インターフェイス
translation_of: Web/API/HTMLFieldSetElement
---
<div>{{APIRef("HTML DOM")}}</div>

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

<p>{{InheritanceDiagram(600, 120)}}</p>

<h2 id="Properties" name="Properties">プロパティ</h2>

<p><em>親である {{domxref("HTMLElement")}} からプロパティを継承しています。</em></p>

<dl>
 <dt>{{domxref("HTMLFieldSetElement.disabled")}}</dt>
 <dd> {{jsxref("Boolean")}} で、 HTML の {{htmlattrxref("disabled", "fieldset")}} 属性を反映し、ユーザーがこのコントロールと対話できるかどうかを示します。</dd>
 <dt>{{domxref("HTMLFieldSetElement.elements")}}{{ReadOnlyInline}}</dt>
 <dd>このフィールドセットに所属する要素です。このプロパティの型は、ブラウザーが実装している仕様書のバージョンによって異なります。</dd>
 <dt>{{domxref("HTMLFieldSetElement.form")}}{{ReadOnlyInline}}</dt>
 <dd> {{domxref("HTMLFormControlsCollection")}} または {{domxref("HTMLCollection")}} で、この要素がフォーム内にあった場合、含んでいるフォーム要素を参照します。<br>
 このフィールドセットがフォーム要素の子孫でなかった場合は、この属性は関連付けられた同じ文書内の何れかのフォームになるか、一致するものがなければ <code>null</code> になります。</dd>
 <dt>{{domxref("HTMLFieldSetElement.name")}}</dt>
 <dd> {{domxref("DOMString")}} で、 HTML の {{htmlattrxref("name", "fieldset")}} 属性を反映し、フォームを送信するときに使われるフィールドセットの名前が入ります。</dd>
 <dt>{{domxref("HTMLFieldSetElement.type")}}{{ReadOnlyInline}}</dt>
 <dd> {{domxref("DOMString")}} で "<code>fieldset</code>" です。</dd>
 <dt>{{domxref("HTMLFieldSetElement.validationMessage")}}</dt>
 <dd> {{domxref("DOMString")}} で、 (もしあれば) 制約検証でコントロールが合格しなかった場合のローカライズされたメッセージを表現します。この属性はコントロールが制約検証の候補にならない場合 (<code>willValidate</code><code>false</code> の場合) や、制約を満たしている場合は空文字列になります。</dd>
 <dt>{{domxref("HTMLFieldSetElement.validity")}}</dt>
 <dd> {{domxref("ValidityState")}} で、この要素がある妥当性の状態を表します。</dd>
 <dt>{{domxref("HTMLFieldSetElement.willValidate")}}</dt>
 <dd> {{jsxref("Boolean")}}<code>false</code> です。 {{HTMLElement("fieldset")}} オブジェクトは制約検証の対象になることがないからです。</dd>
</dl>

<h2 id="Methods" name="Methods">メソッド</h2>

<p><em>親である {{domxref("HTMLElement")}} からメソッドを継承しています。</em></p>

<dl>
 <dt>{{domxref("HTMLFieldSetElement.checkValidity()")}}</dt>
 <dd>常に <code>true</code> を返します。 {{HTMLElement("fieldset")}} オブジェクトは制約検証の対象になることがないためです。</dd>
 <dt>{{domxref("HTMLFieldSetElement.reportValidity()")}}</dt>
 <dd>常に <code>true</code> を返します。 {{HTMLElement("fieldset")}} オブジェクトは制約検証の対象になることがないためです。</dd>
 <dt>{{domxref("HTMLFieldSetElement.setCustomValidity()")}}</dt>
 <dd>独自の検証メッセージをフィールドセットに設定します。メッセージが空文字列でなければ、フィールドセットには独自の検証エラーが発生している状態であり、検証に合格していません。</dd>
</dl>

<h2 id="Specifications" name="Specifications">仕様書</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">仕様書</th>
   <th scope="col">状態</th>
   <th scope="col">備考</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('HTML WHATWG', "#htmlfieldsetelement", "HTMLFieldSetElement")}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5.1', "forms.html#the-fieldset-element", "HTMLFieldSetElement")}}</td>
   <td>{{Spec2('HTML5.1')}}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5 W3C', "forms.html#the-fieldset-element", "HTMLFieldSetElement")}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td><code>disabled</code>, <code>elements</code>, <code>name</code>, <code>type</code>, <code>valdiationMessage</code>, <code>validity</code>, and <code>willValidate</code> プロパティが追加された。<br>
    <code>checkValidity()</code>, <code>setCustomValidity()</code> メソッドが追加された。</td>
  </tr>
  <tr>
   <td>{{SpecName('DOM2 HTML', 'html.html#ID-7365882', 'HTMLFieldSetElement')}}</td>
   <td>{{Spec2('DOM2 HTML')}}</td>
   <td>変更なし</td>
  </tr>
  <tr>
   <td>{{SpecName('DOM1', 'level-one-html.html#ID-7365882', 'HTMLFieldSetElement')}}</td>
   <td>{{Spec2('DOM1')}}</td>
   <td>初回定義</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>

<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div>

<p>{{Compat("api.HTMLFieldSetElement")}}</p>

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li>このインターフェイスを実装している HTML 要素: {{ HTMLElement("fieldset") }}</li>
</ul>