Spinnerit

Ilmoita komponentin tai sivun lataustila Bootstrap-spinnereillä, jotka on rakennettu kokonaan HTML-, CSS- ja ilman JavaScriptiä.

Tällä sivulla

Noin

Bootstrapin "spinnereitä" voidaan käyttää näyttämään lataustilan projekteissasi. Ne on rakennettu vain HTML:llä ja CSS:llä, joten et tarvitse JavaScriptiä niiden luomiseen. Tarvitset kuitenkin mukautetun JavaScriptin muuttaaksesi niiden näkyvyyttä. Niiden ulkonäköä, kohdistusta ja kokoa voidaan helposti muokata upeilla hyödyllisyysluokillamme.

Esteettömyyssyistä jokainen lataaja sisältää role="status"ja sisäkkäisen <span class="visually-hidden">Loading...</span>.

Tämän komponentin animaatiovaikutus riippuu prefers-reduced-motionmediakyselystä. Katso esteettömyysdokumentaation osio liikkeen vähentämisestä .

Reunapyörä

Käytä reunapyöriä kevyeen lastausilmaisimeen.

html

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

värit

Reunusspinneri käyttää currentColorsitä border-color, mikä tarkoittaa, että voit muokata väriä tekstin väriapuohjelmilla . Voit käyttää mitä tahansa tekstin värityökalujamme tavallisessa kehrässä.

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>

Mikset käyttäisi border-colorapuohjelmia? Jokainen reunuspyöritys määrittää transparentreunuksen ainakin yhdelle puolelle, joten .border-{color}apuohjelmat ohittavat sen.

Kasvava spinner

Jos et pidä reunuspyöristä, vaihda viljelyspinneriin. Vaikka se ei teknisesti pyöri, se kasvaa toistuvasti!

html

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

Jälleen kerran tämä spinner on rakennettu currentColor-sovelluksella, joten voit helposti muuttaa sen ulkonäköä tekstin väriapuohjelmilla . Tässä se on sinisenä tuettujen varianttien kanssa.

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>

Tasaus

Bootstrapin spinnerit on rakennettu rems:llä, currentColor, ja display: inline-flex. Tämä tarkoittaa, että niiden kokoa voidaan helposti muuttaa, värjätä uudelleen ja kohdistaa nopeasti.

Marginaali

Käytä marginaalin apuohjelmia , kuten .m-5helpottaaksesi välilyöntejä.

html

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

Sijoitus

Käytä flexbox-apuohjelmia , float-apuohjelmia tai tekstin tasausapuohjelmia sijoittaaksesi spinnerit juuri sinne, missä tarvitset niitä missä tahansa tilanteessa.

Flex

html

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

Ladataan...

html

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

Kelluvat

html

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

Tekstin tasaus

html

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

Koko

Lisää .spinner-border-smja .spinner-grow-smtee pienempi spinner, jota voidaan nopeasti käyttää muiden komponenttien sisällä.

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>

Tai käytä mukautettuja CSS- tai sisäisiä tyylejä muuttaaksesi mittoja tarpeen mukaan.

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>

Painikkeet

Käytä painikkeiden sisällä olevia pyöriä osoittamaan, että toiminto on parhaillaan käsittelyssä tai meneillään. Voit myös vaihtaa tekstin pois spinner-elementistä ja käyttää painikkeen tekstiä tarpeen mukaan.

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

Muuttujat

Lisätty versioon 5.2.0

Osana Bootstrapin kehittyvää CSS-muuttujien lähestymistapaa spinnerit käyttävät nyt paikallisia CSS-muuttujia .spinner-bordertehostettuun .spinner-growreaaliaikaiseen mukauttamiseen. CSS-muuttujien arvot asetetaan Sassin kautta, joten myös Sass-räätälöinti on edelleen tuettu.

Reunuspyörän muuttujat:

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

Kasvavat spinnerin muuttujat:

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

Molemmissa spinnereissa käytetään pieniä spinner-muokkausluokkia näiden CSS-muuttujien arvojen päivittämiseen tarpeen mukaan. Esimerkiksi .spinner-border-smluokka tekee seuraavaa:

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

Sass muuttujat

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

Avainkehykset

Käytetään CSS-animaatioiden luomiseen spinnereillemme. Mukana scss/_spinners.scss.

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

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