lion/packages/radio-group
Thomas Allmer ec8da8f12c feat: release inital public lion version
Co-authored-by: Mikhail Bashkirov <mikhail.bashkirov@ing.com>
Co-authored-by: Thijs Louisse <thijs.louisse@ing.com>
Co-authored-by: Joren Broekema <joren.broekema@ing.com>
Co-authored-by: Gerjan van Geest <gerjan.van.geest@ing.com>
Co-authored-by: Erik Kroes <erik.kroes@ing.com>
Co-authored-by: Lars den Bakker <lars.den.bakker@ing.com>
2019-04-26 10:37:57 +02:00
..
src feat: release inital public lion version 2019-04-26 10:37:57 +02:00
stories feat: release inital public lion version 2019-04-26 10:37:57 +02:00
test feat: release inital public lion version 2019-04-26 10:37:57 +02:00
index.js feat: release inital public lion version 2019-04-26 10:37:57 +02:00
lion-radio-group.js feat: release inital public lion version 2019-04-26 10:37:57 +02:00
package.json feat: release inital public lion version 2019-04-26 10:37:57 +02:00
README.md feat: release inital public lion version 2019-04-26 10:37:57 +02:00

Radio-group

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.

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()

How to use

Installation

npm i --save @lion/radio @lion/radio-group
import '@lion/radio/lion-radio.js';
import '@lion/radio-group/lion-radio-group.js';

Example

<lion-form><form>
  <lion-radio-group
    name="dinosGroup"
    label="What are your favourite dinosaurs?"
    .errorValidators=${[['required']]}
  >
    <lion-radio name="dinos[]" label="allosaurus" .choiceValue=${'allosaurus'}></lion-radio>
    <lion-radio name="dinos[]" label="brontosaurus" .choiceValue=${'brontosaurus'}></lion-radio>
    <lion-radio name="dinos[]" label="diplodocus" .choiceValue=${'diplodocus'} checked></lion-radio>
  </lion-radio-group>
</form></lion-form>
  • 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