in English

سپنران

د بوټسټریپ اسپنرونو سره د یوې برخې یا پاڼې د بارولو حالت په ګوته کړئ، په بشپړ ډول د HTML، CSS، او جاوا سکریپټ سره جوړ شوی.

په دې پاڼه کې

په اړه

بوټسټریپ "سپینرونه" ستاسو په پروژو کې د بارولو حالت ښودلو لپاره کارول کیدی شي. دوی یوازې د HTML او CSS سره جوړ شوي، پدې معنی چې تاسو د دوی جوړولو لپاره هیڅ جاوا سکریپټ ته اړتیا نلرئ. تاسو به په هرصورت، ځینې دودیز جاواسکریپټ ته اړتیا ولرئ ترڅو د دوی لید بدل کړي. د دوی بڼه، سمون، او اندازه کول په اسانۍ سره زموږ د حیرانتیا یوټیلټي ټولګیو سره تنظیم کیدی شي.

د لاسرسي موخو لپاره، دلته هر لوډر شامل دي role="status"او یو نیسټډ <span class="visually-hidden">Loading...</span>.

د دې برخې د حرکت اغیز د prefers-reduced-motionرسنیو په پوښتنو پورې اړه لري. زموږ د لاسرسي اسنادو کم شوي حرکت برخه وګورئ .

د سرحد سپنر

د لږ وزن بارولو شاخص لپاره د سرحدی سپنرونو څخه کار واخلئ.

html

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

رنګونه

د بارډر سپنر د currentColorدې لپاره کاروي border-color، پدې معنی چې تاسو کولی شئ رنګ د متن رنګ کارولو سره دودیز کړئ . تاسو کولی شئ په معیاري سپنر کې زموږ د متن رنګ اسانتیاوې وکاروئ.

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>

ولې border-colorاسانتیاوې نه کاروئ؟ transparentهر پولډر سپنر لږترلږه د یوې خوا لپاره پوله مشخصوي ، نو .border-{color}اسانتیاوې به دا له پامه غورځوي.

وده کونکی سپنر

که تاسو سرحدی سپنر نه خوښوی، د ودې سپنر ته لاړشئ. پداسې حال کې چې دا په تخنیکي ډول سپن نه کوي، دا په مکرر ډول وده کوي!

html

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

یو ځل بیا، دا اسپنر سره جوړ شوی currentColor، نو تاسو کولی شئ په اسانۍ سره د متن رنګ کارولو سره د هغې بڼه بدل کړئ . دلته دا په نیلي کې دی، د ملاتړ شوي ډولونو سره.

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>

السلیک

په بوټسټریپ کې سپنرز د rems currentColor، او display: inline-flex. دا پدې مانا ده چې دوی په اسانۍ سره له سره تنظیم کیدی شي، بیا رنګ شوي، او په چټکۍ سره سمون لري.

مارجن

د آسانه فاصلو لپاره د حاشیې اسانتیاوې وکاروئ ..m-5

html

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

ځای پرځای کول

د فلیکس بکس یوټیلیټیز ، فلوټ یوټیلیټیز ، یا د متن د سمون اسانتیاوې وکاروئ ترڅو سپنرز په سمه توګه ځای په ځای کړئ چیرې چې تاسو ورته په هر حالت کې اړتیا لرئ.

فلیکس

html

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

بار کول...

html

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

تیریږي

html

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

متن سمون

html

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

اندازه

اضافه کړئ .spinner-border-smاو .spinner-grow-smیو کوچنی سپنر جوړ کړئ چې په چټکۍ سره په نورو برخو کې کارول کیدی شي.

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>

یا، د اړتیا سره سم ابعاد بدلولو لپاره دودیز CSS یا انلاین سټایلونه وکاروئ.

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>

تڼۍ

د بټونو دننه سپنرز وکاروئ ترڅو دا وښیې چې یو عمل اوس مهال پروسس یا ترسره کیږي. تاسو ممکن متن د سپنر عنصر څخه هم بدل کړئ او د اړتیا سره سم د تڼۍ متن وکاروئ.

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>

سی ایس ایس

متغیرات

په v5.2.0 کې اضافه شوی

د بوټسټریپ د پرمختللي CSS متغیر تګلارې د یوې برخې په توګه ، سپنران اوس ځایی CSS متغیرونه کاروي .spinner-borderاو .spinner-growد ریښتیني وخت اصلاح کولو لپاره. د CSS متغیرونو لپاره ارزښتونه د Sass له لارې تنظیم شوي، نو د Sass تخصیص لاهم هم ملاتړ کیږي.

د بارډر سپنر تغیرات:

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

د اسپنر متغیر وده کول:

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

د دواړو سپنرانو لپاره، د وړو سپننر ترمیم کونکي ټولګي د اړتیا سره سم د دې CSS متغیرونو ارزښتونو تازه کولو لپاره کارول کیږي. د مثال په توګه، .spinner-border-smټولګي لاندې کارونه کوي:

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

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

کلیدي چوکاټونه

زموږ د سپنرانو لپاره د CSS متحرکاتو جوړولو لپاره کارول کیږي. په کې شامل دي scss/_spinners.scss.

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

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