Skip to content

Boolean icon

Boolean icon is a clickable action icon used to mark something to allow the user to save, organize and access this content efficiently.

Implementations

The component BooleanIcon is available in the following technologies:

CSS Components
cssreactvue
Web Components
webreactvueangular

Parameters

Parameters

Make sure you have read about the parameters in here.

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

NameTypeSlotDescription
configstring

Icon set to be used as a checkbox. The possible values are:

  • star
  • heart
  • bookmark
  • like
  • dislike
  • lock
  • unlock
  • mute
  • unmute
  • sound-on
  • sound-off
  • visible
  • invisible
labelstringLabel of the input
modelboolean

Value of the model

checkedbooleanOverrides the "value" parameter as in the standard
disabledboolean

Blocks the interaction with the input component by using the disabled attribute of the HTML input element.

requiredboolean

Marks the input component as required. If and interaction is made with the input and the value is nullable or empty, the input will be marked as invalid as using the invalid attribute.

namestring

Identification for the field inside the form.

help-textstring

The forced message to be shown under the input. It is used to give more information about the input, or a message to the user, specially when the input is invalid.

invalidboolean

The attribute that forces the state of the input as invalid.

localestring

The locale parameter is used to set the locale of the component. The value must be part of the registered locales in ZDS. If not set, the default locale of the document will be used.

Have a look to the localization mechanisms.

customobject

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:

html
<z-boolean-icon custom='{"fill":"#06e7a3"}' />

Check the available values in the customization section.

custom-strstring

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:

html
<z-boolean-icon custom-str="fill:#06e7a3" />
z-themestring

Sets the theme of the component. The possible values are light and dark.

html
<z-boolean-icon z-theme="dark" />

From Figma to code

Not available yet

This component is yet not available in Figma

Customization

INFO

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

CSS VariableTypeDescription
--z-boolean-icon--colorcolorAccent color
--z-boolean-icon--color--offcolorAccent color when off
--z-boolean-icon--sizedistanceSize of the icon

The color and size of the BooleanIcon can be customized using the --z-boolean-icon--color and --z-boolean-icon--size CSS custom properties, respectively.

Also you can customize the off color using the --z-boolean-icon--color--off CSS custom property.

Accessibility

...