اصلي منځپانګې ته لاړ شئ د اسنادو نیویګیشن ته لاړشئ
Check
in English

خبرتیاوې

د لاسي موجود او انعطاف وړ خبرتیا پیغامونو سره د عادي کارونکي عملونو لپاره د متناسب فیډبیک پیغامونه چمتو کړئ.

په دې پاڼه کې

مثالونه

خبرتیاوې د هر متن اوږدوالي لپاره شتون لري ، په بیله بیا د اختیاري تړلو تڼۍ. د سم سټایل کولو لپاره، د اتو اړینو شرایطو ټولګیو څخه یو وکاروئ (د بیلګې په توګه، .alert-success). د انلاین ګوښه کولو لپاره، د خبرتیا جاواسکریپټ پلگ ان وکاروئ .

html 
<div class="alert alert-primary" role="alert">
  A simple primary alert—check it out!
</div>
<div class="alert alert-secondary" role="alert">
  A simple secondary alert—check it out!
</div>
<div class="alert alert-success" role="alert">
  A simple success alert—check it out!
</div>
<div class="alert alert-danger" role="alert">
  A simple danger alert—check it out!
</div>
<div class="alert alert-warning" role="alert">
  A simple warning alert—check it out!
</div>
<div class="alert alert-info" role="alert">
  A simple info alert—check it out!
</div>
<div class="alert alert-light" role="alert">
  A simple light alert—check it out!
</div>
<div class="alert alert-dark" role="alert">
  A simple dark alert—check it out!
</div>
مرستندویه ټیکنالوژیو ته د معنی رسول

د معنی اضافه کولو لپاره د رنګ کارول یوازې یو بصری نښې وړاندې کوي، کوم چې به د مرستندویه ټیکنالوژیو کاروونکو ته نه لیږل کیږي - لکه د سکرین لوستونکي. ډاډ ترلاسه کړئ چې د رنګ لخوا څرګند شوي معلومات یا پخپله د مینځپانګې څخه څرګند دي (د بیلګې په توګه څرګند متن) ، یا د بدیل وسیلو له لارې شامل شوي ، لکه د .visually-hiddenټولګي سره پټ اضافي متن.

ژوندۍ بېلګه

د خبرتیا ښودلو لپاره لاندې تڼۍ کلیک وکړئ (د پیل کولو لپاره د انلاین سټایلونو سره پټ شوی)، بیا یې د جوړ شوي نږدې تڼۍ سره ګوښه کړئ (او ویجاړ کړئ).

html 
<div id="liveAlertPlaceholder"></div>
<button type="button" class="btn btn-primary" id="liveAlertBtn">Show live alert</button>

موږ لاندې جاوا سکریپټ کاروو ترڅو خپل ژوندی خبرتیا ډیمو پیل کړو:

const alertPlaceholder = document.getElementById('liveAlertPlaceholder')

const alert = (message, type) => {
  const wrapper = document.createElement('div')
  wrapper.innerHTML = [
    `<div class="alert alert-${type} alert-dismissible" role="alert">`,
    `   <div>${message}</div>`,
    '   <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>',
    '</div>'
  ].join('')

  alertPlaceholder.append(wrapper)
}

const alertTrigger = document.getElementById('liveAlertBtn')
if (alertTrigger) {
  alertTrigger.addEventListener('click', () => {
    alert('Nice, you triggered this alert message!', 'success')
  })
}

د یوټیلیټ کلاس وکاروئ .alert-linkژر تر ژره په هر خبرتیا کې د ورته رنګ لینکونو چمتو کولو لپاره.

html 
<div class="alert alert-primary" role="alert">
  A simple primary alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-secondary" role="alert">
  A simple secondary alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-success" role="alert">
  A simple success alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-danger" role="alert">
  A simple danger alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-warning" role="alert">
  A simple warning alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-info" role="alert">
  A simple info alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-light" role="alert">
  A simple light alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-dark" role="alert">
  A simple dark alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>

اضافي مواد

خبرتیاوې کولی شي اضافي HTML عناصر ولري لکه سرلیکونه، پراګرافونه او ویشونکي.

