43 lines
1.1 KiB
Markdown
43 lines
1.1 KiB
Markdown
# Fieldset
|
|
|
|
[//]: # 'AUTO INSERT HEADER PREPUBLISH'
|
|
|
|
`lion-fieldset` groups multiple input fields or other fieldsets together.
|
|
|
|
Two specific types of fieldsets:
|
|
|
|
- [lion-checkbox-group](../checkbox-group/)
|
|
- [lion-radio-group](../radio-group/)
|
|
|
|
## Features
|
|
|
|
- easy retrieval of form data based on field names
|
|
- advanced user interaction scenarios via [interaction states](../field/docs/InteractionStates.md)
|
|
- can have [validate](../validate/) on fieldset level and shows the validation feedback below the fieldset
|
|
- can disable input fields on fieldset level
|
|
- accessible out of the box
|
|
|
|
## How to use
|
|
|
|
### Installation
|
|
|
|
```sh
|
|
npm i --save @lion/fieldset
|
|
```
|
|
|
|
```js
|
|
import '@lion/fieldset/lion-fieldset.js';
|
|
import '@lion/input/lion-input.js';
|
|
```
|
|
|
|
### Example
|
|
|
|
```html
|
|
<lion-fieldset name="personalia" label="personalia">
|
|
<lion-input name="title" label="Title"></lion-input>
|
|
<lion-fieldset name="fullName" label="Full name" .errorValidations="${[['required]]}">
|
|
<lion-input name="firstName" label="First name"></lion-input>
|
|
<lion-input name="lastName" label="Last name"></lion-input>
|
|
</lion-fieldset>
|
|
</lion-fieldset>
|
|
```
|