अलर्ट
मुट्ठी भर उपलब्ध और लचीले अलर्ट संदेशों के साथ विशिष्ट उपयोगकर्ता कार्रवाइयों के लिए प्रासंगिक प्रतिक्रिया संदेश प्रदान करें।
उदाहरण
अलर्ट किसी भी लम्बाई के टेक्स्ट के साथ-साथ एक वैकल्पिक क्लोज बटन के लिए उपलब्ध हैं। उचित स्टाइलिंग के लिए, आठ आवश्यक प्रासंगिक वर्गों में से एक का उपयोग करें (उदाहरण के लिए, .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>
हम अपने लाइव अलर्ट डेमो को ट्रिगर करने के लिए निम्नलिखित जावास्क्रिप्ट का उपयोग करते हैं:
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
किसी भी अलर्ट में मिलते-जुलते रंगीन लिंक शीघ्रता से उपलब्ध कराने के लिए उपयोगिता वर्ग का उपयोग करें ।
<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" 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 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"
विशेषता जोड़ें, जो JavaScript कार्यक्षमता को ट्रिगर करती है।<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"
।
सीएसएस
चर
v5.2.0 . में जोड़ा गयाबूटस्ट्रैप के विकसित हो रहे सीएसएस चर दृष्टिकोण के हिस्से के रूप में, अलर्ट अब .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};
सास चर
$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 |
किसी तत्व की चेतावनी को नष्ट कर देता है। (डीओएम तत्व पर संग्रहीत डेटा हटा देता है) |
getInstance |
स्टेटिक विधि जो आपको डीओएम तत्व से जुड़े अलर्ट इंस्टेंस को प्राप्त करने की अनुमति देती है। उदाहरण के लिए 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()
})