html 
<div class="alert alert-success" role="alert">
  <h4 class="alert-heading">Well done!</h4>
  <p>Aww yeah, you successfully read this important alert message. This example text is going to run a bit longer so that you can see how spacing within an alert works with this kind of content.</p>
  <hr>
  <p class="mb-0">Whenever you need to, be sure to use margin utilities to keep things nice and tidy.</p>
</div>

شبیه

په ورته ډول ، تاسو کولی شئ د شبیانو سره خبرتیاو رامینځته کولو لپاره د فلیکس بکس اسانتیاوې او د بوټسټریپ شبیه وکاروئ . ستاسو په شبیهونو او مینځپانګو پورې اړه لري ، تاسو ممکن نور اسانتیاوې یا دودیز سټایلونه اضافه کړئ.

html 
<div class="alert alert-primary d-flex align-items-center" role="alert">
  <svg xmlns="http://www.w3.org/2000/svg" class="bi bi-exclamation-triangle-fill flex-shrink-0 me-2" viewBox="0 0 16 16" role="img" aria-label="Warning:">
    <path d="M8.982 1.566a1.13 1.13 0 0 0-1.96 0L.165 13.233c-.457.778.091 1.767.98 1.767h13.713c.889 0 1.438-.99.98-1.767L8.982 1.566zM8 5c.535 0 .954.462.9.995l-.35 3.507a.552.552 0 0 1-1.1 0L7.1 5.995A.905.905 0 0 1 8 5zm.002 6a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
  </svg>
  <div>
    An example alert with an icon
  </div>
</div>

ستاسو د خبرتیاو لپاره له یو څخه ډیر آئیکون ته اړتیا لرئ؟ د نورو بوټسټریپ آئیکونونو کارولو په اړه فکر وکړئ او د محلي SVG سپرایټ رامینځته کړئ چې ورته ورته شبیهونه په اسانۍ سره تکرار کړئ.

html 
<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
  <symbol id="check-circle-fill" viewBox="0 0 16 16">
    <path d="M16 8A8 8 0 1 1 0 8a8 8 0 0 1 16 0zm-3.97-3.03a.75.75 0 0 0-1.08.022L7.477 9.417 5.384 7.323a.75.75 0 0 0-1.06 1.06L6.97 11.03a.75.75 0 0 0 1.079-.02l3.992-4.99a.75.75 0 0 0-.01-1.05z"/>
  </symbol>
  <symbol id="info-fill" viewBox="0 0 16 16">
    <path d="M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16zm.93-9.412-1 4.705c-.07.34.029.533.304.533.194 0 .487-.07.686-.246l-.088.416c-.287.346-.92.598-1.465.598-.703 0-1.002-.422-.808-1.319l.738-3.468c.064-.293.006-.399-.287-.47l-.451-.081.082-.381 2.29-.287zM8 5.5a1 1 0 1 1 0-2 1 1 0 0 1 0 2z"/>
  </symbol>
  <symbol id="exclamation-triangle-fill" viewBox="0 0 16 16">
    <path d="M8.982 1.566a1.13 1.13 0 0 0-1.96 0L.165 13.233c-.457.778.091 1.767.98 1.767h13.713c.889 0 1.438-.99.98-1.767L8.982 1.566zM8 5c.535 0 .954.462.9.995l-.35 3.507a.552.552 0 0 1-1.1 0L7.1 5.995A.905.905 0 0 1 8 5zm.002 6a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
  </symbol>
</svg>

<div class="alert alert-primary d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" role="img" aria-label="Info:"><use xlink:href="#info-fill"/></svg>
  <div>
    An example alert with an icon
  </div>
</div>
<div class="alert alert-success d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" role="img" aria-label="Success:"><use xlink:href="#check-circle-fill"/></svg>
  <div>
    An example success alert with an icon
  </div>
</div>
<div class="alert alert-warning d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" role="img" aria-label="Warning:"><use xlink:href="#exclamation-triangle-fill"/></svg>
  <div>
    An example warning alert with an icon
  </div>
</div>
<div class="alert alert-danger d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" role="img" aria-label="Danger:"><use xlink:href="#exclamation-triangle-fill"/></svg>
  <div>
    An example danger alert with an icon
  </div>
