Skip to content

Stage

Example of an stage component

The stage represents our main header component. It is a great way to highlight important content at the top of a page, together with the safe space and the usage of an inclusive color, it is a good visual representation of our brand identity and visual language. There are adapted versions of the stage component covering all breakpoints (Desktop, Tablet Landscape, Tablet Portrait and Mobile).

It should have a strong focus and visual interest and can be used in a variety of ways: only with copy and without action, with a button or a link or even with a dropdown.

UX/UI Guidelines

Check the design documentation of the component in ZeroHeight.

Implementations

The component Stage is available in the following technologies:

CSS Components
cssreactvue
Web Components
webreactvueangular

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:

NameTypeSlotDescription
contentstringThe stage content
headerstringHeader of the stage
configstringConfiguration of the stage
image-srcstringURL of the image
image-altstringAlt text of the image
no-safe-spacebooleanWhether to use safe space
shapestringShape to use for the stage
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-stage 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-stage custom-str="fill:#06e7a3" />
z-themestring

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

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

From Figma to code

...

Customization

INFO

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

CSS VariableTypeDescription
--z-stage--bgcolorBackground color of the stage
--z-stage--bg--mobilecolorBackground color of the stage on mobile
--z-stage--colorcolorText color of the stage
--z-stage--color--mobilecolorText color of the stage on mobile
--z-stage--gapdistanceGap between elements in the stage

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

Additionally, you can change background and text color for mobile using the --z-stage--bg-mobile and --z-stage--color-mobile CSS custom properties.

Finally, the gap between elements can be customized using the --z-stage--gap CSS custom property.

Example of an stage component

Accessibility

...