टोस्ट के लिये
एकटा टोस्ट, एकटा हल्का आ आसानी सं अनुकूलन योग्य अलर्ट संदेश कें साथ अपन आगंतुकक कें सूचनाक कें पुश करूं.
टोस्ट हल्का सूचना छै जे पुश सूचनाक कें नकल करय कें लेल डिजाइन कैल गेल छै जे मोबाइल आ डेस्कटॉप ऑपरेटिंग सिस्टम द्वारा लोकप्रिय कैल गेल छै. इ फ्लेक्सबॉक्स सं बनल छै, अइ कें लेल एकरा संरेखित करनाय आ ओकरा स्थिति मे रखनाय आसान छै.
अवलोकन
टोस्ट प्लगइन के उपयोग करय के समय जानय के बात:
- यदि अहाँ हमर जावास्क्रिप्ट स्रोत सँ बना रहल छी, त' एकरा आवश्यकता
util.js
अछि . - टोस्ट प्रदर्शन कारण सं ऑप्ट-इन होइत अछि, तें, अहांकें स्वयं एकरा इनिशियलाइज करय पड़त .
- कृपया ध्यान राखब जे टोस्ट के पोजीशनिंग के जिम्मेदारी अहां के अछि.
- जँ अहाँ निर्दिष्ट नहि करब तँ टोस्ट स्वतः नुका जायत
autohide: false
.
एहि घटक क एनीमेशन प्रभाव prefers-reduced-motion
मीडिया क्वेरी पर निर्भर करैत अछि । हमर सुलभता दस्तावेजीकरणक कम गति अनुभाग देखू .
उदाहरण के लिये
मूलभूत
विस्तार योग्य आ पूर्वानुमानित टोस्ट कें प्रोत्साहित करय कें लेल, हम एकटा हेडर आ बॉडी कें सिफारिश करय छी. टोस्ट हेडर उपयोग display: flex
, हमर मार्जिन आ फ्लेक्सबॉक्स उपयोगिताक कें बदौलत सामग्री कें आसान संरेखण कें अनुमति देयत छै.
टोस्ट जतेक लचीला होयत छै, ओतेक लचीला होयत छै आ बहुत कम आवश्यक मार्कअप होयत छै. न्यूनतम, हमरा सब कें एकटा तत्व कें आवश्यकता छै जे अहां कें “टोस्टेड” सामग्री कें समाहित करय आ एकटा खारिज बटन कें दृढ़ता सं प्रोत्साहित करय छै.
पारभासी
टोस्ट सेहो कनेक पारभासी होइत अछि, तें जे किछु ऊपर देखबा मे आबि सकैत अछि, ओहि पर ब्लेंड भ' जाइत अछि. ब्राउज़र के लेल जे CSS गुण के समर्थन करैत backdrop-filter
अछि, हम एकटा टोस्ट के नीचा तत्व के धुंधला करय के कोशिश सेहो करब.
ढेर करब
जखन अहां कें पास कईटा टोस्ट होयत छै, तखन हम डिफ़ॉल्ट रूप सं ओकरा पठनीय तरीका सं लंबवत ढेर करय छी.
प्लेसमेंट
टोस्ट के जरूरत के हिसाब सं कस्टम सीएसएस के संग राखू. ऊपर दाहिना भाग प्रायः सूचनाक लेल प्रयोग कएल जाइत अछि , जेना ऊपरी बीचक । अगर अहां कहियो एक बेर में एकटा टोस्ट मात्र देखाबय जा रहल छी तं पोजीशनिंग स्टाइल के ठीक .toast
.
सिस्टम कें लेल जे बेसि सूचना उत्पन्न करएयत छै, एकटा रैपिंग तत्व कें उपयोग करएय पर विचार करूं ताकि ओ आसानी सं ढेर भ सकएय.
अहां टोस्ट कें क्षैतिज आ/अथवा लंबवत संरेखित करय कें लेल फ्लेक्सबॉक्स उपयोगिताक कें साथ फैंसी सेहो प्राप्त कयर सकय छी.
सुलभता
टोस्ट कें उद्देश्य अहां कें आगंतुक या उपयोगकर्ताक कें लेल छोट-छोट बाधा बननाय छै, अइ कें लेल स्क्रीन रीडर आ समान सहायक तकनीक वाला लोगक कें मदद करय कें लेल, अहां कें अपन टोस्ट कें एकटा aria-live
क्षेत्र मे लपेटबाक चाही . लाइव क्षेत्रक मे बदलाव (जैना टोस्ट घटक कें इंजेक्शन/अपडेट करनाय) कें घोषणा स्वचालित रूप सं स्क्रीन रीडर द्वारा कैल जायत छै, बिना उपयोगकर्ता कें फोकस कें स्थानांतरित करय कें जरूरत या अन्यथा उपयोगकर्ता कें बाधित करय कें. एकरऽ अतिरिक्त, aria-atomic="true"
ई सुनिश्चित करै लेली शामिल करलऽ जाय कि पूरा टोस्ट हमेशा एकल (परमाणु) इकाई के रूप म॑ घोषित करलऽ जाय, बजाय ई घोषणा करलऽ जाय कि की बदललऽ गेलऽ छेलै (जे समस्या पैदा करी सकै छै अगर आप केवल टोस्ट केरऽ सामग्री केरऽ कुछ हिस्सा अपडेट करबै, या अगर एक ही टोस्ट सामग्री क॑ प्रदर्शित करलऽ जाय छै समय के बाद के बिन्दु)। यदि आवश्यक जानकारी प्रक्रिया कें लेल महत्वपूर्ण छै, जेना कोनों फॉर्म मे त्रुटि कें सूची कें लेल, तखन अलर्ट घटक कें उपयोग करूंटोस्ट के जगह पर।
ध्यान रहे कि टोस्ट जेनरेट या अपडेट करय सं पहिने लाइव क्षेत्र के मार्कअप में मौजूद रहय के जरूरत अछि . यदि आप एक साथ गतिशील रूप स॑ दूनू क॑ जनरेट करी क॑ ओकरा पन्ना म॑ इंजेक्ट करी क॑ देखै छियै त॑ सामान्य तौर प॑ एकरऽ घोषणा सहायक प्रौद्योगिकी द्वारा नै करलऽ जैतै ।
सामग्री के आधार पर role
आ स्तर के अनुकूलित करय के सेहो जरूरत अछि . aria-live
यदि ई त्रुटि जैसनऽ महत्वपूर्ण संदेश छै , त॑ प्रयोग करलऽ जाय role="alert" aria-live="assertive"
, अन्यथा role="status" aria-live="polite"
विशेषता के प्रयोग करलऽ जाय ।
delay
जेना-जेना अहां जे सामग्री प्रदर्शित क रहल छी ओ बदलत, टाइमआउट जरूर अपडेट करू ताकि लोक के पास टोस्ट पढ़य लेल पर्याप्त समय मिलय.
उपयोग करय कें समय autohide: false
, अहां कें एकटा बंद बटन जोड़नाय आवश्यक छै ताकि उपयोगकर्ताक कें टोस्ट कें खारिज करय कें अनुमति मिलय.
जावास्क्रिप्ट व्यवहार
प्रयोग
जावास्क्रिप्ट के माध्यम स टोस्ट आरंभ करू:
विकल्प
विकल्पक कें डाटा एट्रिब्यूट या जावास्क्रिप्ट कें माध्यम सं पास कैल जा सकय छै. डेटा विशेषताक लेल, विकल्प नाम केँ data-
, मे संलग्न करू , जेना data-animation=""
.
नाम | प्रकार | चुकनाइ | वर्णन |
---|---|---|---|
एनीमेशन | बूलियन | सत्य | टोस्ट पर एकटा CSS फेड संक्रमण लागू करू |
ऑटोहाइड | बूलियन | सत्य | ऑटो टोस्ट छुपाउ |
देरी | संख्या | 500 |
टोस्ट नुकाबय मे देरी (ms) |
विधियाँ
अतुल्यकालिक विधि एवं संक्रमण
सब एपीआई विधि एसिंक्रोनस अछि आ एकटा संक्रमण शुरू करैत अछि . संक्रमण शुरू होइते मुदा समाप्त होए सं पहिने फोन करय वाला के पास वापस आबि जाइत छथिन्ह . एकर अलावा, एकटा संक्रमण घटक पर एकटा विधि कॉल कें अनदेखी कैल जेतय .
$().toast(options)
एकटा तत्व संग्रह मे एकटा टोस्ट हैंडलर संलग्न करैत अछि.
.toast('show')
एकटा तत्व के टोस्ट के खुलासा करैत अछि। टोस्ट कें वास्तव मे दिखाएय सं पहिले (अर्थात shown.bs.toast
घटना घटित हुअ सं पहिले) कॉलर कें पास वापस आबि जायत छै. अहां के मैन्युअल रूप सं एहि तरीका के कॉल करय पड़त, बल्कि अहां के टोस्ट नहिं देखायत.
.toast('hide')
कोनो तत्व के टोस्ट छिपाबैत अछि। टोस्ट कें वास्तव मे नुकाएय सं पहिले (अर्थात hidden.bs.toast
घटना घटित हुअ सं पहिले) कॉलर कें पास वापस आबि जायत छै. अहाँकेँ एहि विधिकेँ मैन्युअल रूपसँ कॉल करए पड़त जँ autohide
अहाँ false
.
.toast('dispose')
कोनो तत्व के टोस्ट छिपाबैत अछि। अहाँक टोस्ट डीओएम पर रहत मुदा आब नहि देखायत।
घटनाक्रम
घटना प्रकार | वर्णन |
---|---|
शो.बी.एस.टोस्ट करब | show इंस्टेंस मेथड कें कॉल करय पर इ घटना तुरंत फायर भ जायत छै. |
देखाओल गेल.bs.toast | इ इवेंट तखन फायर कैल जायत छै जखन टोस्ट कें उपयोगकर्ता कें लेल दृश्यमान बना देल गेल छै. |
छिपाएँ.बीएस.टोस्ट | ई घटना तुरंत फायर कएल जाइत अछि जखन hide इंस्टेंस मेथड कॉल कएल गेल अछि. |
छिपल.बीएस.टोस्ट | ई इवेंट तखन फायर कएल जाइत अछि जखन टोस्ट उपयोगकर्ता सं नुकाएब समाप्त भ' जाइत अछि. |