Skip to content

Promo

Promotional content Go to Promotion

Promo is a component meant to highlight a specific topic, make the users curious and lead them to related unabridged content. The choice of themes must be well considered to guide the users well in their journey through the website.

UX/UI Guidelines

Check the design documentation of the component in ZeroHeight.

Implementations

The component Promo 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
image-srcstring

The image-src is the URL of the image to be used.

image-altstring

Alternative text for image accessibility

cross-originstring

The crossorigin attribute of the image. Provides support for CORS, defining how the element handles cross-origin requests, thereby enabling the configuration of the CORS requests for the element's fetched data.

configstringConfiguration of the promo
headerstringHeader of the promo
shapestringShape of the promo
categorystringCategory of the promo
contentstringContent of the promo
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-promo 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-promo custom-str="fill:#06e7a3" />
z-themestring

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

html
<z-promo z-theme="dark" />

From Figma to code

You can check the Figma implementation here. This are the available properties:

  • Size select
  • Type select
  • Image select

Customization

INFO

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

CSS VariableTypeDescription
--z-promo--bgcolorBackground color for the promo
--z-promo--colorcolorText color for the promo

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

Promotional content

Accessibility

...