旋转器

使用 Bootstrap 旋转器指示组件或页面的加载状态，这些旋转器完全由 HTML、CSS 构建，且不使用 JavaScript。

本页内容

关于

Bootstrap “旋转器”可用于在项目中显示加载状态。它们仅使用 HTML 和 CSS 构建，这意味着您无需任何 JavaScript 即可创建它们。但是，您需要一些自定义 JavaScript 来切换它们的可见性。它们的外观、对齐方式和大小可以使用我们出色的实用程序类轻松自定义。

出于可访问性目的，此处的每个加载器都包含 role="status" 和嵌套的 <span class="visually-hidden">Loading...</span>。

此组件的动画效果取决于 prefers-reduced-motion 媒体查询。请参阅无障碍文档的减少运动部分。

边框旋转器

使用边框旋转器作为轻量级加载指示器。

html

<div class="spinner-border" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

颜色

边框旋转器使用 currentColor 作为其 border-color，这意味着您可以使用文本颜色实用程序自定义颜色。您可以在标准旋转器上使用我们任何的文本颜色实用程序。

html

<div class="spinner-border text-primary" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-secondary" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-success" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-danger" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-warning" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-info" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-light" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-dark" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

为什么不使用 border-color 实用程序？每个边框旋转器至少为一侧指定一个 transparent 边框，因此 .border-{color} 实用程序将覆盖它。

增长旋转器

如果您不喜欢边框旋转器，请切换到增长旋转器。虽然它在技术上没有旋转，但它确实会重复增长！

html

<div class="spinner-grow" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

同样，此旋转器使用 currentColor 构建，因此您可以使用文本颜色实用程序轻松更改其外观。以下是蓝色，以及支持的变体。

html

<div class="spinner-grow text-primary" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-secondary" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-success" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-danger" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-warning" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-info" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-light" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-dark" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

对齐

Bootstrap 中的加载指示器使用 rem、currentColor 和 display: inline-flex 构建。这意味着它们可以轻松调整大小、重新着色并快速对齐。

边距

使用边距实用工具，如 .m-5，轻松实现间距。

html

<div class="spinner-border m-5" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

放置

使用 flexbox 实用工具、float 实用工具或文本对齐实用工具，在任何情况下将加载指示器准确地放置在您需要的位置。

Flex

html

<div class="d-flex justify-content-center">
  <div class="spinner-border" role="status">
    <span class="visually-hidden">Loading...</span>
  </div>
</div>

加载中...

html

<div class="d-flex align-items-center">
  <strong role="status">Loading...</strong>
  <div class="spinner-border ms-auto" aria-hidden="true"></div>
</div>

浮动

html

<div class="clearfix">
  <div class="spinner-border float-end" role="status">
    <span class="visually-hidden">Loading...</span>
  </div>
</div>

文本对齐

html

<div class="text-center">
  <div class="spinner-border" role="status">
    <span class="visually-hidden">Loading...</span>
  </div>
</div>

大小

添加 .spinner-border-sm 和 .spinner-grow-sm 以生成一个较小的加载指示器，可以在其他组件中快速使用。

html

<div class="spinner-border spinner-border-sm" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow spinner-grow-sm" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

或者，根据需要使用自定义 CSS 或内联样式来更改尺寸。

html

<div class="spinner-border" style="width: 3rem; height: 3rem;" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow" style="width: 3rem; height: 3rem;" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

按钮

在按钮中使用加载指示器以指示当前正在处理或进行操作。您还可以将文本从加载指示器元素中交换出来，并根据需要使用按钮文本。

html

<button class="btn btn-primary" type="button" disabled>
  <span class="spinner-border spinner-border-sm" aria-hidden="true"></span>
  <span class="visually-hidden" role="status">Loading...</span>
</button>
<button class="btn btn-primary" type="button" disabled>
  <span class="spinner-border spinner-border-sm" aria-hidden="true"></span>
  <span role="status">Loading...</span>
</button>

html

<button class="btn btn-primary" type="button" disabled>
  <span class="spinner-grow spinner-grow-sm" aria-hidden="true"></span>
  <span class="visually-hidden" role="status">Loading...</span>
</button>
<button class="btn btn-primary" type="button" disabled>
  <span class="spinner-grow spinner-grow-sm" aria-hidden="true"></span>
  <span role="status">Loading...</span>
</button>

CSS

变量

在 v5.2.0 中添加

作为 Bootstrap 不断发展的 CSS 变量方法的一部分，加载指示器现在在 .spinner-border 和 .spinner-grow 上使用本地 CSS 变量，以增强实时自定义。CSS 变量的值通过 Sass 设置，因此 Sass 自定义仍然受支持。

边框加载指示器变量

scss/_spinners.scss

--#{$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;

增长 spinner 变量

scss/_spinners.scss

--#{$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;

对于两个 spinner，小 spinner 修改器类用于根据需要更新这些 CSS 变量的值。例如，.spinner-border-sm 类执行以下操作

scss/_spinners.scss

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

Sass 变量

scss/_variables.scss

$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;

关键帧

用于为我们的 spinner 创建 CSS 动画。包含在 scss/_spinners.scss 中。

scss/_spinners.scss

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

scss/_spinners.scss

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