Skip to content 
Select
Multiselect - Web Component
The Multiselect component can be used imported from:
Playground
Parameters
The Web component uses the <z-multiselect> 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:
| Name | Type | Description | Slot | A11y |
|---|---|---|---|---|
config | string | ... | ||
label | string | Label of the input | label | |
placeholder | string | Placeholder of the input | ||
readonly | boolean | Transforms the input into an output | ||
autocomplete | string | Automated assistance in filling out form field values | ||
model | string[] | Value of the model | ||
disabled | boolean | Blocks the interaction with the input component. | ||
required | boolean | Marks the input component as required. | ||
name | string | Identification for the field inside the form | ||
help-text | string | The forced message to be shown under the input | help-text | |
invalid | boolean | The forced state for set the input as invalid |
Events
This component has events. Check the documentation about how to use the events.
| Name | Payload | Description |
|---|---|---|
change | string[] | Returns the new value of the "value" attribute |
restarted | void | Emitted on value reset |
Slots
This component has slots. Check the documentation about how to use the slots.
| Name | Tags | Description |
|---|---|---|
default | span |
Parameters use
model
Controls the selected value of the input. The value needs to be one of the provided via options:
config
The config parameter is used to set the shape of the input between lined and shaped. Being omitted will render the default line shape.
label
The label parameter is used to set the text label of the component. Make sure you always use it.
Can also use the label slot:
help-text
The help-text parameter is used to provide additional assistance to the user.
name
The name parameter is used to set the name of the component. This is useful when the component is part of a form.
options
The options attribute is an array of objects that represent the chips. Each object inside the array should have the following properties:
text: The text that will be displayed inside the chip.value: The value of the option.disabled: A boolean that indicates if the chip is disabled.
We can use <option> tags to define the values of options
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:
[]Browser support
Detected engine:
Chromium
Webkit
Gecko