lion/docs/components/inputs/radio-group/overview.md

Inputs >> Radio Group >> Overview ||10

lion-radio-group component is webcomponent 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 <lion-radio>s inside this element.

import { html } from '@lion/core';
import '@lion/radio-group/define';

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 the lion-form's serialization result.
• If you have many options for a user to pick from, consider using lion-select instead

Features

Since it extends from lion-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()

Installation

npm i --save @lion/radio-group

import { LionRadioGroup, LionRadio } from '@lion/radio-group';
// or
import '@lion/radio-group/define';