1.仕様
FIELDSET要素は、
グループ化された
フォームコントロール
(またはその他のコンテンツ)
のセットを
表します。
- fieldset
-
フォームコントロールグループ (form control group)
- 種類
-
通常要素
- コンテンツモデル
-
1つのlegend
要素 と、それに続く0個以上のフローコンテンツ 1つのlegend
要素 と、それに続く0個以上のフローコンテンツ が配置できます。フロー
コンテンツ に分類される要素は、header要素 , footer要素 , main要素 , address要素 , ol要素 , ul要素 , menu要素 , dl要素 , table要素 , form要素 , fieldset要素 , search要素 , hr要素 , p要素 , pre要素 , blockquote要素 , figure要素 , div要素 , dialog要素 , section要素 , nav要素 , aside要素 , article要素 , h1要素 , h2要素 , h3要素 , h4要素 , h5要素 , h6要素 , hgroup要素 , script要素 , noscript要素 , template要素 , input要素 , textarea要素 , select要素 , label要素 , button要素 , output要素 , progress要素 , meter要素 , datalist要素 , picture要素 , object要素 , img要素 , iframe要素 , embed要素 , video要素 , audio要素 , canvas要素 , map要素 , area要素 , a要素 , details要素 , ins要素 , del要素 , abbr要素 , b要素 , bdi要素 , bdo要素 , cite要素 , code要素 , data要素 , dfn要素 , em要素 , i要素 , kbd要素 , mark要素 , q要素 , s要素 , samp要素 , small要素 , span要素 , strong要素 , sub要素 , sup要素 , u要素 , var要素 , time要素 , ruby要素 , br要素 , wbr要素 , slot要素 , テキスト です。 - タグの省略
-
どちらのタグも省略できません。
- コンテンツ属性
-
グローバル属性 他
- disabled
属性 - 内部の凡例を除く子孫フォームコントロールが無効になっているかどうか
- form
属性 - 要素をフォーム要素に関連付けます
- name
属性 - form.elements API で使用する要素の名前
- disabled
- DOM インターフェイス
-
HTMLFieldSetElement
[Exposed=Window]
interface HTMLFieldSetElement : HTMLElement {
[HTMLConstructor] constructor();
[CEReactions] attribute boolean disabled;
readonly attribute HTMLFormElement? form;
[CEReactions] attribute DOMString name;
readonly attribute DOMString type;
[SameObject] readonly attribute HTMLCollection elements;
readonly attribute boolean willValidate;
[SameObject] readonly attribute ValidityState validity;
readonly attribute DOMString validationMessage;
boolean checkValidity();
boolean reportValidity();
undefined setCustomValidity(DOMString error);
};
HTMLElement
[Exposed=Window]
interface HTMLElement : Element {
[HTMLConstructor] constructor();
// metadata attributes
[CEReactions] attribute DOMString title;
[CEReactions] attribute DOMString lang;
[CEReactions] attribute boolean translate;
[CEReactions] attribute DOMString dir;
// user interaction
[CEReactions] attribute (boolean or unrestricted double or DOMString)? hidden;
[CEReactions] attribute DOMString inert;
undefined click();
[CEReactions] attribute DOMString accessKey;
readonly attribute DOMString accessKeyLabel;
[CEReactions] attribute boolean draggable;
[CEReactions] attribute boolean spellcheck;
[CEReactions] attribute DOMString writingSuggestions;
[CEReactions] attribute DOMString autocapitalize;
[CEReactions] attribute [LegacyNullToEmptyString] DOMString innerText;
[CEReactions] attribute [LegacyNullToEmptyString] DOMString outerText;
ElementInternals attachInternals();
// The popover API
undefined showPopover();
undefined hidePopover();
boolean togglePopover(optional boolean force);
[CEReactions] attribute DOMString? popover;
};
HTMLElement includes GlobalEventHandlers;
HTMLElement includes ElementContentEditable;
HTMLElement includes HTMLOrSVGElement;
Element
[Exposed=Window]
interface Element : Node {
readonly attribute DOMString? namespaceURI;
readonly attribute DOMString? prefix;
readonly attribute DOMString localName;
readonly attribute DOMString tagName;
[CEReactions] attribute DOMString id;
[CEReactions] attribute DOMString className;
[SameObject, PutForwards=value] readonly attribute DOMTokenList classList;
[CEReactions, Unscopable] attribute DOMString slot;
boolean hasAttributes();
[SameObject] readonly attribute NamedNodeMap attributes;
sequence<DOMString> getAttributeNames();
DOMString? getAttribute(DOMString qualifiedName);
DOMString? getAttributeNS(DOMString? namespace, DOMString localName);
[CEReactions] undefined setAttribute(DOMString qualifiedName, DOMString value);
[CEReactions] undefined setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value);
[CEReactions] undefined removeAttribute(DOMString qualifiedName);
[CEReactions] undefined removeAttributeNS(DOMString? namespace, DOMString localName);
[CEReactions] boolean toggleAttribute(DOMString qualifiedName, optional boolean force);
boolean hasAttribute(DOMString qualifiedName);
boolean hasAttributeNS(DOMString? namespace, DOMString localName);
Attr? getAttributeNode(DOMString qualifiedName);
Attr? getAttributeNodeNS(DOMString? namespace, DOMString localName);
[CEReactions] Attr? setAttributeNode(Attr attr);
[CEReactions] Attr? setAttributeNodeNS(Attr attr);
[CEReactions] Attr removeAttributeNode(Attr attr);
ShadowRoot attachShadow(ShadowRootInit init);
readonly attribute ShadowRoot? shadowRoot;
Element? closest(DOMString selectors);
boolean matches(DOMString selectors);
boolean webkitMatchesSelector(DOMString selectors); // legacy alias of .matches
HTMLCollection getElementsByTagName(DOMString qualifiedName);
HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
HTMLCollection getElementsByClassName(DOMString classNames);
[CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // legacy
undefined insertAdjacentText(DOMString where, DOMString data); // legacy
};
GlobalEventHandlers
interface mixin GlobalEventHandlers {
attribute EventHandler onabort;
attribute EventHandler onauxclick;
attribute EventHandler onbeforeinput;
attribute EventHandler onbeforematch;
attribute EventHandler onbeforetoggle;
attribute EventHandler onblur;
attribute EventHandler oncancel;
attribute EventHandler oncanplay;
attribute EventHandler oncanplaythrough;
attribute EventHandler onchange;
attribute EventHandler onclick;
attribute EventHandler onclose;
attribute EventHandler oncontextlost;
attribute EventHandler oncontextmenu;
attribute EventHandler oncontextrestored;
attribute EventHandler oncopy;
attribute EventHandler oncuechange;
attribute EventHandler oncut;
attribute EventHandler ondblclick;
attribute EventHandler ondrag;
attribute EventHandler ondragend;
attribute EventHandler ondragenter;
attribute EventHandler ondragleave;
attribute EventHandler ondragover;
attribute EventHandler ondragstart;
attribute EventHandler ondrop;
attribute EventHandler ondurationchange;
attribute EventHandler onemptied;
attribute EventHandler onended;
attribute OnErrorEventHandler onerror;
attribute EventHandler onfocus;
attribute EventHandler onformdata;
attribute EventHandler oninput;
attribute EventHandler oninvalid;
attribute EventHandler onkeydown;
attribute EventHandler onkeypress;
attribute EventHandler onkeyup;
attribute EventHandler onload;
attribute EventHandler onloadeddata;
attribute EventHandler onloadedmetadata;
attribute EventHandler onloadstart;
attribute EventHandler onmousedown;
[LegacyLenientThis] attribute EventHandler onmouseenter;
[LegacyLenientThis] attribute EventHandler onmouseleave;
attribute EventHandler onmousemove;
attribute EventHandler onmouseout;
attribute EventHandler onmouseover;
attribute EventHandler onmouseup;
attribute EventHandler onpaste;
attribute EventHandler onpause;
attribute EventHandler onplay;
attribute EventHandler onplaying;
attribute EventHandler onprogress;
attribute EventHandler onratechange;
attribute EventHandler onreset;
attribute EventHandler onresize;
attribute EventHandler onscroll;
attribute EventHandler onscrollend;
attribute EventHandler onsecuritypolicyviolation;
attribute EventHandler onseeked;
attribute EventHandler onseeking;
attribute EventHandler onselect;
attribute EventHandler onslotchange;
attribute EventHandler onstalled;
attribute EventHandler onsubmit;
attribute EventHandler onsuspend;
attribute EventHandler ontimeupdate;
attribute EventHandler ontoggle;
attribute EventHandler onvolumechange;
attribute EventHandler onwaiting;
attribute EventHandler onwebkitanimationend;
attribute EventHandler onwebkitanimationiteration;
attribute EventHandler onwebkitanimationstart;
attribute EventHandler onwebkittransitionend;
attribute EventHandler onwheel;
};
ElementContentEditable
interface mixin ElementContentEditable {
[CEReactions] attribute DOMString contentEditable;
[CEReactions] attribute DOMString enterKeyHint;
readonly attribute boolean isContentEditable;
[CEReactions] attribute DOMString inputMode;
};
HTMLOrSVGElement
interface mixin HTMLOrSVGElement {
[SameObject] readonly attribute DOMStringMap dataset;
attribute DOMString nonce; // intentionally no [CEReactions]
[CEReactions] attribute boolean autofocus;
[CEReactions] attribute long tabIndex;
undefined focus(optional FocusOptions options = {});
undefined blur();
};
- ARIA in HTML
-
暗黙的="
group
" ARIAロール="あり" aria-* 属性="GlobalAny
"暗黙的な ARIAセマンティクスは、
role=group
です。作成者が要素に指定してもよい ARIAロール値は、 none, presentation, radiogroup です。
グローバル aria-* 属性と、許可されたロールに適用される任意の aria-* 属性が記述できます。
- レンダリング
- ブロック
ボックス フローコンテンツ
fieldset {
display: block;
margin-inline: 2px;
border: groove 2px ThreeDFace;
padding-block: 0.35em 0.625em;
padding-inline: 0.75em;
min-inline-size: min-content;
}
CSS を大雑把に読むと、 ブロックレベルのブロックコンテナボックス(ブロックボックス)を生成します。 などになります。
- 説明
-
fieldset
要素 は、グループ化されたフォームコントロール (またはその他のコンテンツ) のセットを表し、オプションでキャプションも付けられます。キャプションは、fieldset要素の子である最初の legend要素 (存在する場合) によって与えられます。残りの子孫がグループを形成します。<!DOCTYPE html>
<html lang=
"ja"> <head>
<meta charset=
"utf-8"> <title>fieldset要素の例 - (Example of fieldset element) | 離珠のHTMLでしぃ!</title>
</head>
<body>
<h1>fieldset要素の例</h1>
<form action=
"../Html/fmreceive.htm"> <fieldset name=
"nfifieldset"> <legend>Heading</legend>
<input name=
"nipInput" value= "abc"> <button name=
"nbtSender" value= "../Html/exfieldset.htm">ボタン</button> <br>受信用の<br>ページへ
</fieldset>
</form>
</body>
</html>
このサンプルへのリンクです。
(./exfieldset.htm) - 参照元
-
参照元
- HTML Living Standard. 4.10.15 The fieldset element (Last Updated 27 August 2024)
- HTML Living Standard. 15 Rendering 15.3.12 The fieldset and legend elements (Last Updated 27 August 2024)
- HTML 5.2 W3C 勧告. 4.10.15. The fieldset element (W3C勧告、2017年12月14日)
- HTML 5.2 W3C 勧告. 10.3.13. The fieldset and legend elements. (W3C勧告、2017年12月14日)
- HTML 5.1 W3C 勧告. 4.10.16. The fieldset element (W3C勧告、2016年11月1日)
- HTML 5.1 W3C 勧告. 10.3.13. The fieldset and legend elements. (W3C勧告、2016年11月1日)
- HTML 5 W3C 勧告. 4.10.16 The fieldset element (W3C勧告、2014年10月28日)
- HTML 5 W3C 勧告. 10.3.13 The fieldset and legend elements. (W3C勧告、2014年10月28日)
- HTML 4.01 Specification W3C 勧告. 17.10 Adding structure to forms: the FIELDSET and LEGEND elements (W3C勧告1999年12月24日)
- <fieldset>: フィールドセット要素 - HTML: ハイパーテキストマークアップ言語 | MDN
- JSONデータ
-
JSON形式での、データのイメージです。
{
"fieldset": {
"check": "2024-09-01",
"group": "Form",
"element": "- - (legend,(%Flow)*) -- form control group. (Normal elements.) [Flow|Sectioningroots|Listed|Autocapitalize|Form|Palpable] --",
"attlist": {
"%Global;": "",
"disabled": "(disabled) #IMPLIED -- Whether the descendant form controls, except any inside legend, are disabled --",
"form": "IDREF #IMPLIED -- Associates the element with a form element --",
"name": "CDATA #IMPLIED -- Name of the element to use in the form.elements API. --",
},
"comment": "フォームコントロールグループ (form control group)",
"point": "グループ化されたフォームコントロール (またはその他のコンテンツ) のセットを表し、オプションでキャプションも付けられます。キャプションは、fieldset要素の子である最初の legend要素 (存在する場合) によって与えられます。残りの子孫がグループを形成します。",
"kind": "Normal",
"categories": [
"Flow",
"Sectioningroots",
"Listed",
"Autocapitalize",
"Formassociated",
"Palpable",
],
"used": "parent (%Flow)*",
"contentmodel": "fieldset (legend,(%Flow)*)",
"tag": [
"-",
"-",
],
"attributes": {
"disabled": "内部の凡例を除く子孫フォームコントロールが無効になっているかどうか",
"form": "要素をフォーム要素に関連付けます",
"name": "form.elements API で使用する要素の名前",
},
"dominterface": "HTMLFieldSetElement",
"rendering": "Flow",
"reference": [
{
"title": "HTML Living Standard. 4.10.15 The fieldset element.",
"href": "https://html.spec.whatwg.org/multipage/form-elements.html#the-fieldset-element",
"heading": "HTML Living Standard. 4.10.15 The fieldset element",
"sub": "Last Updated 27 August 2024",
},
{
"title": "HTML Living Standard. 15 Rendering 15.3.12 The fieldset and legend elements.",
"href": "https://html.spec.whatwg.org/multipage/rendering.html#the-fieldset-and-legend-elements",
"heading": "HTML Living Standard. 15 Rendering 15.3.12 The fieldset and legend elements",
"sub": "Last Updated 27 August 2024",
},
{
"title": "HTML 5.2 W3C Recommendation. 4.10.15. The fieldset element. W3C Recommendation, 14 December 2017.",
"href": "https://www.w3.org/TR/2017/REC-html52-20171214/sec-forms.html#the-fieldset-element",
"heading": "HTML 5.2 W3C 勧告. 4.10.15. The fieldset element",
"sub": "W3C勧告、2017年12月14日",
},
{
"title": "HTML 5.2 W3C Recommendation. 10.3.13. The fieldset and legend elements.",
"href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#the-fieldset-and-legend-elements",
"heading": "HTML 5.2 W3C 勧告. 10.3.13. The fieldset and legend elements.",
"sub": "W3C勧告、2017年12月14日",
},
{
"title": "HTML 5.1 W3C Recommendation. 4.10.16. The fieldset element. W3C Recommendation, 1 November 2016.",
"href": "https://www.w3.org/TR/2016/REC-html51-20161101/sec-forms.html#the-fieldset-element",
"heading": "HTML 5.1 W3C 勧告. 4.10.16. The fieldset element",
"sub": "W3C勧告、2016年11月1日",
},
{
"title": "HTML 5.1 W3C Recommendation. 10.3.13. The fieldset and legend elements. W3C Recommendation, 1 November 2016.",
"href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#the-fieldset-and-legend-elements",
"heading": "HTML 5.1 W3C 勧告. 10.3.13. The fieldset and legend elements.",
"sub": "W3C勧告、2016年11月1日",
},
{
"title": "HTML 5 W3C Recommendation. 4.10.16 The fieldset element. W3C Recommendation, 28 October 2014.",
"href": "https://www.w3.org/TR/2014/REC-html5-20141028/forms.html#the-fieldset-element",
"heading": "HTML 5 W3C 勧告. 4.10.16 The fieldset element",
"sub": "W3C勧告、2014年10月28日",
},
{
"title": "HTML 5 W3C Recommendation. 10.3.13 The fieldset and legend elements. W3C Recommendation, 28 October 2014.",
"href": "https://www.w3.org/TR/2014/REC-html5-20141028/rendering.html#the-fieldset-and-legend-elements",
"heading": "HTML 5 W3C 勧告. 10.3.13 The fieldset and legend elements.",
"sub": "W3C勧告、2014年10月28日",
},
{
"title": "HTML 4.01 Specification W3C Recommendation. 17.10 Adding structure to forms: the FIELDSET and LEGEND elements. W3C Recommendation 24 December 1999.",
"href": "https://www.w3.org/TR/html401/interact/forms.html#h-17.10",
"heading": "HTML 4.01 Specification W3C 勧告. 17.10 Adding structure to forms: the FIELDSET and LEGEND elements",
"sub": "W3C勧告1999年12月24日",
},
{
"title": "MDN Web Docs. HTML <fieldset>: The Field Set element.",
"href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/fieldset",
"heading": "<fieldset>: フィールドセット要素 - HTML: ハイパーテキストマークアップ言語 | MDN",
},
],
"version": {
"first": "HTML4",
"latest": "HTML Living Standard",
},
}
}
注意: 簡易に描画する為に、各項目の後ろに
,
を付与しています。JSON の形式では、末尾の項目の後には,
は付けません。 - 最終確認日
-
2024-09-01
2.使用可能な箇所
フロー
受け入れる要素に
配置できます。
fieldset
フロー
3.配置できるコンテンツ
フロー
配置できます。
fieldset
フロー
4.属性
グローバル属性と、
disabled,
form,
name を
設定できます。
fieldsetは、グローバル属性とdisabled属性, form属性, name属性を設定できます。
<form action=
"./fmreceive.htm"> <fieldset>
<input name=
"nipText" type= "text" value= "123"> </fieldset>
<button name=
"nbtSender" value= "./fofieldset.htm#MAP4NEXT">ボタン</button> </form>
form
例示に於いて、送信の状況を見る為に送信先を./fmreceive.htm
としています。それは送信のデモ用の受信ページです。そこで送信元が分かる様に、名前がnbtSender
というデータで送信元を表す記述をしています。
例示では見易さの為に、inputにスタイルシートで装飾(幅)の指定をしています。
disabled属性
<fieldset disabled>
disabledは、コントロールを非対話型にして、その値が送信されないようにする為に使用されるブール属性です。
form属性
<form action=
"./fmreceive.htm"> <fieldset form=
"ifoForm41" ><input name=
"nipText" type= "text" value= "123"> </fieldset>
<button name=
"nbtSender" value= "./fofieldset.htm#MH3FORM">ボタン</button> </form>
<form id=
"ifoForm41" action= "./fmreceive.htm"> <button name=
"nbtSender" value= "./fofieldset.htm#MH3FORM">ボタン</button> </form>
<div>この下のフォームのフォームコントロールは、
<div id=
"idvJsElements41">〇〇</div> </div>
<script>
document
.addEventListener( "DOMContentLoaded", function() { var voElements41 = document
.getElementById( "ifoForm41"); var voDemo41 = document
.getElementById( "idvJsElements41"); var veUl = document
.createElement( "ul"); var veLi = document
.createElement( "li"); var veSpan = document
.createElement( "span"); for (var i = 0; i < voElements41.length; i++){
veLi = document
.createElement( "li"); veSpan = document
.createElement( "span"); veSpan.innerHTML = 'tagName=' + voElements41[i].tagName + 'name=' + voElements41[i].name + '<br>value=<wbr>' + voElements41[i].value;
veLi
.appendChild( veSpan); if(voElements41[i].
tagName == 'FIELDSET' && voElements41[i]. elements) { veUl2 = document
.createElement( "ul"); for (var j = 0; j < voElements41.
elements. length; j++){ veLi2 = document
.createElement( "li"); veSpan2 = document
.createElement( "span"); veSpan2.innerHTML= 'tagName=' + voElements41[i].
elements[j]. tagName + ' name=' + voElements41[i]. elements[j]. name + '<br>value=<wbr>' + voElements41[i]. elements[j]. value; veLi2
.appendChild( veSpan2); veUl2
.appendChild( veLi2); }
veLi
.appendChild( veUl2); }
veUl
.appendChild( veLi); }
if(veUl
.childElementCount) { voDemo41
.textContent = ""; while(
voDemo41 .firstChild){ voDemo41
.removeChild( voDemo41 .firstChild); }
voDemo41
.appendChild( veUl); }
});
</script>
formは、その要素をそのフォーム所有者に明示的に関連付ける為に使用されます。
フォーム関連要素は、デフォルトでは、最も近い祖先form
あくまでfieldsetとformとの関連付けなので、その子要素を含めてformに関連付ける訳ではありません。例示から、formに関連付いているのはfieldsetとbuttonです。そしてそのfieldsetから辿れるのがinputな訳です。なので、下のフォームでinputのデータは辿れるのですが、そのフォームとしての送信対象にはinputはなっていない訳です。inputも送信対象としたい場合は、それ自体で関連付ける必要があります。
name属性
<fieldset name=
"nfsFieldset" >
nameは、要素の名前を表します。
nameは、フォームの送信時やformの elements オブジェクトで使用されるフォームコントロールの名前を指定します。属性が指定されている場合、その値は空の文字列またはisindex
であってはなりません。isindex
以外では、name に空でない任意の値が許可されます。name_charset_
の ASCII 大文字と小文字を区別しない一致は特別です。
nameはフォームコントロールの名前となるので、他の属性名などと重複しないように命名規則を事前に内部規則などで決めておくのが良いです。
5.Web API
name属性を用いて
form要素
(HTMLFormElement
オブジェクト)の
プロパティとして
要素を取得する方法が
お勧めです。
fieldset
6.レンダリング
fieldset {
display: block;
margin-inline: 2px;
border: groove 2px ThreeDFace;
padding-block: 0.35em 0.625em;
padding-inline: 0.75em;
min-inline-size: min-content;
}
fieldset
7.気を付ける点
カテゴリ
form
fieldset