Chip

Chip textChip text

Chips are interactive elements consisting of a keyword or phrase that users can select among a series of given options. Chips allow adding information into a dropdown. Multiple chips can be selected at the same time and each can be dismissed individually.

UX/UI Guidelines

Check the design documentation of the component in ZeroHeight.

Implementations

The component Chip is available in the following technologies:

CSS Components

Web Components

Native

Parameters

Parameters

Parameters are the attributes that can be used to customize the component when using it in a project. They apply to the WebComponents implementation and wrappers and to the Vue and React CSS implementations. Some parameters names change between the implementations, in order to follow the conventions of each technology and framework.

For example, the param model is named ngModel in Angular, modelValue in Vue, but stays as model in React.

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 params or properties:

Name	Type	Slottable	Description
content	string	✅	The text to be displayed in the chip.
disabled	boolean		Blocks the interaction with the component.
readonly	boolean		Transforms the chip into an output.
custom	object		A record of key-value pairs to set the CSS custom tokens. It's a complex attribute set as an JS object in stringified JSON format. Example: <z-chip custom='{"fill":"#06e7a3"}' />
custom-str	string		The stringified version of the custom property. It follows the pattern key:value;key:value;, with the possibility of setting multiple values and spaces between the punctuation characters. Example: <z-chip custom-str="fill:#06e7a3" />
z-theme	string		Sets the theme of the component. The possible values are light and dark. <z-chip z-theme="dark" />

From Figma to code

You can check the Figma implementation here.

Customization

INFO

Check everything about the customization mechanics in the "How it works" documentation.

CSS Variable	Type	Description
--z-chip--color	color	Foreground color
--z-chip--color--hover	color	Foreground color on hover
--z-chip--color--active	color	Foreground color on active
--z-chip--color--disabled	color	Foreground color on disabled
--z-chip--bg	color	Background color
--z-chip--bg--hover	color	Background color on hover
--z-chip--bg--active	color	Background color on active
--z-chip--bg--disabled	color	Background color on disabled

Both background and text color can be customized using the --z-chip--bg and --z-chip--color CSS custom properties respectively.

Chip text

Also, the hover state & active state can be customized using the --z-chip--bg--hover,--z-chip--color--hover and --z-chip--bg--active, --z-chip--color--active CSS custom properties respectively.

Chip text

Finally, you can also customize the disabled state using the --z-chip--bg--disabled and --z-chip--color--disabled CSS custom properties respectively.

Chip text

Related components