Skip to content

Checkbox select - Web Component

The CheckboxSelect component can be used imported from:

Playground

Parameters

...

Events

This component has events. Check the documentation about how to use the events.

NamePayloadDescription
changestring[]Returns the new value of the "value" attribute
restartedvoidEmitted on value reset

Slots

This component has slots. Check the documentation about how to use the slots.

NameTagsDescription
labelspan

Parameters use

options

The z-checkbox-select component accepts an options attribute to set the options of the component. The options attribute should be an array of objects with the following properties:

  • text (string): The text label of the checkbox.
  • value (string): The value of the checkbox.
  • disabled (boolean): Whether the checkbox is disabled.

We can use <option> tags to define the values of options

label

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

model

The z-checkbox-select component accepts a value attribute to set the value of the component. The value attribute should be an array of booleans, matching the number of options.

name

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

Flags

disabled

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

required

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

invalid

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

TIP

The difference between the CheckboxSelect and the CheckboxGroup components is that, in the CheckboxSelect component, returns an array of values, while the CheckboxGroup component returns an array of booleans.

Methods

reset()

We can all the reset() method of the WebComponent in order to reset the value. This will clean the internal states and emit the nullable value with the change event, plus a restarted event:

In this example, the button triggers the method:

Value:  []

The reset is done to an empty array.

Browser support

Detected engine:  

  • Chromium

  • Webkit

  • Gecko

HTML Examples

CodeSandbox example