ns-fieldset
Introduction#
The ns-fieldset component is used to group related ns-inputters.
Use where you would normally use a vanilla html fieldset element. This element extends the layout for ns-form.
Best practises#
| 💚 Do's | 💔 Don'ts |
|---|---|
| Add a legend | Group unrelated ns-inputters |
| Only use inside the ns-form component | Nest ns-fieldsets unnecessarily, as this can lead to confusion |
Considerations of best practises#
A legend is required to make the fieldset accessible
https://www.w3.org/WAI/WCAG21/Techniques/html/H71
The first element inside the fieldset must be a legend element, which provides a label or description for the group
Usage#
Component placement#
The ns-fieldset component can only be used in the ns-form component.
Note#
When adding radio buttons and checkboxes to ns-inputter inside an ns-fieldset, its heading size will match the size of all labels from other ns-inputter. This helps keep a logical visual hierarchy in a form.
Specification#
| Attribute | Type | Default | Options | Description |
|---|---|---|---|---|
legend | text | Add a legend to describe the contents of the fieldset |
| Slots | Type |
|---|---|
| Anonymous | ns-inputters |
Feedback#
- Do you have insights or concerns to share? You can raise an issue via Github bugs.
- See all the issues already raised via Github issues.
💩 🎉 🦄 If you have any questions, contact us on Microsoft Teams in the Nucleus Design System channels.