2014-07-12 00:45:11 +02:00
---
2015-08-15 07:45:55 +02:00
layout: docs
2014-07-12 00:45:11 +02:00
title: Progress
2016-10-03 03:19:47 +02:00
description: Documentation and examples for using Bootstrap progress bars.
2015-08-06 02:47:45 +02:00
group: components
2014-07-12 00:45:11 +02:00
---
2015-08-21 07:02:54 +02:00
Stylize [the HTML5 `<progress>` element ](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/progress ) with a few extra classes and some crafty browser-specific CSS. Be sure to read up on the browser support.
2014-07-12 00:45:11 +02:00
2015-05-29 10:58:52 +02:00
## Contents
* Will be replaced with the ToC, excluding the "Contents" header
{:toc}
2016-08-22 02:18:38 +02:00
## Example
2014-07-12 00:45:11 +02:00
2016-02-08 09:31:10 +01:00
To caption a progress bar, simply add a `<div>` with your caption text, [align the text using a utility class ]({{ site.baseurl }}/components/utilities/#text-alignment ), and associate the caption with the `<progress>` element using the `aria-describedby` attribute.
2014-07-12 00:45:11 +02:00
{% example html %}
2016-02-07 22:13:06 +01:00
< div class = "text-xs-center" id = "example-caption-1" > Reticulating splines… 0%< / div >
< progress class = "progress" value = "0" max = "100" aria-describedby = "example-caption-1" > < / progress >
< div class = "text-xs-center" id = "example-caption-2" > Reticulating splines… 25%< / div >
< progress class = "progress" value = "25" max = "100" aria-describedby = "example-caption-2" > < / progress >
< div class = "text-xs-center" id = "example-caption-3" > Reticulating splines… 50%< / div >
< progress class = "progress" value = "50" max = "100" aria-describedby = "example-caption-3" > < / progress >
< div class = "text-xs-center" id = "example-caption-4" > Reticulating splines… 75%< / div >
< progress class = "progress" value = "75" max = "100" aria-describedby = "example-caption-4" > < / progress >
< div class = "text-xs-center" id = "example-caption-5" > Reticulating splines… 100%< / div >
< progress class = "progress" value = "100" max = "100" aria-describedby = "example-caption-5" > < / progress >
2014-07-12 00:45:11 +02:00
{% endexample %}
2016-08-22 02:18:38 +02:00
## IE9 support
2014-07-12 00:45:11 +02:00
Internet Explorer 9 doesn't support the HTML5 `<progress>` element, but we can work around that.
{% example html %}
2016-02-07 22:13:06 +01:00
< div class = "text-xs-center" id = "example-caption-6" > Reticulating splines… 25%< / div >
< progress class = "progress" value = "25" max = "100" aria-describedby = "example-caption-6" >
2014-07-12 00:45:11 +02:00
< div class = "progress" >
2016-02-07 22:13:06 +01:00
< span class = "progress-bar" style = "width: 25%;" > < / span >
2014-07-12 00:45:11 +02:00
< / div >
< / progress >
{% endexample %}
2016-08-22 02:18:38 +02:00
## Contextual alternatives
2014-07-12 00:45:11 +02:00
Progress bars use some of the same button and alert classes for consistent styles.
{% example html %}
2016-02-08 09:31:10 +01:00
< progress class = "progress progress-success" value = "25" max = "100" > < / progress >
< progress class = "progress progress-info" value = "50" max = "100" > < / progress >
< progress class = "progress progress-warning" value = "75" max = "100" > < / progress >
< progress class = "progress progress-danger" value = "100" max = "100" > < / progress >
2014-07-12 00:45:11 +02:00
{% endexample %}
### Striped
Uses a gradient to create a striped effect.
{% example html %}
2016-02-08 09:31:10 +01:00
< progress class = "progress progress-striped" value = "10" max = "100" > < / progress >
< progress class = "progress progress-striped progress-success" value = "25" max = "100" > < / progress >
< progress class = "progress progress-striped progress-info" value = "50" max = "100" > < / progress >
< progress class = "progress progress-striped progress-warning" value = "75" max = "100" > < / progress >
< progress class = "progress progress-striped progress-danger" value = "100" max = "100" > < / progress >
2014-07-12 00:45:11 +02:00
{% endexample %}
2014-10-27 06:48:12 +01:00
### Animated stripes
The striped gradient can also be animated. Add `.progress-animated` to `.progress` to animate the stripes right to left via CSS3 animations.
2014-07-12 00:45:11 +02:00
2015-12-11 00:11:40 +01:00
**Animated progress bars do not work in IE9 and Opera 12** – as they don't support CSS3 animations – **nor in IE10+ and Microsoft Edge** – as they currently don't support CSS3 animations on the [`::-ms-fill` pseudo-element ](https://msdn.microsoft.com/en-us/library/windows/apps/hh465757.aspx ).
2014-07-12 00:45:11 +02:00
2015-04-16 23:07:20 +02:00
< div class = "bd-example" >
2016-02-08 09:31:10 +01:00
< progress class = "progress progress-striped" value = "25" max = "100" > < / progress >
2015-04-16 23:07:20 +02:00
< button type = "button" class = "btn btn-secondary bd-activate-animated-progressbar" data-toggle = "button" aria-pressed = "false" autocomplete = "off" >
2014-10-27 06:48:12 +01:00
Toggle animation
< / button >
< / div >
{% highlight html %}
2016-02-08 09:31:10 +01:00
< progress class = "progress progress-striped progress-animated" value = "25" max = "100" > < / progress >
2014-10-27 06:48:12 +01:00
{% endhighlight %}