האָפּקען צו הויפּט אינהאַלט האָפּקען צו דאָקס נאַוויגאַציע
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>

דיסמיסינג

ניצן די פלינק דזשאַוואַסקריפּט פּלוגין, עס איז מעגלעך צו אָפּזאָגן קיין פלינק ינלינע. ווי אזוי:

  • זייט זיכער אַז איר האָט לאָודיד די פלינק פּלוגין אָדער די קאַמפּיילד Bootstrap דזשאַוואַסקריפּט.
  • לייג אַ נאָענט קנעפּל און די .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"צו דעם עלעמענט.

CSS

וועריאַבאַלז

צוגעגעבן אין וו5.2.0

ווי אַ טייל פון Bootstrap ס יוואַלווינג CSS וועריאַבאַלז צוגאַנג, אַלערץ איצט נוצן היגע CSS וועריאַבאַלז .alertפֿאַר ימפּרוווד פאַקטיש-צייט קוסטאָמיזאַטיאָן. וואַלועס פֿאַר די CSS וועריאַבאַלז זענען באַשטימט דורך סאַס, אַזוי סאַס קוסטאָמיזאַטיאָן איז נאָך געשטיצט אויך.

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

סאָס וועריאַבאַלז

$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()

געשעענישן

Bootstrap ס פלינק פּלוגין יקספּאָוזיז עטלעכע געשעענישן פֿאַר כוקינג אין פלינק פאַנגקשאַנאַליטי.

געשעעניש באַשרייַבונג
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()
})