Skip to content

Switch - Web Component

Browser support

Detected engine:  

  • Chromium

  • Webkit

  • Gecko

Parameters

The Web component uses the <z-switch> tag:

By default, all the parameters are optional or can be set in different, except for the ones marked as required

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

NameTypeDescriptionSlot
labelstringLabel of the inputlabel
valuebooleanValue of the model
checkedbooleanOverrides the "value" parameter as in the standard
invalid-textstringThe text to be shown when invalidinvalid-text
disabledbooleanBlocks the interaction with the input component.
requiredbooleanMarks the input component as required.
namestringIdentification for the field inside the form

The events emitted from the component are:

NamePayloadDescription
changebooleanReturns the new value of the "value" attribute
restartedvoidEmitted on value reset

The available slots for the component are:

NameTagsDescription
defaultspan

label

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

value & checked

Both value and checked parameters are used to set the value of the component.

disabled

The attribute disabled will block the interaction with the component.

And with labels:

required

The attribute required will set the component as required.

name

The name attribute is used to set the name of the component. This is useful when the component is inside a form.

invalid-text

The invalid-text attribute will set the component as invalid. Without label, the text won't be present but the switch will still be invalid,

Playground

Customization

HTML Examples

StackBlitz example