ProgressBar

Progress bars provide a visual feedback on the progression of a process, expressed as a percentage value. Processes visualized in progress bars do not have defined step and their duration and completion depend on the system - e.g. downloads, uploads or installations.

UX/UI Guidelines

Check the design documentation of the component in ZeroHeight.

Implementations

The component ProgressBar is available in the following technologies:

CSS Components

Web Components

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:

Name	Type	Slot	Description
progress [required]	number		The current value of the progress bar
config	string		The configuration of the progress bar
progress-bar-title	string		The title of the progress bar
no-percentage	boolean		Removes the percentage indication
invalid	boolean		Invalid state
highlight	boolean		Highlight state
max	number		The maximum value of the progress bar
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-progress-bar custom='{"fill":"#06e7a3"}' /> Check the available values in the customization section.
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-progress-bar custom-str="fill:#06e7a3" />
z-theme	string		Sets the theme of the component. The possible values are light and dark. <z-progress-bar 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-progress-bar--color	color	Main color
--z-progress-bar--title-color	color	Header color
--z-progress-bar--percentage-color	color	Percentage color
--z-progress-bar--bg	color	Background color
--z-progress-bar--track	color	Track color
--z-progress-bar--size	distance
--z-progress-bar--stroke	distance

You can customize the color and track color of the progress bar using the z-progress-bar--color and z-progress-bar--track CSS custom properties, respectively. Also you can customize the stroke width using the z-progress-bar--stroke CSS custom property.

The title color and percentage color can be customized using the z-progress-bar--title and z-progress-bar--percentage-color CSS custom properties, respectively.