Revision 895967 of <fieldset>

<div>{{HTMLRef}}</div>

<p>The <strong>HTML <code>&lt;fieldset&gt;</code> element</strong> is used to group several controls as well as labels ({{HTMLElement("label")}}) within a web form.</p>

<ul class="htmlelt">
 <li><dfn><a href="/en-US/docs/HTML/Content_categories">Content categories</a></dfn> <a href="/en-US/docs/HTML/Content_categories#Flow_content">Flow content</a>, <a href="/en-US/docs/Sections_and_Outlines_of_an_HTML5_document#sectioning_root">sectioning root</a>, <a href="/en-US/docs/HTML/Content_categories#form_listed">listed</a>, <a href="/en-US/docs/HTML/Content_categories#form-associated_content">form-associated</a> element, palpable content.</li>
 <li><dfn>Permitted content</dfn> An optional {{HTMLElement("legend")}} element, followed by flow content.</li>
 <li><dfn>Tag omission</dfn> {{no_tag_omission}}</li>
 <li><dfn>Permitted parent elements</dfn> Any element that accepts <a href="/en-US/docs/HTML/Content_categories#Flow_content">flow content</a>.</li>
 <li><dfn>DOM interface</dfn> {{domxref("HTMLFieldSetElement")}}</li>
</ul>

<div class="note">
<p><strong>Note:</strong> unlike almost any other element, the WHATWG HTML Rendering spec suggests <code>{{cssxref("min-width")}}: <a href="/en-US/docs/Web/CSS/width#Values">min-content</a></code> as part of the default style for {{HTMLElement("fieldset")}}, and many browsers implement such styling (or something that approximates it).</p>
</div>

<h2 id="Attributes">Attributes</h2>

<p>This element includes the <a href="/en-US/docs/HTML/Global_attributes">global attributes</a>.</p>

<dl>
 <dt>{{htmlattrdef("disabled")}} {{HTMLVersionInline(5)}}</dt>
 <dd>If this Boolean attribute is set, the form controls that are its descendants, except descendants of its first optional {{HTMLElement("legend")}} element, are disabled, i.e., not editable. They won't receive any browsing events, like mouse clicks or focus-related ones. Often browsers display such controls as gray.</dd>
 <dt>{{htmlattrdef("form")}} {{HTMLVersionInline(5)}}</dt>
 <dd>This attribute has the value of the <strong>id </strong>attribute of the {{HTMLElement("form")}} element its related to. Its default value is the <strong>id</strong> of the nearest {{HTMLElement("form")}} element it is a descendant of.</dd>
 <dt>{{htmlattrdef("name")}} {{HTMLVersionInline(5)}}</dt>
 <dd>The name associated with the group, which is submitted with the form data.
 <div class="note">The label for the field set is given by the first {{HTMLElement("legend")}} element that is a child of this field set.</div>
 </dd>
</dl>

<h2 id="Examples">Examples</h2>

<h3 id="Example_1_Form_with_fieldset_legend_and_label">Example #1: Form with fieldset, legend, and label</h3>

<pre class="brush: html">
&lt;form action="test.php" method="post"&gt;
  &lt;fieldset&gt;
    &lt;legend&gt;Title&lt;/legend&gt;
    &lt;input type="radio" id="radio"&gt; &lt;label for="radio"&gt;Click me&lt;/label&gt;
  &lt;/fieldset&gt;
&lt;/form&gt;</pre>

<h3 id="Example_2_Simulating_an_editable_HTMLElement(select)_through_a_fieldset_of_radioboxes_and_textboxes*">Example #2: Simulating an editable {{HTMLElement("select")}} through a <code>fieldset</code> of <a href="/en-US/docs/HTML/Element/Input">radioboxes</a> and <a href="/en-US/docs/HTML/Element/Input">textboxes</a>*</h3>

<p>The following example is made of pure HTML and CSS. There is no JavaScript code.</p>

<p><strong>Be warned</strong>&nbsp;that screen readers and assistive devices will&nbsp;<em>not</em>&nbsp;interpret the following form correctly; this example would be invalid html if the correct elements were used.</p>

<pre class="brush: html">
&lt;!doctype html&gt;
&lt;html&gt;
&lt;head&gt;
&lt;meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /&gt;
&lt;title&gt;Editable [pseudo]select&lt;/title&gt;
&lt;style type="text/css"&gt;

/* Generic form fields */

fieldset.elist, input[type="text"], textarea, select, option, fieldset.elist ul, fieldset.elist &gt; legend, fieldset.elist input[type="text"], fieldset.elist &gt; legend:after {
  -webkit-box-sizing: border-box;
  -moz-box-sizing: border-box;
  box-sizing: border-box;
}

input[type="text"] {
  padding: 0 20px;
}

textarea {
  width: 500px;
  height: 200px;
  padding: 20px;
}

textarea, input[type="text"], fieldset.elist ul, select, fieldset.elist &gt; legend {
  border: 2px #cccccc solid;
  border-radius: 10px;
}

