JSPM

  • Created
  • Published
  • Downloads 533
  • Score
    100M100P100Q105055F
  • License MIT

Manage a group of choices

Package Exports

  • @lion/radio-group
  • @lion/radio-group/define
  • @lion/radio-group/define-radio
  • @lion/radio-group/define-radio-group
  • @lion/radio-group/docs/overview.md
  • @lion/radio-group/docs/use-cases.md

Readme

Radio Group >> Overview ||10

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.

import { html } from '@mdjs/mdjs-preview';
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 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()

Installation

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