mirror of
https://github.com/primer/css.git
synced 2024-12-25 07:03:35 +03:00
6b6e89a8bf
* use standard lifecyle milestones for statuses * Create neat-laws-matter.md
74 lines
2.7 KiB
Markdown
74 lines
2.7 KiB
Markdown
---
|
|
title: Progress
|
|
path: components/progress
|
|
status: Beta
|
|
source: 'https://github.com/primer/css/tree/main/src/progress'
|
|
bundle: progress
|
|
---
|
|
|
|
Use progress components to visualize task completion. The `Progress` class adds a background color and aligns its children horizontally with flexbox. The children (`Progress-item`) should be individually colored with [background utilities](/utilities/colors#background-colors) and sized with inline `width` styles in percentages. Overflow is hidden, so children that overflow will be clipped.
|
|
|
|
```html live
|
|
<span class="Progress">
|
|
<span class="Progress-item color-bg-success-inverse" style="width: 50%;"></span>
|
|
</span>
|
|
```
|
|
|
|
## Large progress
|
|
|
|
Large progress bars are slightly taller than the default.
|
|
|
|
```html live
|
|
<span class="Progress Progress--large">
|
|
<span class="Progress-item color-bg-success-inverse" style="width: 50%;"></span>
|
|
</span>
|
|
```
|
|
|
|
## Small progress
|
|
|
|
Small progress bars are shorter than the default.
|
|
|
|
```html live
|
|
<span class="Progress Progress--small">
|
|
<span class="Progress-item color-bg-success-inverse" style="width: 50%;"></span>
|
|
</span>
|
|
```
|
|
|
|
## Inline progress
|
|
|
|
For inline progress indicators, use the `Progress` and `d-inline-flex` with an inline element such as `<span>` and add a custom `width` style:
|
|
|
|
```html live
|
|
<span class="text-small color-text-secondary mr-2">4 of 16</span>
|
|
<span class="Progress d-inline-flex" style="width: 160px">
|
|
<span class="Progress-item color-bg-success-inverse" style="width: 25%"></span>
|
|
</span>
|
|
```
|
|
|
|
## Accessibility
|
|
|
|
In cases where it's not possible to describe the progress in text, provide an `aria-label` attribute that does so:
|
|
|
|
```html live
|
|
<div aria-label="tasks: 8 of 10 complete">
|
|
<span class="Progress">
|
|
<span class="Progress-item color-bg-success-inverse" style="width: 80%;"></span>
|
|
</span>
|
|
</div>
|
|
```
|
|
|
|
## Progress with multiple values
|
|
|
|
To show the progress of tasks in multiple states (such as "done", "in progress", and "open"), add the `Progress-item` class and a distinct background color utility. Then give each one a percentage width proportional to the total number. Children are stacked from left to right, so if your widths add up to 100%, your bars will too. Note that items with very low percentage values might not be visible if they are smaller than `1px` in width.
|
|
|
|
```html live
|
|
<div class="tooltipped tooltipped-n" aria-label="tasks: 80 done, 14 in progress, 6 open">
|
|
<span class="Progress">
|
|
<span class="Progress-item color-bg-success-inverse" style="width: 50%;"></span>
|
|
<span class="Progress-item color-bg-warning-inverse" style="width: 25%;"></span>
|
|
<span class="Progress-item color-bg-danger-inverse" style="width: 15%;"></span>
|
|
<span class="Progress-item color-bg-info-inverse" style="width: 10%;"></span>
|
|
</span>
|
|
</div>
|
|
```
|