in English

Fonók

Egy komponens vagy oldal betöltési állapotának jelzése Bootstrap spinnerekkel, amelyek teljes egészében HTML-lel, CSS-sel és JavaScript nélkül készültek.

Ezen az oldalon

Ról ről

A Bootstrap „pörgetői” a projektek betöltési állapotának megjelenítésére használhatók. Csak HTML és CSS használatával készültek, ami azt jelenti, hogy nincs szükség JavaScriptre a létrehozásukhoz. A láthatóságuk váltásához azonban szüksége lesz néhány egyéni JavaScriptre. Megjelenésük, igazításuk és méretük egyszerűen testreszabható csodálatos használati osztályainkkal.

A kisegítő lehetőségek érdekében itt minden betöltő tartalmaz role="status"egy beágyazott <span class="visually-hidden">Loading...</span>.

Ennek az összetevőnek az animációs hatása a médialekérdezéstől függ prefers-reduced-motion. Tekintse meg akadálymentesítési dokumentációnk csökkentett mozgással foglalkozó részét .

Border spinner

Használja a szegélypörgőket egy könnyű töltésjelzőhöz.

html

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

Színek

A szegélyforgató ezt használja currentColor, border-colorami azt jelenti, hogy testreszabhatja a színt a szövegszín segédprogramokkal . Bármelyik szövegszín segédprogramunkat használhatja a szabványos pörgetőn.

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>

Miért nem használ border-colorsegédprogramokat? Minden szegélyforgató meghatároz egy transparentszegélyt legalább az egyik oldalhoz, így a .border-{color}segédprogramok ezt felülírják.

Növekvő fonó

Ha nem szereti a szegélytárcsát, váltson a növesztő fonóra. Bár technikailag nem forog, többször is nő!

html

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

Ez a pörgettyű ismét a -val készült , így a szövegszín segédprogramokkalcurrentColor egyszerűen megváltoztathatja a megjelenését . Itt kék színben, a támogatott változatokkal együtt.

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>

Igazítás

A Bootstrap spinnerei rems, currentColor, és display: inline-flex. Ez azt jelenti, hogy könnyen átméretezhetők, átszínezhetők és gyorsan igazíthatók.

Árrés

Használjon margó-segédprogramokat , mint például .m-5az egyszerű térközelítés érdekében.

html

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

Elhelyezés

Használjon flexbox segédprogramokat , float segédprogramokat vagy szövegigazító segédprogramokat, hogy minden helyzetben pontosan ott helyezze el a pörgetőket, ahol szüksége van rájuk.

Flex

html

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

Betöltés...

html

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

Úszók

html

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

Szöveg igazítás

html

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

Méret

Adjon hozzá .spinner-border-smés .spinner-grow-smkészítsen egy kisebb fonót, amely gyorsan használható más alkatrészekben.

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>

Vagy használjon egyéni CSS-t vagy belső stílusokat a méretek szükség szerinti módosításához.

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>

Gombok

A gombokon belüli pörgettyűkkel jelezheti, hogy egy művelet folyamatban van vagy folyamatban van. A szöveget ki is cserélheti a pörgető elemből, és szükség szerint használhatja a gombszöveget.

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

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

CSS

Változók

Hozzáadva a v5.2.0-hoz

A Bootstrap fejlődő CSS-változókra vonatkozó megközelítésének részeként a spinnerek helyi CSS-változókat használnak .spinner-bordera .spinner-growtovábbfejlesztett valós idejű testreszabás érdekében. A CSS-változók értékeit a Sass segítségével állítjuk be, így a Sass testreszabása továbbra is támogatott.

Border spinner változók:

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

Növekvő spinner változók:

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

Mindkét fonó esetében kis pörgetőmódosító osztályokat használnak a CSS-változók értékeinek szükség szerinti frissítéséhez. Például az .spinner-border-smosztály a következőket teszi:

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

Sass változók

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

Kulcskockák

Pörgetőink CSS-animációinak létrehozására szolgál. Tartalmazza scss/_spinners.scss.

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

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