in English

Прагрэс

Дакументацыя і прыклады выкарыстання карыстальніцкіх індыкатараў прагрэсу Bootstrap з падтрымкай стэк-бараў, аніміраванага фону і тэкставых метак.

На гэтай старонцы

Як гэта працуе

Кампаненты Progress складаюцца з двух элементаў HTML, невялікай колькасці CSS для ўстаноўкі шырыні і некалькіх атрыбутаў. Мы не выкарыстоўваем элемент HTML5<progress> , гарантуючы, што вы можаце складаць індыкатары прагрэсу, анімаваць іх і размяшчаць над імі тэкставыя цэтлікі.

Мы выкарыстоўваем у .progressякасці абгорткі, каб паказаць максімальнае значэнне індыкатара выканання.
Мы выкарыстоўваем inner .progress-bar, каб паказаць прагрэс да гэтага часу.
Патрабуецца .progress-barўбудаваны стыль, службовы клас або карыстацкі CSS, каб задаць іх шырыню.
Таксама .progress-barпатрабуецца некаторыя атрыбуты roleі aria, каб зрабіць яго даступным.

Збярыце ўсё гэта разам, і вы атрымаеце наступныя прыклады.

<div class="progress">
  <div class="progress-bar" role="progressbar" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<div class="progress">
  <div class="progress-bar" role="progressbar" style="width: 25%" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<div class="progress">
  <div class="progress-bar" role="progressbar" style="width: 50%" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<div class="progress">
  <div class="progress-bar" role="progressbar" style="width: 75%" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<div class="progress">
  <div class="progress-bar" role="progressbar" style="width: 100%" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100"></div>
</div>

Bootstrap забяспечвае некалькі ўтыліт для ўстаноўкі шырыні . У залежнасці ад вашых патрэбаў, яны могуць дапамагчы ў хуткай канфігурацыі прагрэсу.

<div class="progress">
  <div class="progress-bar w-75" role="progressbar" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100"></div>
</div>

Этыкеткі

Дадайце этыкеткі на панэлі прагрэсу, размясціўшы тэкст у полі .progress-bar.

25%

<div class="progress">
  <div class="progress-bar" role="progressbar" style="width: 25%;" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">25%</div>
</div>

Вышыня

Мы ўсталёўваем heightзначэнне толькі для .progress, таму, калі вы зменіце гэтае значэнне, унутраны .progress-barпамер аўтаматычна зменіцца адпаведна.

<div class="progress" style="height: 1px;">
  <div class="progress-bar" role="progressbar" style="width: 25%;" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<div class="progress" style="height: 20px;">
  <div class="progress-bar" role="progressbar" style="width: 25%;" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
</div>

Фоны

Выкарыстоўвайце фонавыя класы ўтыліт, каб змяніць выгляд асобных індыкатараў прагрэсу.

<div class="progress">
  <div class="progress-bar bg-success" role="progressbar" style="width: 25%" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<div class="progress">
  <div class="progress-bar bg-info" role="progressbar" style="width: 50%" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<div class="progress">
  <div class="progress-bar bg-warning" role="progressbar" style="width: 75%" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<div class="progress">
  <div class="progress-bar bg-danger" role="progressbar" style="width: 100%" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100"></div>
</div>

Некалькі бараў

Уключыце некалькі індыкатараў прагрэсу ў кампанент прагрэсу, калі вам трэба.

<div class="progress">
  <div class="progress-bar" role="progressbar" style="width: 15%" aria-valuenow="15" aria-valuemin="0" aria-valuemax="100"></div>
  <div class="progress-bar bg-success" role="progressbar" style="width: 30%" aria-valuenow="30" aria-valuemin="0" aria-valuemax="100"></div>
  <div class="progress-bar bg-info" role="progressbar" style="width: 20%" aria-valuenow="20" aria-valuemin="0" aria-valuemax="100"></div>
</div>

Паласаты

Дадайце .progress-bar-stripedда любога .progress-bar, каб прымяніць паласу з дапамогай градыенту CSS да колеру фону панэлі прагрэсу.

<div class="progress">
  <div class="progress-bar progress-bar-striped" role="progressbar" style="width: 10%" aria-valuenow="10" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<div class="progress">
  <div class="progress-bar progress-bar-striped bg-success" role="progressbar" style="width: 25%" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<div class="progress">
  <div class="progress-bar progress-bar-striped bg-info" role="progressbar" style="width: 50%" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<div class="progress">
  <div class="progress-bar progress-bar-striped bg-warning" role="progressbar" style="width: 75%" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<div class="progress">
  <div class="progress-bar progress-bar-striped bg-danger" role="progressbar" style="width: 100%" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100"></div>
</div>

Аніміраваныя палоскі

Паласаты градыент таксама можа быць аніміраваны. Дадайце .progress-bar-animatedдля .progress-barанімацыі палос справа налева з дапамогай анімацыі CSS3.

<div class="progress">
  <div class="progress-bar progress-bar-striped progress-bar-animated" role="progressbar" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100" style="width: 75%"></div>
</div>

Сас

Пераменныя

$progress-height:                   1rem;
$progress-font-size:                $font-size-base * .75;
$progress-bg:                       $gray-200;
$progress-border-radius:            $border-radius;
$progress-box-shadow:               $box-shadow-inset;
$progress-bar-color:                $white;
$progress-bar-bg:                   $primary;
$progress-bar-animation-timing:     1s linear infinite;
$progress-bar-transition:           width .6s ease;

Ключавыя кадры

Выкарыстоўваецца для стварэння анімацыі CSS для .progress-bar-animated. Уваходзіць у scss/_progress-bar.scss.

@if $enable-transitions {
  @keyframes progress-bar-stripes {
    0% { background-position-x: $progress-height; }
  }
}