</div>

ګوښه کول

د خبرتیا جاواسکریپټ پلگ ان په کارولو سره، دا ممکنه ده چې هر ډول خبرتیا انلاین رد کړئ. دلته دی څنګه:

  • ډاډ ترلاسه کړئ چې تاسو د خبرتیا پلگ ان پورته کړی، یا د بوټسټریپ جاوا سکریپټ تالیف کړی.
  • د نږدې تڼۍ او .alert-dismissibleټولګي اضافه کړئ، کوم چې د خبرتیا ښي خوا ته اضافي پیډینګ اضافه کوي او د نږدې تڼۍ ځای نیسي.
  • په نږدې تڼۍ کې، data-bs-dismiss="alert"خاصیت اضافه کړئ، کوم چې د جاواسکریپټ فعالیت پیلوي. ډاډ ترلاسه کړئ چې <button>په ټولو وسیلو کې د مناسب چلند لپاره د دې سره عنصر وکاروئ.
  • د خبرتیاو متحرک کولو لپاره کله چې دوی یې له مینځه ویسي، ډاډ ترلاسه کړئ چې .fadeاو .showټولګي اضافه کړئ.

تاسو کولی شئ دا د ژوندی ډیمو سره په عمل کې وګورئ:

html 
<div class="alert alert-warning alert-dismissible fade show" role="alert">
  <strong>Holy guacamole!</strong> You should check in on some of those fields below.
  <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
</div>
کله چې یو خبرتیا رد شي، عنصر په بشپړه توګه د پاڼې جوړښت څخه لیرې شوی. که چیرې د کیبورډ کاروونکي د نږدې تڼۍ په کارولو سره خبرتیا رد کړي، نو د دوی تمرکز به ناڅاپه له لاسه ورکړي او د براوزر پورې اړه لري، د پاڼې / اسنادو پیل ته بیا وګرځي. د دې دلیل لپاره، موږ د اضافي جاوا سکریپټ په شمول وړاندیز کوو چې د closed.bs.alertپیښې لپاره غوږ نیسي او په پروګرام focus()کې په پاڼه کې ترټولو مناسب ځای ته ټاکي. که تاسو پلان لرئ چې تمرکز غیر متقابل عنصر ته واړوئ چې معمولا تمرکز نه ترلاسه کوي، ډاډ ترلاسه کړئ چې tabindex="-1"عنصر ته اضافه کړئ.

سی ایس ایس

متغیرات

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

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

  --#{$prefix}alert-bg: transparent;
  --#{$prefix}alert-padding-x: #{$alert-padding-x};
  --#{$prefix}alert-padding-y: #{$alert-padding-y};
  --#{$prefix}alert-margin-bottom: #{$alert-margin-bottom};
  --#{$prefix}alert-color: inherit;
  --#{$prefix}alert-border-color: transparent;
  --#{$prefix}alert-border: #{$alert-border-width} solid var(--#{$prefix}alert-border-color);
  --#{$prefix}alert-border-radius: #{$alert-border-radius};

د Sass متغیرات

$alert-padding-y:               $spacer;
$alert-padding-x:               $spacer;
$alert-margin-bottom:           1rem;
$alert-border-radius:           $border-radius;
$alert-link-font-weight:        $font-weight-bold;
$alert-border-width:            $border-width;
$alert-bg-scale:                -80%;
$alert-border-scale:            -70%;
$alert-color-scale:             40%;
$alert-dismissible-padding-r:   $alert-padding-x * 3; // 3x covers width of x plus default padding on either side

د ساس مخلوط

$theme-colorsزموږ د خبرتیاو لپاره د متناسب بدلون کونکي ټولګیو رامینځته کولو سره په ترکیب کې کارول کیږي .

