אַלערץ
צושטעלן קאָנטעקסטואַל באַמערקונגען אַרטיקלען פֿאַר טיפּיש באַניצער אַקשאַנז מיט אַ האַנדפול פון בנימצא און פלעקסאַבאַל פלינק אַרטיקלען.
ביישפילן
אַלערץ זענען בנימצא פֿאַר קיין לענג פון טעקסט, ווי געזונט ווי אַ אַפּשאַנאַל נאָענט קנעפּל. פֿאַר געהעריק סטילינג, נוצן איינער פון די אַכט פארלאנגט קאָנטעקסטואַל קלאסן (למשל, .alert-success
). פֿאַר ינלינע דיסמיסאַל, נוצן די אַלערץ דזשאַוואַסקריפּט פּלוגין .
<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
קלאַס.
לעבן בייַשפּיל
דריקט דעם קנעפּל אונטן צו ווייַזן אַ פלינק (פאַרבאָרגן מיט ינלינע סטיילז צו אָנהייבן), און אָפּזאָגן (און צעשטערן) עס מיט די געבויט-אין נאָענט קנעפּל.
<div id="liveAlertPlaceholder"></div>
<button type="button" class="btn btn-primary" id="liveAlertBtn">Show live alert</button>
מיר נוצן די פאלגענדע דזשאַוואַסקריפּט צו צינגל אונדזער לעבן פלינק דעמאָ:
var alertPlaceholder = document.getElementById('liveAlertPlaceholder')
var alertTrigger = document.getElementById('liveAlertBtn')
function alert(message, type) {
var wrapper = document.createElement('div')
wrapper.innerHTML = '<div class="alert alert-' + type + ' alert-dismissible" role="alert">' + message + '<button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button></div>'
alertPlaceholder.append(wrapper)
}
if (alertTrigger) {
alertTrigger.addEventListener('click', function () {
alert('Nice, you triggered this alert message!', 'success')
})
}
לינק קאָליר
ניצן די .alert-link
נוצן קלאַס צו געשווינד צושטעלן וואָס ריכטן בונט לינקס אין קיין פלינק.
<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 עלעמענטן ווי כעדינגז, פּאַראַגראַפס און דיווידערס.
גוט געטאן!
יאָ, איר האָט הצלחה לייענען דעם וויכטיק פלינק אָנזאָג. דער ביישפּיל טעקסט וועט לויפן אַ ביסל מער אַזוי איר קענען זען ווי ספּייסינג אין אַ פלינק אַרבעט מיט דעם טיפּ פון אינהאַלט.
ווען איר דאַרפֿן, זיין זיכער צו נוצן גרענעץ יוטילאַטיז צו האַלטן די טינגז שיין און ציכטיק.
<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>
ייקאַנז
סימילאַרלי, איר קענען נוצן פלעקסבאָקס יוטילאַטיז און באָאָטסטראַפּ יקאָנס צו שאַפֿן אַלערץ מיט ייקאַנז. דעפּענדינג אויף דיין ייקאַנז און אינהאַלט, איר קען וועלן צו לייגן מער יוטילאַטיז אָדער מנהג סטיילז.
<div class="alert alert-primary d-flex align-items-center" role="alert">
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" 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 ספּרייט ווי אַזוי צו ריפערד צו די זעלבע ייקאַנז ריפּיטידלי.
<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
<symbol id="check-circle-fill" fill="currentColor" 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" fill="currentColor" 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" fill="currentColor" 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" width="24" height="24" 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" width="24" height="24" 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" width="24" height="24" 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" width="24" height="24" 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
קלאסן.
איר קענען זען דעם אין קאַמף מיט אַ לעבן דעמאָ:
<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"
צו דעם עלעמענט.
סאַס
וועריאַבאַלז
$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) {
color: $color;
@include gradient-bg($background);
border-color: $border;
.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);
}
}
דזשאַוואַסקריפּט נאַטור
ייטיאַליזע
ינישאַליזע עלעמענטן ווי אַלערץ
var alertList = document.querySelectorAll('.alert')
var alerts = [].slice.call(alertList).map(function (element) {
return 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.
מעטהאָדס
מעטאָד | באַשרייַבונג |
---|---|
close |
קלאָוזיז אַ פלינק דורך רימוווינג עס פון די DOM. אויב די .fade און .show קלאסן זענען פאָרשטעלן אויף דעם עלעמענט, די פלינק וועט וועלקן אויס איידער עס איז אַוועקגענומען. |
dispose |
דיסטרויז אַן עלעמענט ס פלינק. (רימוווז סטאָרד דאַטן אויף די DOM עלעמענט) |
getInstance |
סטאַטיק אופֿן וואָס אַלאַוז איר צו באַקומען די פלינק בייַשפּיל פארבונדן צו אַ DOM עלעמענט, איר קענען נוצן עס ווי דאָס:bootstrap.Alert.getInstance(alert) |
getOrCreateInstance |
סטאַטיק אופֿן וואָס קערט אַ פלינק בייַשפּיל פֿאַרבונדן צו אַ DOM עלעמענט אָדער שאַפֿן אַ נייַע אין פאַל עס איז נישט יניטיאַלייזד. איר קענען נוצן עס ווי דאָס:bootstrap.Alert.getOrCreateInstance(element) |
var alertNode = document.querySelector('.alert')
var alert = bootstrap.Alert.getInstance(alertNode)
alert.close()
געשעענישן
Bootstrap ס פלינק פּלוגין יקספּאָוזיז עטלעכע געשעענישן פֿאַר כוקינג אין פלינק פאַנגקשאַנאַליטי.
געשעעניש | באַשרייַבונג |
---|---|
close.bs.alert |
פירעס מיד ווען די close בייַשפּיל אופֿן איז גערופן. |
closed.bs.alert |
פייערד ווען די פלינק איז פארמאכט און CSS טראַנזישאַנז האָבן געענדיקט. |
var myAlert = document.getElementById('myAlert')
myAlert.addEventListener('closed.bs.alert', function () {
// 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()
})