input[type="text"], fieldset.elist, select, fieldset.elist &gt; legend {
  height: 32px;
  font-family: Tahoma;
  font-size: 14px;
}

input[type="text"]:hover, textarea:hover, select:hover, fieldset.elist:hover &gt; legend {
  background-color: #ddddff;
}

select {
  padding: 4px 20px;
}

option {
  height: 30px;
  padding: 5px 4px;
}

option:not(:checked), textarea:focus {
  background-color: #ffcccc;
}

fieldset.elist &gt; legend:after, fieldset.elist label {
  height: 28px;
}

input[type="text"], fieldset.elist {
  width: 316px;
}

input[type="text"]:focus {
  background: #ffcccc url("data:image/gif;base64,R0lGODlhEAAQANU5APnoxuvr6+uxPdvb2+rq6ri4uO7qxunp6dPT06SHV+/rx8vLy+nezLO0sbe3t9Ksas+qaaCEV8rKyp2dnf39/QAAAK6ursifZHFxcc/Qzu3mxYyMjExCJnV1dc6maO7u7o+Pj2tXNoaGhtfDpKCDVu3lxM+tcaKEV9bW1qOFVWNjY8KrisTExNra2nBbObGxsby8vO/mu7Kyso9ZAuzs7MSgAIiKhf///8zMzP///wAAAAAAAAAAAAAAAAAAAAAAACH5BAEAADkALAAAAAAQABAAAAaXwJxwSCwOYzWkMpkkZmoAqDQaJdpqAqw2m53NRjlboAarFczomcE0C99o8DgNMVM8Tm3bbYDr9x11DwkzDG5yc2oQJIRCenx/MxoeETM2Q3pxATMlF4MYlo17OAsdLispMyAioIY0BzMcITMTKBasjgssFTMqGxItMjYUoTQBBAQHxgE0wZcfMtDRMi/QrA022NnaNg1CQQA7") no-repeat 2px center !important;
}

input[type="text"]:focus, textarea:focus, select:focus, fieldset.elist &gt; legend {
  border: 2px #ccaaaa solid;
}

fieldset {
  border: 2px #af3333 solid;
  border-radius: 10px;
}

/* Editable [pseudo]select (i.e. fieldsets with [class=elist]) */

fieldset.elist {
  display: inline-block;
  position: relative;
  vertical-align: middle;
  overflow: visible;
  padding: 0;
  margin: 0;
  border: none;
}

fieldset.elist ul {
  position: absolute;
  width: 100%;
  max-height: 320px;
  padding: 0;
  margin: 0;
  overflow: hidden;
  background-color: transparent;
}

fieldset.elist:hover ul {
  background-color: #ffffff;
  border: 2px #af3333 solid;
  left: 2px;
  overflow: auto;
}

fieldset.elist ul &gt; li {
  list-style-type: none;
  background-color: transparent;
}

fieldset.elist label {
  display: none;
  width: 100%;
}

fieldset.elist input[type="text"] {
  width: 100%;
  height: 30px;
  line-height: 30px;
  border: none;
  background-color: transparent;
  border-radius: 0;
}

fieldset.elist &gt; legend {
  display: block;
  margin: 0;
  padding: 0 0 0 5px;
  position: absolute;
  width: 100%;
  cursor: default;
  background-color: #ccffcc;
  line-height: 30px;
  font-style: italic;
}

fieldset.elist:hover &gt; legend {
  position: relative;
  overflow: hidden;
}

fieldset.elist &gt; legend:after {
  width: 20px;
  content: "\2335";
  float: right;
  text-align: center;
  border-left: 2px #cccccc solid;
  font-style: normal;
  cursor: default;
}

fieldset.elist:hover &gt; legend:after {
  background-color: #99ff99;
}

fieldset.elist ul input[type="radio"] {
  display: none;
}

fieldset.elist input[type="radio"]:checked ~ label {
  display: block;
  width: 292px;
  background-color: #ffffff;
}

fieldset.elist:hover input[type="radio"]:checked ~ label {
  width: 100%;
}

fieldset.elist:hover label {
  display: block;
  height: 100%;
}

fieldset.elist label:hover {
  background-color: #3333ff !important;
}

fieldset.elist:hover input[type="radio"]:checked ~ label {
  background-color: #aaaaaa;
}

&lt;/style&gt;

&lt;/head&gt;
&lt;body&gt;

&lt;form method="get" action="test.php"&gt;

