in English

Troellwyr

Nodwch gyflwr llwytho cydran neu dudalen gyda throellwyr Bootstrap, wedi'u hadeiladu'n gyfan gwbl gyda HTML, CSS, a dim JavaScript.

Ar y dudalen hon

Ynghylch

Gellir defnyddio “troellwyr” Bootstrap i ddangos y cyflwr llwytho yn eich prosiectau. Maent wedi'u hadeiladu gyda HTML a CSS yn unig, sy'n golygu nad oes angen unrhyw JavaScript arnoch i'w creu. Fodd bynnag, bydd angen rhywfaint o JavaScript personol arnoch i newid eu gwelededd. Gellir addasu eu hymddangosiad, eu haliniad a'u maint yn hawdd gyda'n dosbarthiadau cyfleustodau anhygoel.

At ddibenion hygyrchedd, mae pob llwythwr yma role="status"yn cynnwys <span class="visually-hidden">Loading...</span>.

Mae effaith animeiddio'r gydran hon yn dibynnu ar prefers-reduced-motionymholiad y cyfryngau. Gweler adran cynnig gostyngol ein dogfennaeth hygyrchedd .

Troellwr ffin

Defnyddiwch y troellwyr border ar gyfer dangosydd llwytho ysgafn.

html

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

Lliwiau

Mae'r troellwr border yn defnyddio currentColorar gyfer ei border-color, sy'n golygu y gallwch chi addasu'r lliw gyda chyfleustodau lliw testun . Gallwch ddefnyddio unrhyw un o'n cyfleustodau lliw testun ar y troellwr safonol.

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>

Beth am ddefnyddio border-colorcyfleustodau? Mae pob troellwr ffin yn pennu transparentffin ar gyfer o leiaf un ochr, felly .border-{color}byddai cyfleustodau'n diystyru hynny.

Tyfu troellwr

Os nad ydych chi awydd troellwr border, newidiwch i'r troellwr tyfu. Er nad yw'n troi'n dechnegol, mae'n tyfu dro ar ôl tro!

html

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

Unwaith eto, mae'r troellwr hwn wedi'i adeiladu gyda currentColor, felly gallwch chi newid ei ymddangosiad yn hawdd gyda chyfleustodau lliw testun . Yma mae mewn glas, ynghyd â'r amrywiadau a gefnogir.

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>

Aliniad

Mae troellwyr yn Bootstrap yn cael eu hadeiladu gydag rems, currentColor, a display: inline-flex. Mae hyn yn golygu eu bod yn hawdd eu newid maint, eu hail-liwio, a'u halinio'n gyflym.

Ymylon

Defnyddiwch gyfleustodau ymyl fel .m-5ar gyfer bylchau hawdd.

html

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

Lleoliad

Defnyddiwch gyfleustodau flexbox , cyfleustodau arnofio , neu gyfleustodau aliniad testun i osod troellwyr yn union lle mae eu hangen arnoch mewn unrhyw sefyllfa.

Fflecs

html

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

Wrthi'n llwytho...

html

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

fflotiau

html

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

Alinio testun

html

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

Maint

Ychwanegu .spinner-border-sma .spinner-grow-smgwneud troellwr llai y gellir ei ddefnyddio'n gyflym o fewn cydrannau eraill.

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>

Neu, defnyddiwch CSS personol neu arddulliau mewnol i newid y dimensiynau yn ôl yr angen.

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>

Botymau

Defnyddiwch droellwyr o fewn botymau i ddangos bod gweithred yn cael ei phrosesu neu'n digwydd ar hyn o bryd. Gallwch hefyd gyfnewid y testun allan o'r elfen troellwr a defnyddio testun botwm yn ôl yr angen.

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

Newidynnau

Ychwanegwyd yn v5.2.0

Fel rhan o ddull newidynnau CSS esblygol Bootstrap, mae troellwyr bellach yn defnyddio newidynnau CSS lleol ymlaen .spinner-borderac ar .spinner-growgyfer addasu amser real gwell. Mae gwerthoedd ar gyfer y newidynnau CSS yn cael eu gosod trwy Sass, felly mae addasu Sass yn dal i gael ei gefnogi hefyd.

Newidynnau troellwr ffin:

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

Newidynnau troellwr sy'n tyfu:

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

Ar gyfer y ddau droellwr, defnyddir dosbarthiadau addasydd troellwr bach i ddiweddaru gwerthoedd y newidynnau CSS hyn yn ôl yr angen. Er enghraifft, mae’r .spinner-border-smdosbarth yn gwneud y canlynol:

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

Newidynnau Sass

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

Fframiau bysell

Fe'i defnyddir ar gyfer creu animeiddiadau CSS ar gyfer ein troellwyr. Wedi'i gynnwys yn scss/_spinners.scss.

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

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