in English

Vrtavke

Označite stanje nalaganja komponente ali strani z vrtljivkami Bootstrap, ki so v celoti zgrajene s HTML, CSS in brez JavaScripta.

Na tej strani

O tem

Za prikaz stanja nalaganja v vaših projektih se lahko uporabijo »vrteče« Bootstrap. Zgrajeni so samo s HTML in CSS, kar pomeni, da za njihovo ustvarjanje ne potrebujete JavaScripta. Za preklop njihove vidnosti pa boste potrebovali nekaj JavaScripta po meri. Njihov videz, poravnavo in velikost je mogoče enostavno prilagoditi z našimi neverjetnimi razredi uporabnosti.

Za namene dostopnosti vsak nalagalnik tukaj vključuje role="status"in ugnezdeni <span class="visually-hidden">Loading...</span>.

Učinek animacije te komponente je odvisen od prefers-reduced-motionmedijske poizvedbe. Oglejte si razdelek o zmanjšanem gibanju v naši dokumentaciji o dostopnosti .

Obrobni vrtavec

Uporabite obrobne vrtavke za indikator lahkega nakladanja.

html

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

Barve

Obrobni vrtavec uporablja currentColorza svoje border-color, kar pomeni, da lahko prilagodite barvo s pripomočki za barvo besedila . Uporabite lahko katerega koli od naših pripomočkov za barvo besedila na standardnem vrtavki.

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>

Zakaj ne bi uporabljali border-colorpripomočkov? Vsak mejni vrtalnik določa transparentobrobo za vsaj eno stran, zato .border-{color}bi pripomočki to preglasili.

Rastoča vrtavka

Če ne marate mejne vrtavke, preklopite na vrtavko za rast. Čeprav se tehnično ne vrti, vedno znova raste!

html

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

Še enkrat, ta vrtavka je zgrajena z currentColor, tako da lahko preprosto spremenite njegov videz s pripomočki za barvo besedila . Tukaj je v modri barvi, skupaj s podprtimi različicami.

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>

Poravnava

Spinerji v Bootstrapu so zgrajeni s rems currentColor, in display: inline-flex. To pomeni, da jim je mogoče preprosto spremeniti velikost, prebarvati in hitro poravnati.

Marža

Uporabite pripomočke za robove, na primer .m-5za enostavno razstavljanje.

html

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

Umestitev

Uporabite pripomočke flexbox , lebdeče pripomočke ali pripomočke za poravnavo besedila , da vrtavke postavite točno tam, kjer jih potrebujete v vsaki situaciji.

Flex

html

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

Nalaganje...

html

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

Plovci

html

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

Poravnaj besedilo

html

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

Velikost

Dodajte .spinner-border-smin .spinner-grow-smnaredite manjši spiner, ki ga lahko hitro uporabite v drugih komponentah.

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>

Ali pa uporabite CSS po meri ali vgrajene sloge, da po potrebi spremenite dimenzije.

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>

Gumbi

Uporabite vrtljivke znotraj gumbov, da označite, da se dejanje trenutno izvaja ali poteka. Prav tako lahko zamenjate besedilo iz vrtljivega elementa in po potrebi uporabite besedilo gumba.

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

Spremenljivke

Dodano v v5.2.0

Kot del Bootstrapovega razvijajočega se pristopa spremenljivk CSS zdaj spinnerji uporabljajo lokalne spremenljivke CSS na .spinner-borderin .spinner-growza izboljšano prilagajanje v realnem času. Vrednosti za spremenljivke CSS so nastavljene prek Sass, tako da je še vedno podprto tudi prilagajanje Sass.

Spremenljivke obrobnega vrtilnika:

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

Spremenljivke rastoče vrtavke:

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

Za oba spinerja se uporabljajo majhni razredi modifikatorjev spinnerja, da po potrebi posodobijo vrednosti teh spremenljivk CSS. Na primer, .spinner-border-smrazred naredi naslednje:

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

Sass spremenljivke

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

Ključni okvirji

Uporablja se za ustvarjanje animacij CSS za naše vrtavke. Vključeno v scss/_spinners.scss.

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

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