&lt;fieldset&gt;
    &lt;legend&gt;Order a T-Shirt&lt;/legend&gt;
    &lt;p&gt;Write your name (simple textbox): &lt;input type="text" /&gt;&lt;/p&gt;
    &lt;p&gt;Choose your size (simple select):
    &lt;select&gt;
        &lt;option value="s"&gt;Small&lt;/option&gt;
        &lt;option value="m"&gt;Medium&lt;/option&gt;
        &lt;option value="l"&gt;Large&lt;/option&gt;
        &lt;option value="xl"&gt;Extra Large&lt;/option&gt;
    &lt;/select&gt;&lt;/p&gt;
    &lt;div&gt;What address do you want to use? (editable pseudoselect)
    &lt;fieldset class="elist"&gt;
        &lt;legend&gt;Address&amp;hellip;&lt;/legend&gt;
        &lt;ul&gt;
            &lt;li&gt;&lt;input type="radio" value="1" id="address-switch_1" checked /&gt;&lt;label for="address-switch_1"&gt;&lt;input type="text" value="19 Quaker Ridge Rd. Bethel CT 06801" /&gt;&lt;/label&gt;&lt;/li&gt;
            &lt;li&gt;&lt;input type="radio" value="2" id="address-switch_2" /&gt;&lt;label for="address-switch_2"&gt;&lt;input type="text" value="1000 Coney Island Ave. Brooklyn NY 11230" /&gt;&lt;/label&gt;&lt;/li&gt;
            &lt;li&gt;&lt;input type="radio" value="3" id="address-switch_3" /&gt;&lt;label for="address-switch_3"&gt;&lt;input type="text" value="2962 Dunedin Cv. Germantown TN 38138" /&gt;&lt;/label&gt;&lt;/li&gt;
            &lt;li&gt;&lt;input type="radio" value="4" id="address-switch_4" /&gt;&lt;label for="address-switch_4"&gt;&lt;input type="text" value="915 E 7th St. Apt 6L. Brooklyn NY 11230" /&gt;&lt;/label&gt;&lt;/li&gt;
        &lt;/ul&gt;
    &lt;/fieldset&gt;
    &lt;/div&gt;
    &lt;p&gt;Write a comment:&lt;br /&gt;
    &lt;textarea&gt;&lt;/textarea&gt;&lt;/p&gt;
    &lt;p&gt;&lt;input type="reset" value="Reset" /&gt; &lt;input type="submit" value="Send!" /&gt;&lt;/p&gt;
&lt;/fieldset&gt;

&lt;/form&gt;

&lt;/body&gt;
&lt;/html&gt;
</pre>

<p><a href="/files/4563/editable_select.html">View this example in action</a></p>

<h2 id="Specifications">Specifications</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('HTML WHATWG', 'forms.html#the-fieldset-element', '&lt;fieldset&gt;')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td>Definition of the <code>fieldset</code> element</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG', 'rendering.html#the-fieldset-and-legend-elements')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td>Suggested default rendering of the <code>fieldset</code> and <code>legend</code> elements</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5 W3C', 'forms.html#the-fieldset-element', '&lt;fieldset&gt;')}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td>&nbsp;</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML4.01', 'interact/forms.html#h-17.10', '&lt;fieldset&gt;')}}</td>
   <td>{{Spec2('HTML4.01')}}</td>
   <td>Initial definition</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Browser compatibility</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoDesktop("1.0")}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
  <tr>
   <td><code>disabled</code> attribute</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatUnknown}}<sup>[1]</sup></td>
   <td>12</td>
   <td>6</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoMobile("1.0")}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
  <tr>
   <td><code>disabled</code> attribute</td>
   <td>4.4</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>6.0</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] Not all form control descendants of a disabled fieldset are properly disabled in IE11; see <a href="https://connect.microsoft.com/IE/feedbackdetail/view/817488">IE bug 817488: <code>input[type="file"]</code> not disabled inside disabled <code>fieldset</code></a> and <a href="https://connect.microsoft.com/IE/feedbackdetail/view/962368/can-still-edit-input-type-text-within-fieldset-disabled">IE bug 962368: Can still edit <code>input[type="text"]</code> within <code>fieldset[disabled]</code></a>.</p>

<h2 id="Bugs">Bugs</h2>

<ul>
 <li>{{Bug(504622)}} - Fieldsets never shrink below their <code>min-intrinsic</code> width</li>
 <li><a href="https://bugs.webkit.org/show_bug.cgi?id=123507">WebKit bug 123507</a> - <code>min-width: {{cssxref("-webkit-min-content")}}</code> on fieldset</li>
 <li><a href="https://stackoverflow.com/questions/17408815/fieldset-resizes-wrong-appears-to-have-unremovable-min-width-min-content">StackOverflow discussion with workarounds for the above bugs</a></li>
</ul>

<h2 id="See_also">See also</h2>

<ul>
 <li>Other form-related elements: {{HTMLElement("form")}}, {{HTMLElement("legend")}}, {{HTMLElement("label")}}, {{HTMLElement("button")}}, {{HTMLElement("select")}}, {{HTMLElement("datalist")}}, {{HTMLElement("optgroup")}}, {{HTMLElement("option")}}, {{HTMLElement("textarea")}}, {{HTMLElement("keygen")}}, {{HTMLElement("input")}}, {{HTMLElement("output")}}, {{HTMLElement("progress")}} and {{HTMLElement("meter")}}.</li>
</ul>