View on GitHub

Spinners (スピナー)

HTML、CSS、JavaScript を使用せずに完全に構築された Spinners (スピナー) を使用して、コンポーネントやページの読み込み状態を表示します。

On this page

About

プロジェクトの読み込み状態を表示するために使用することができます。それらはHTMLとCSSだけで構築されているので、JavaScriptを必要としません。可視性を切り替える場合は、いくつかのカスタムJavaScriptが必要になります。外観、配置、サイズは、utility (ユーティリティ) クラスを使用して簡単にカスタマイズすることができます。

アクセシビリティの観点から、 role="status" と入れ子になった <span class="visually-hidden">Loading...</span> を含んでいます。

The animation effect of this component is dependent on the prefers-reduced-motion media query. See the reduced motion section of our accessibility documentation.

Border spinner

Border spinner (ボーダースピナー) を使用して軽量なローディングインジケーターを実現します。

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

Colors

border-color に currentColor を使用します。標準のスピナーでは、text color utilities を使用することができます。

<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} ユーティリティはそれをオーバーライドします。

Growing spinner

grow spinner (グロースピナー) も用意されています。動きは下記を参考にしてください。

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

currentColorで構築されているため、text color utilities で色を変更した場合は下記を参考にしてください。

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

Alignment

rem, currentColor, display: inline-flex で構築されています。簡単にサイズを変更したり、色を変更したり、素早く整列させることができます。

Margin

.m-5 (margin utilities) で簡単にスペースを追加できます。

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

Placement

flexbox utilities, float utilities, text alignment を使用して、配置することができます。

Flex

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

Loading...

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

Floats

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

Text align

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

Size

.spinner-border-sm と .spinner-grow-sm を追加して、サイズの変更ができます。

<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やインラインスタイルを使用して、必要に応じて寸法を変更することができます。

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

Buttons

ボタンの中でスピナーを使用して、アクションが現在処理中または実行中であることを示します。

<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">Loading...</span>
</button>
<button class="btn btn-primary" type="button" disabled>
  <span class="spinner-border spinner-border-sm" role="status" aria-hidden="true"></span>
  Loading...
</button>

<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">Loading...</span>
</button>
<button class="btn btn-primary" type="button" disabled>
  <span class="spinner-grow spinner-grow-sm" role="status" aria-hidden="true"></span>
  Loading...
</button>