4.10.4 fieldset 要素

Status: Last call for comments

カテゴリー

フロー・コンテンツ

セクショニング・ルート

リストされたフォーム関連要素.

この要素を使うことができるコンテキスト：

フロー・コンテンツが期待される場所

コンテンツモデル：

オプションでひとつの legend 要素の後にフロー・コンテンツが続く

コンテンツ属性：

グローバル属性

disabled

form

name

DOMインタフェース：

interface HTMLFieldSetElement : HTMLElement {
           attribute boolean disabled;
  readonly attribute HTMLFormElement form;
           attribute DOMString name;

  readonly attribute DOMString type;

  readonly attribute HTMLFormControlsCollection elements;

  readonly attribute boolean willValidate;
  readonly attribute ValidityState validity;
  readonly attribute DOMString validationMessage;
  boolean checkValidity();
  void setCustomValidity(in DOMString error);
};

fieldset 要素は、共通の名前のもとでグループ化されたフォーム・コントロールのセットを表します。

グループの名前は、fieldset 要素の子となる最初の legend 要素があれば、それによって与え、その残りの子孫が、そのグループを形成します。

disabled 属性が指定されると、fieldset 要素の子孫のフォーム・コントロールすべてが無効になります。ただし、fieldset 要素の子のうち最初の legend 要素の子孫となるものがあれば、それらは除外され、無効になりません。

form 属性は、明示的に fieldset 要素をフォーム・オーナーと関連付けるために使われます。name 属性は要素の名前を表します。

fieldset . type

文字列 "fieldset" を返します。

fieldset . elements

該当要素にあるフォーム・コントロールの HTMLCollection を返します。

<fieldset name="clubfields" disabled>
 <legend> <label>
  <input type=checkbox name=club onchange="form.clubfields.disabled = !checked">
  Use Club Card
 </label> </legend>
 <p><label>Name on card: <input name=clubname required></label></p>
 <p><label>Card number: <input name=clubnum required pattern="[-0-9]+"></label></p>
 <p><label>Expiry date: <input name=clubexp type=month></label></p>
</fieldset>

※ 原文：http://www.w3.org/TR/2010/WD-html5-20100624/forms.html#the-fieldset-element