Radio Group: Overview
A web component that enhances the functionality of the native <input type="radio">
element. Its purpose is to provide a way for users to check a single option amongst a set of choices.
You should use our radio
inside this element.
export const main = () => html`
<lion-radio-group name="dinos" label="What are your favourite dinosaurs?">
<lion-radio label="allosaurus" .choiceValue="${'allosaurus'}"></lion-radio>
<lion-radio label="brontosaurus" .choiceValue="${'brontosaurus'}"></lion-radio>
<lion-radio label="diplodocus" .choiceValue="${'diplodocus'}"></lion-radio>
</lion-radio-group>
`;
- Make sure that to use a name attribute as it is necessary for our form's serialization result.
- If you have many options for a user to pick from, consider using our select instead.
Features
Since it extends from our fieldset, it has all the features a fieldset has.
- Get or set the checked value of the group:
- modelValue (default) -
checkedValue()
- formattedValue -
formattedValue()
- serializedValue -
serializedValue()
- modelValue (default) -
Installation
npm i --save @lion/ui
import { LionRadioGroup, LionRadio } from '@lion/ui/radio-group.js';
// or
import '@lion/ui/define/lion-radio-group.js';
import '@lion/ui/define/lion-radio.js';