Skip to content

Checkbox group - Web Component โ€‹

Browser support โ€‹

Parameters โ€‹

The Web component uses the <z-checkbox-group> tag:

The parametrization of the component can be done with the following custom HTML params:

NameTypeDescription
label
(optional)
stringLabel of the input
value
(optional)
booleanValue of the model
checked
(optional)
booleanOverrides the "value" parameter as in the standard
disabled
(optional)
booleanBlocks the interaction with the input component.
required
(optional)
booleanMarks the input component as required.
name
(optional)
stringIdentification for the field inside the form
invalid
(optional)
booleanThe forced state for set the input as invalid

The events emitted from the component are:

NamePayloadDescription
onchangeboolean[]Returns the new value of the "value" attribute

label โ€‹

The z-checkbox-group component accepts a label attribute to set the text label of the component.

value & checked โ€‹

The z-checkbox-group component accepts a value attribute to set the value of the component. It also accepts a checked attribute to set the checked state of the component.

disabled โ€‹

You can disable the z-checkbox-group component by adding the disabled attribute.

required โ€‹

You can make the z-checkbox-group component required by adding the required attribute.

name โ€‹

The z-checkbox-group component accepts a name attribute to set the name of the component.

invalid โ€‹

You can set the z-checkbox-group component to an invalid state by adding the invalid attribute.

Playground โ€‹

Customization โ€‹

HTML Examples โ€‹

Imports
html
<link rel="stylesheet" href="/0.4.2/@zurich/web-components/styles.css" />
<script type="module" src="/0.4.2/@zurich/web-components/checkbox-group.js"></script>
Code
html
<z-checkbox-group label="Checkbox group"
  options='[{ "text": "Option A" },{ "text": "Option B" },{ "text": "Option C" },{ "text": "Option D", "disabled": "true" }]'></z-checkbox-group>