Оригинал На GitHub

Состояние загрузки

Укажите состояние загрузки компонента или страницы с помощью волчков Bootstrap, полностью построенных с использованием HTML, CSS и без JavaScript.

На этой странице

Обзор

Bootstrap «спиннеры» можно использовать для отображения состояния загрузки в Ваших проектах. Они построены только с помощью HTML и CSS, а это значит, что для их создания не нужен JavaScript. Однако Вам понадобится специальный JavaScript, чтобы переключить их видимость. Их внешний вид, расположение и размер можно легко настроить с помощью наших замечательных служебных классов.

Для удобства здесь каждый загрузчик включает в себя role="status" и вложенный <span class="visually-hidden">Загрузка...</span>.

Эффект анимации этого компонента зависит от медиазапроса prefers-reduced-motion. См. раздел с уменьшенным движением в нашей документации по специальным возможностям.

Спиннер с границей

Используйте спиннеры с границей для легкого индикатора загрузки.

html

<div class="spinner-border" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>

Цвета

Спиннер с границей использует currentColor в качестве своего border-color, что означает, что Вы можете настроить цвет с помощью утилит цвета текста. Вы можете использовать любую из наших утилит цвета текста на стандартном спиннере.

html

<div class="spinner-border text-primary" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-border text-secondary" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-border text-success" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-border text-danger" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-border text-warning" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-border text-info" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-border text-light" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-border text-dark" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>

Почему бы не использовать утилиты border-color? Каждая граница определяет transparent границу по крайней мере для одной стороны, поэтому утилиты .border-{color} переопределят это.

Увеличивающийся спиннер

Если Вам не нравится спиннер с границами, переключитесь на увеличивающийся спиннер. Хотя технически он не вращается, он постоянно растет!

html

<div class="spinner-grow" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>

Опять же, этот спиннер построен с помощью currentColor, так что Вы можете легко изменить его внешний вид с помощью утилит цвета текста. Здесь он выделен синим цветом вместе с поддерживаемыми вариантами.

html

<div class="spinner-grow text-primary" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-grow text-secondary" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-grow text-success" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-grow text-danger" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-grow text-warning" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-grow text-info" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-grow text-light" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-grow text-dark" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>

Выравнивание

Спиннеры в Bootstrap построены с помощью rem, currentColor и display: inline-flex. Это означает, что их можно легко изменить размер, перекрасить и быстро выровнять.

Поля

Используйте утилиты полей, например, .m-5, чтобы упростить интервалы.

html

<div class="spinner-border m-5" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>

Размещение

Используйте flexbox утилиты, float утилиты или утилиты выравнивание текста для размещения спиннеров именно там, где они вам нужны в любой ситуации.

Флексы

html

<div class="d-flex justify-content-center">
  <div class="spinner-border" role="status">
    <span class="visually-hidden">Загрузка...</span>
  </div>
</div>

Загрузка...

html

<div class="d-flex align-items-center">
  <strong>Загрузка...</strong>
  <div class="spinner-border ms-auto" role="status" aria-hidden="true"></div>
</div>

Флоаты

html

<div class="clearfix">
  <div class="spinner-border float-end" role="status">
    <span class="visually-hidden">Загрузка...</span>
  </div>
</div>

Выравнивание текста

html

<div class="text-center">
  <div class="spinner-border" role="status">
    <span class="visually-hidden">Загрузка...</span>
  </div>
</div>

Размер

Добавьте .spinner-border-sm и .spinner-grow-sm, чтобы получить спиннер меньшего размера, который можно быстро использовать в других компонентах.

html

<div class="spinner-border spinner-border-sm" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-grow spinner-grow-sm" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>

Или используйте собственный CSS или встроенные стили, чтобы изменить размеры по мере необходимости.

html

<div class="spinner-border" style="width: 3rem; height: 3rem;" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>
<div class="spinner-grow" style="width: 3rem; height: 3rem;" role="status">
  <span class="visually-hidden">Загрузка...</span>
</div>

Кнопки

Используйте спиннеры внутри кнопок, чтобы указать, что действие в настоящее время обрабатывается или выполняется. Вы также можете поменять местами текст из элемента спиннер и использовать текст кнопки по мере необходимости.

html

<button class="btn btn-primary" type="button" disabled>
  <span class="spinner-border spinner-border-sm" role="status" aria-hidden="true"></span>
  <span class="visually-hidden">Загрузка...</span>
</button>
<button class="btn btn-primary" type="button" disabled>
  <span class="spinner-border spinner-border-sm" role="status" aria-hidden="true"></span>
  Загрузка...
</button>

html

<button class="btn btn-primary" type="button" disabled>
  <span class="spinner-grow spinner-grow-sm" role="status" aria-hidden="true"></span>
  <span class="visually-hidden">Загрузка...</span>
</button>
<button class="btn btn-primary" type="button" disabled>
  <span class="spinner-grow spinner-grow-sm" role="status" aria-hidden="true"></span>
  Загрузка...
</button>

CSS

Переменные

Добавлено в версии 5.2.0

Как часть развивающегося подхода Bootstrap к переменным CSS, спиннеры теперь используют локальные переменные CSS в .spinner-border и .spinner-grow для расширенной настройки в реальном времени. Значения переменных CSS задаются через Sass, поэтому настройка Sass по-прежнему поддерживается.

Переменные границ спиннера:

  --#{$prefix}spinner-width: #{$spinner-width};
  --#{$prefix}spinner-height: #{$spinner-height};
  --#{$prefix}spinner-vertical-align: #{$spinner-vertical-align};
  --#{$prefix}spinner-border-width: #{$spinner-border-width};
  --#{$prefix}spinner-animation-speed: #{$spinner-animation-speed};
  --#{$prefix}spinner-animation-name: spinner-border;

Переменные растущего спиннера:

  --#{$prefix}spinner-width: #{$spinner-width};
  --#{$prefix}spinner-height: #{$spinner-height};
  --#{$prefix}spinner-vertical-align: #{$spinner-vertical-align};
  --#{$prefix}spinner-animation-speed: #{$spinner-animation-speed};
  --#{$prefix}spinner-animation-name: spinner-grow;

Для обоих спиннеров используются небольшие классы модификаторов спинера для обновления значений этих переменных CSS по мере необходимости. Например, класс .spinner-border-sm делает следующее:

  --#{$prefix}spinner-width: #{$spinner-width-sm};
  --#{$prefix}spinner-height: #{$spinner-height-sm};
  --#{$prefix}spinner-border-width: #{$spinner-border-width-sm};

Переменные Sass

$spinner-width:           2rem;
$spinner-height:          $spinner-width;
$spinner-vertical-align:  -.125em;
$spinner-border-width:    .25em;
$spinner-animation-speed: .75s;

$spinner-width-sm:        1rem;
$spinner-height-sm:       $spinner-width-sm;
$spinner-border-width-sm: .2em;

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

Используется для создания анимации CSS для наших спиннеров. Включен в scss/_spinners.scss.

@keyframes spinner-border {
  to { transform: rotate(360deg) #{"/* rtl:ignore */"}; }
}

@keyframes spinner-grow {
  0% {
    transform: scale(0);
  }
  50% {
    opacity: 1;
    transform: none;
  }
}