@mixin alert-variant($background, $border, $color) {
  --#{$prefix}alert-color: #{$color};
  --#{$prefix}alert-bg: #{$background};
  --#{$prefix}alert-border-color: #{$border};

  @if $enable-gradients {
    background-image: var(--#{$prefix}gradient);
  }

  .alert-link {
    color: shade-color($color, 20%);
  }
}

ساس لوپ

لوپ چې د alert-variant()مکسین سره د ترمیم کونکي ټولګي رامینځته کوي.

// Generate contextual modifier classes for colorizing the alert.

@each $state, $value in $theme-colors {
  $alert-background: shift-color($value, $alert-bg-scale);
  $alert-border: shift-color($value, $alert-border-scale);
  $alert-color: shift-color($value, $alert-color-scale);

  @if (contrast-ratio($alert-background, $alert-color) < $min-contrast-ratio) {
    $alert-color: mix($value, color-contrast($alert-background), abs($alert-color-scale));
  }
  .alert-#{$state} {
    @include alert-variant($alert-background, $alert-border, $alert-color);
  }
}

جاواسکریپټ چلند

پیل کړئ

عناصر د خبرتیا په توګه پیل کړئ

const alertList = document.querySelectorAll('.alert')
const alerts = [...alertList].map(element => new bootstrap.Alert(element))

د خبرتیا له مینځه وړلو یوازینۍ هدف لپاره ، دا اړینه نده چې د JS API له لارې په لاسي ډول برخه پیل کړئ. د کارولو په واسطه data-bs-dismiss="alert"، برخه به په اوتومات ډول پیل شي او په سمه توګه ګوښه شي.

د نورو جزیاتو لپاره د محرکاتو برخه وګورئ.

محرکونه

ګوښه کول د خبرتیا دننه پهdata تڼۍ کې د ځانګړتیا سره ترلاسه کیدی شي لکه څنګه چې لاندې ښودل شوي:

<button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>

یا د خبرتیا څخه بهر په تڼۍ کې د لاندې ښودل شوي په کارولو سره data-bs-target:

<button type="button" class="btn-close" data-bs-dismiss="alert" data-bs-target="#my-alert" aria-label="Close"></button>

په یاد ولرئ چې د خبرتیا بندول به دا د DOM څخه لرې کړي.

میتودونه

تاسو کولی شئ د خبرتیا جوړونکي سره د خبرتیا مثال رامینځته کړئ ، د مثال په توګه:

const bsAlert = new bootstrap.Alert('#myAlert')

دا د نسلي عناصرو په اړه د کلیک پیښو لپاره خبرتیا اوري چې data-bs-dismiss="alert"ځانګړتیا لري. (ضرورت نلري کله چې د ډیټا-اپي اتومات پیل کول وکاروئ.)

طریقه تفصیل
close د DOM څخه د لرې کولو له لارې خبرتیا بندوي. که چیرې .fadeاو .showټولګي په عنصر کې شتون ولري، خبرتیا به مخکې له دې چې لیرې شي له منځه ځي.
dispose د یو عنصر خبرتیا له منځه وړي. (د DOM عنصر کې زیرمه شوي معلومات لرې کوي)
getInstance جامد میتود چې تاسو ته اجازه درکوي د DOM عنصر پورې اړوند د خبرتیا مثال ترلاسه کړئ. د مثال په توګه: bootstrap.Alert.getInstance(alert).
getOrCreateInstance جامد میتود چې د DOM عنصر پورې اړوند د خبرتیا مثال بیرته راګرځوي یا یو نوی رامینځته کړي که چیرې دا پیل نه وي. تاسو کولی شئ دا په لاندې ډول وکاروئ: bootstrap.Alert.getOrCreateInstance(element).

اساسي کارول:

const alert = bootstrap.Alert.getOrCreateInstance('#myAlert')
alert.close()

پیښې

د بوټسټریپ خبرتیا پلگ ان د خبرتیا فعالیت کې د ځړولو لپاره یو څو پیښې افشا کوي.

پیښه تفصیل
close.bs.alert سمدلاسه اور اچوي کله چې د closeمثال میتود ویل کیږي.
closed.bs.alert ډزې شوې کله چې خبرتیا بنده شوې او د CSS لیږد بشپړ شوی. 
const myAlert = document.getElementById('myAlert')
myAlert.addEventListener('closed.bs.alert', event => {
  // do something, for instance, explicitly move focus to the most appropriate element,
  // so it doesn't get lost/reset to the start of the page
  // document.getElementById('...').focus()
})