Active theme set to LightDarkLight high contrastDark high contrast and saved in preferences.
Copied to clipboard.
Error submitting your feedback! Please try again.
We’re hiring frontend developers! View open positions.

FieldsetReady

Fieldset is used for grouping sets of input components. It is necessary to use a fieldset with radio and checkbox components. It can also be useful for logically grouping other types of inputs.

Edit in CodePen
Open in new window
Edit in CodePen
Open in new window
Edit in CodePen
Open in new window
Edit in CodePen
Open in new window
Edit in CodePen
Open in new window
View RTL
<nord-fieldset label="Fieldset label">
<nord-stack>
<nord-checkbox name="option" value="1" label="Option 1"></nord-checkbox>
<nord-checkbox name="option" value="2" label="Option 2"></nord-checkbox>
</nord-stack>
</nord-fieldset>

Properties

PropertyAttributeDescriptionTypeDefault
labellabel

Label for the fieldset.

string""
hinthint

Optional hint text to be displayed with the input. Alternatively use the hint slot.

string | undefinedundefined
errorerror

Optional error to be shown with the fieldset. Alternatively use the error slot.

string | undefinedundefined

Slots

Slot nameDescription
labelUse when a label requires more than plain text.
hintOptional slot that holds hint text for the fieldset.
errorOptional slot that holds error text for the fieldset.

Usage #

This section includes guidelines for designers and developers about the usage of this component in different contexts.

Do #

  • Use the fieldset component when you need to create a relationship between multiple form inputs.
  • It is especially important to use with a group of radio components.

Don’t #

  • Don’t place interactive content (buttons, links etc) inside the label.
  • Don’t use with a checkbox component when there is only one checkbox. For example, when accepting terms and conditions.

Content guidelines #

Fieldset label should be clear, accurate and predictable. It should help the user to understand how the items in the fieldset are grouped together, or what kind of choice the user is making:

Pick a color
Choose

When writing fieldset labels, always write them in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):

Pick a color
Pick A Color

Avoid ending in punctuation if it’s a single sentence, word, or a fragment:

Pick a color
Pick a color.

Do not use colons in fieldset label:

Payment details
Payment details:

Additional considerations #

  • A label (which becomes to <legend> inside the fieldset) is always required.
  • Hint text can be used to offer further information or explanation for an option.

Integration

For integration guidelines, please see Web Components documentation. This documentation explains how to implement and use Nord Web Components across different technologies such as Vue.js, React, or Vanilla JavaScript.

Integration Guidelines

Localization

Nord provides a lightweight solution for localizing its components. Not all components need localizing, as for the most part snippets of text are set per instance. For full localization guidelines, please see Localization documentation.

Localization Guidelines

Troubleshooting

If you experience any issues while using Nord Web Components, please head over to the Support page for more guidelines and ways to contact us.


Was this page helpful?

YesNo
Send feedback

We use this feedback to improve our documentation.