Lion Logo Lion Fundamentals Guides Components Blog Toggle darkmode

Checkbox Group: Overview

A checkbox group enhances the functionality of the native <input type="checkbox"> element. Its purpose is to provide a way for users to check multiple options amongst a set of choices, or to function as a single toggle.

You should use our checkbox elements as children in checkbox group.

<lion-checkbox-group name="scientists[]" label="Favorite scientists">
  <lion-checkbox label="Archimedes" .choiceValue="${'Archimedes'}"></lion-checkbox>
  <lion-checkbox label="Francis Bacon" .choiceValue="${'Francis Bacon'}"></lion-checkbox>
  <lion-checkbox label="Marie Curie" .choiceValue="${'Marie Curie'}"></lion-checkbox>
</lion-checkbox-group>

Make sure that the checkbox-group also has a name attribute, this is necessary for our form's serialization result.

Features

Since it extends from our fieldset, it has all the features a fieldset has.

Installation

npm i --save @lion/ui
import '@lion/ui/define/lion-checkbox-group.js';
import '@lion/ui/define/lion-checkbox-indeterminate.js';
import '@lion/ui/define/lion-checkbox.js';