On this page

Angular Progress Component

Documentation and examples for using Angular progress bars featuring support for stacked bars, animated backgrounds, and text labels.

Examples

Progress components are built with two HTML elements, some CSS to set the width, and a few attributes. We don't use the HTML5 <progress> element, ensuring you can stack progress bars, animate them, and place text labels over them.

New markup in CoreUI v5

We’ve simplified the HTML structure for progress bars to improve accessibility while still maintaining backward compatibility with the previous structure.

Basic usage

Labels

Add labels to your progress bars by placing text within the <c-progress>.

25%

Long label text for the progress bar, set it to a dark color...

Please take note that the default setting for the <c-progress> content is to be limited by the overflow: hidden property. This is done to prevent the content from extending beyond the progress bar's boundaries. However, if the progress bar is shorter than its label, the content may be truncated and become difficult to read. To modify this behavior, you can use the .overflow-visible class from the overflow utilities. Just make sure to specify a specific text color to ensure readability. Do keep in mind that this approach does not consider color modes at the moment.

Height

We only set a height value on the <c-progress>, so if you change that value, the inner <c-progress-bar> will automatically resize accordingly.

Backgrounds

Use color prop to change the appearance of individual progress bars.

It is important to choose an appropriate text color when incorporating labels into progress bars with a custom background color. This ensures readability and adequate contrast for the labels.

25%

75%

Multiple bars

New markup in CoreUI v5

We added a new stacked component to group multiple progress bars into a single stacked progress bar.

Include multiple progress bars in a <c-progress-stacked> component to create a single stacked progress bar.

Striped

Add variant="striped" to any <c-progress> to apply a stripe via CSS gradient over the progress bar's background color.

Animated stripes

The striped gradient can also be animated. Add animated property to <c-progress> to animate the stripes right to left via CSS3 animations.

Thin

Thin variant of progress

Styling

Learn how to customize the Angular Progress component with CSS classes, variables, and SASS for flexible styling and seamless integration into your design.

CSS variables

Angular Progress supports CSS variables for easy customization. These variables are set via SASS but allow direct overrides in your stylesheets or inline styles.

How to use CSS variables

SASS variables

Accessibility

The Angular Progress component is built with accessibility in mind. Each progressbar includes the following ARIA attributes:

role: progressbar
aria-valuemin: Minimum value
aria-valuemax: Maximum value
aria-valuenow: Current value

API reference

Progress Module

Progress Standalone

c-progress

component

Inputs

name	description	type	default
`thin`	Displays thin progress.	`boolean`	`false`
`white`	Change the default color to white.	`boolean`	`false`
`height`	Sets the height of the component. If you set that value the inner `c-progress-bar` will automatically resize accordingly.	`number`
`animated`	Use to animate the stripes right to left via CSS3 animations.	`boolean`	`false`
`color`	Sets the color context of the component to one of CoreUI’s themed colors.	`string`
`role`	Set default html role attribute.	`string`	`'progressbar'`
`value`	The percent to progress the ProgressBar.	`number`	`0`
`variant`	Set the progress bar variant to optional striped.	`"striped"`

c-progress-bar

for backward compatibility

Inputs

name	description	type	default
`animated`	Use to animate the stripes right to left via CSS3 animations.	`boolean`	`false`
`color`	Sets the color context of the component to one of CoreUI’s themed colors.	`string`
`role`	Set default html role attribute.	`string`	`'progressbar'`
`value`	The percent to progress the ProgressBar.	`number`	`0`
`variant`	Set the progress bar variant to optional striped.	`"striped"`