Files
webawesome/source/docs/progress-bars.md
2017-08-17 11:30:47 -04:00

130 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
layout: default.html
title: Progress Bars
description: These progress bars are easy to create and render consistently in all browsers.
---
## Progress Bars
HTML5 introduced the `<progress>` element, but its not currently possible to style consistently in all browsers. As a result, Shoelace offers a custom alternative.
Create a progress bar with the following markup. Use the `progress-[xs|sm|lg|xl]` modifiers to change the size. To set the state, use a [sizing utility](utilities.html#sizing-utilities) or set the width explicitly on the `progress-bar` element.
An optional text label can be included inside the `progress-bar` element.
```html
<div class="progress progress-xs">
<div class="progress-bar w-20">20%</div>
</div>
<div class="progress progress-sm">
<div class="progress-bar w-40">40%</div>
</div>
<div class="progress">
<div class="progress-bar w-60">60%</div>
</div>
<div class="progress progress-lg">
<div class="progress-bar w-70">80%</div>
</div>
<div class="progress progress-xl">
<div class="progress-bar w-100">100%</div>
</div>
```
<div class="progress progress-xs">
<div class="progress-bar w-20">20%</div>
</div>
<div class="progress progress-sm">
<div class="progress-bar w-40">40%</div>
</div>
<div class="progress">
<div class="progress-bar w-60">60%</div>
</div>
<div class="progress progress-lg">
<div class="progress-bar w-70">80%</div>
</div>
<div class="progress progress-xl">
<div class="progress-bar w-100">100%</div>
</div>
When progress cant be determined, use the `progress-indeterminate` modifier to set an indeterminate state.
```html
<div class="progress progress-indeterminate">
<div class="progress-bar"></div>
</div>
```
<div class="progress progress-indeterminate">
<div class="progress-bar"></div>
</div>
### Variations
Use the `progress-*` modifier to create variations.
```html
<div class="progress progress-secondary">
<div class="progress-bar w-50">50%</div>
</div>
<div class="progress progress-success">
<div class="progress-bar w-50">50%</div>
</div>
<div class="progress progress-info">
<div class="progress-bar w-50">50%</div>
</div>
<div class="progress progress-warning">
<div class="progress-bar w-50">50%</div>
</div>
<div class="progress progress-danger">
<div class="progress-bar w-50">50%</div>
</div>
<div class="progress progress-light">
<div class="progress-bar w-50">50%</div>
</div>
<div class="progress progress-dark">
<div class="progress-bar w-50">50%</div>
</div>
```
<div class="progress progress-secondary">
<div class="progress-bar w-50">50%</div>
</div>
<div class="progress progress-success">
<div class="progress-bar w-50">50%</div>
</div>
<div class="progress progress-info">
<div class="progress-bar w-50">50%</div>
</div>
<div class="progress progress-warning">
<div class="progress-bar w-50">50%</div>
</div>
<div class="progress progress-danger">
<div class="progress-bar w-50">50%</div>
</div>
<div class="progress progress-light">
<div class="progress-bar w-50">50%</div>
</div>
<div class="progress progress-dark">
<div class="progress-bar w-50">50%</div>
</div>