टूलटिप्स
एनीमेशन कें लेल CSS3 कें उपयोग करयत CSS आ जावास्क्रिप्ट कें साथ कस्टम बूटस्ट्रैप टूलटिप्स जोड़य कें लेल दस्तावेजीकरण आ उदाहरण आ स्थानीय शीर्षक भंडारण कें लेल डाटा-bs-एट्रिब्यूट.
अवलोकन
टूलटिप प्लगइन क उपयोग करबा काल जानबाक चाही:
- टूलटिप्स पोजीशनिंग कें लेल 3rd पार्टी लाइब्रेरी पॉपर पर निर्भर छै. टूलटिप्स के काज करय लेल अहाँ के bootstrap.js स पहिने popper.min.js शामिल करय पड़त या
bootstrap.bundle.min.js
/ के प्रयोग करय पड़तbootstrap.bundle.js
जाहि में Popper अछि ! - टूलटिप्स प्रदर्शन कारण सं ऑप्ट-इन अछि, तें अहां कें एकरा स्वयं आरंभ करय पड़त .
- शून्य-लंबाई शीर्षक वाला टूलटिप कहियो प्रदर्शित नहि कएल जाएत अछि.
container: 'body'
अधिक जटिल घटक (जैना कि हमरऽ इनपुट समूह, बटन समूह, आदि) म॑ रेंडरिंग समस्या स॑ बचै लेली निर्दिष्ट करलऽ जाय ।- नुकायल तत्व पर टूलटिप ट्रिगर करब काज नहि करत.
.disabled
या तत्वक कें लेल टूलटिप्स केंdisabled
एकटा रैपर तत्व पर ट्रिगर करनाय आवश्यक छै.- जखन हाइपरलिंक सं ट्रिगर कैल जैतय जे अनेक लाइनक पर फैलल होयत छै, तखन टूलटिप्स केंद्रित होयत.
white-space: nowrap;
एहि व्यवहार सँ बचबाक लेल अपन<a>
s पर प्रयोग करू । - टूलटिप्स कें ओकर संगत तत्वक कें डीओएम सं हटावय सं पहिले नुकायल करनाय आवश्यक छै.
- टूलटिप्स क॑ छाया डोम के अंदर के तत्व के बदौलत ट्रिगर करलऽ जाब॑ सकै छै ।
prefers-reduced-motion
मीडिया क्वेरी पर निर्भर करैत अछि । हमर सुलभता दस्तावेजीकरणक कम गति अनुभाग देखू
.
ओ सब किछु भेटल? बढ़िया, देखू जे किछु उदाहरण के संग कोना काज करैत छथि।
जेना: सब ठाम टूलटिप सक्षम करू
data-bs-toggle
कोनो पृष्ठ पर सभ टूलटिप के आरंभ करबाक एकटा तरीका ई होयत जे ओकरा ओकर विशेषता द्वारा चुनल जाय :
var tooltipTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="tooltip"]'))
var tooltipList = tooltipTriggerList.map(function (tooltipTriggerEl) {
return new bootstrap.Tooltip(tooltipTriggerEl)
})
उदाहरण के लिये
टूलटिप्स देखबाक लेल नीचा देल गेल लिंक पर माउस करू:
टूलटिप्स कें साथ किच्छू इनलाइन लिंक कें प्रदर्शन करय कें लेल प्लेसहोल्डर पाठ . ई आब बस भराव अछि, कोनो हत्यारा नहि। सामग्री एतय राखल गेल अछि बस वास्तविक पाठ के उपस्थिति के नकल करय लेल . आरू ई सब बस ई लेली कि वास्तविक दुनिया केरऽ परिस्थिति म॑ इस्तेमाल करला प॑ टूलटिप केना लगतै । त आशा अछि जे आब अहां सभ देखलहुं जे लिंक पर ई टूलटिप व्यवहार मे कोना काज क सकैत अछि, एक बेर अहां एकर उपयोग अपन साइट या प्रोजेक्ट पर करि लेब.
चारि टूलटिप्स दिशा देखय लेल नीचा देल गेल बटन पर माउस करू: ऊपर, दाहिना, नीचा, आ बामा. आरटीएल मे बूटस्ट्रैप कें उपयोग करयत समय निर्देशक कें मिरर कैल जायत छै.
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="top" title="Tooltip on top">
Tooltip on top
</button>
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="right" title="Tooltip on right">
Tooltip on right
</button>
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Tooltip on bottom">
Tooltip on bottom
</button>
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="left" title="Tooltip on left">
Tooltip on left
</button>
आ कस्टम एचटीएमएल जोडल गेलाक संग:
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-html="true" title="<em>Tooltip</em> <u>with</u> <b>HTML</b>">
Tooltip with HTML
</button>
एकटा एसवीजी के संग:
सस्स
चर
$tooltip-font-size: $font-size-sm;
$tooltip-max-width: 200px;
$tooltip-color: $white;
$tooltip-bg: $black;
$tooltip-border-radius: $border-radius;
$tooltip-opacity: .9;
$tooltip-padding-y: $spacer * .25;
$tooltip-padding-x: $spacer * .5;
$tooltip-margin: 0;
$tooltip-arrow-width: .8rem;
$tooltip-arrow-height: .4rem;
$tooltip-arrow-color: $tooltip-bg;
प्रयोग
टूलटिप प्लगइन मांग पर सामग्री आ मार्कअप उत्पन्न करयत छै, आ डिफ़ॉल्ट रूप सं टूलटिप कें ओकर ट्रिगर तत्व कें बाद रखयत छै.
जावास्क्रिप्ट के माध्यम स टूलटिप के ट्रिगर करू:
var exampleEl = document.getElementById('example')
var tooltip = new bootstrap.Tooltip(exampleEl, options)
ओवरफ्लो auto
आscroll
टूलटिप स्थिति स्वचालित रूप स बदलबाक प्रयास करैत अछि जखन कोनो मूल कंटेनर हमर अछि overflow: auto
या पसंद अछि , मुदा तइयो मूल प्लेसमेंट क स्थिति रखैत अछि. एकरा हल करय कें लेल, विकल्प (विकल्प कें उपयोग करय वाला फ्लिप संशोधक कें लेल ) कें कोनों HTMLElement पर सेट करूं कें डिफ़ॉल्ट मान, , जैना :overflow: scroll
.table-responsive
boundary
popperConfig
'clippingParents'
document.body
var exampleEl = document.getElementById('example')
var tooltip = new bootstrap.Tooltip(exampleEl, {
boundary: document.body // or document.querySelector('#boundary')
})
मार्कअप
टूलटिप के लेल आवश्यक मार्कअप केवल एकटा data
विशेषता अछि आ title
HTML तत्व पर अहाँ चाहैत छी जे टूलटिप हो | टूलटिप केरऽ जेनरेट करलऽ गेलऽ मार्कअप काफी सरल छै, हालांकि एकरा लेली एगो स्थिति केरऽ आवश्यकता जरूर छै (डिफ़ॉल्ट रूप स॑, top
प्लगइन द्वारा सेट करलऽ गेलऽ छै) ।
कीबोर्ड आ सहायक प्रौद्योगिकी उपयोगकर्ताक कें लेल टूलटिप्स कें काज करनाय
अहां कें केवल एचटीएमएल तत्वक मे टूलटिप्स जोड़बाक चाही जे परंपरागत रूप सं कीबोर्ड-केंद्रित आ इंटरैक्टिव (जैना लिंक या फॉर्म नियंत्रण) होयत छै. यद्यपि मनमानी एचटीएमएल तत्व (जैना <span>
s) क॑ विशेषता जोड़ै स॑ फोकस करलऽ जाब॑ सकै छै tabindex="0"
, ई स॑ कीबोर्ड उपयोगकर्ता लेली गैर-इंटरएक्टिव तत्वऽ प॑ संभावित रूप स॑ परेशान करै वाला आरू भ्रमित करै वाला टैब स्टॉप जोड़लऽ जैतै, आरू अधिकांश सहायक प्रौद्योगिकी वर्तमान म॑ ई स्थिति म॑ टूलटिप के घोषणा नै करै छै । एकरऽ अतिरिक्त, केवल अपनऽ टूलटिप लेली ट्रिगर के रूप म॑ भरोसा नै करलऽ hover
जाय, कैन्हेंकि ई स॑ कीबोर्ड उपयोगकर्ता लेली आपनो टूलटिप क॑ ट्रिगर करना असंभव होय जैतै ।
<!-- HTML to write -->
<a href="#" data-bs-toggle="tooltip" title="Some tooltip text!">Hover over me</a>
<!-- Generated markup by the plugin -->
<div class="tooltip bs-tooltip-top" role="tooltip">
<div class="tooltip-arrow"></div>
<div class="tooltip-inner">
Some tooltip text!
</div>
</div>
अक्षम तत्व
विशेषता वाला तत्व disabled
इंटरएक्टिव नै छै, मतलब उपयोगकर्ता कोनों टूलटिप (या पॉपओवर) क॑ ट्रिगर करै लेली ओकरा फोकस, होवर, या क्लिक नै करी सकै छै. एकटा वर्कअराउंड के रूप मे, अहां एकटा रैपर सं टूलटिप के ट्रिगर करय चाहब <div>
या <span>
, आदर्श रूप सं कीबोर्ड-फोकस करय योग्य बनाओल गेल अछि tabindex="0"
.
<span class="d-inline-block" tabindex="0" data-bs-toggle="tooltip" title="Disabled tooltip">
<button class="btn btn-primary" type="button" disabled>Disabled button</button>
</span>
विकल्प
विकल्पक कें डाटा एट्रिब्यूट या जावास्क्रिप्ट कें माध्यम सं पास कैल जा सकय छै. डेटा विशेषताक लेल, विकल्प नाम केँ data-bs-
, मे संलग्न करू , जेना data-bs-animation=""
. डेटा विशेषताक कें माध्यम सं विकल्पक कें पास करय कें समय विकल्प नाम कें केस प्रकार camelCase सं कबाब-केस मे बदलनाय सुनिश्चित करूं. जेना , प्रयोग करबाक बदला data-bs-customClass="beautifier"
, प्रयोग करू data-bs-custom-class="beautifier"
.
sanitize
,
sanitizeFn
, आ
allowList
विकल्पक कें डेटा विशेषताक कें उपयोग करयत आपूर्ति नहि कैल जा सकय छै.
नाम | प्रकार | चुकनाइ | वर्णन |
---|---|---|---|
animation |
बूलियन | true |
टूलटिप पर एकटा CSS फेड संक्रमण लागू करू |
container |
तार | तत्व | झूठ | false |
टूलटिप क' कोनो विशिष्ट तत्व मे जोड़ैत अछि. जेना : |
delay |
नम्बर | वस्तु | 0 |
टूलटिप (ms) कें देखएय आ नुकाएय मे देरी - मैनुअल ट्रिगर प्रकार पर लागू नहि होयत छै यदि कोनों नंबर सप्लाई कैल गेल छै, त नुका/देखाउ दूनू पर विलंब लागू कैल जायत छै वस्तु संरचना अछि : १. |
html |
बूलियन | false |
टूलटिप मे एचटीएमएल क अनुमति दिअ। यदि सही छै, त टूलटिप म॑ HTML टैग टूलटिप म॑ यदि अहाँ XSS हमला के बारे में चिंतित छी त पाठ के प्रयोग करू. |
placement |
तार | आयोजन | 'top' |
टूलटिप को कैसे पोजीशन दें - ऑटो | ऊपर | नीचे | बाएँ | ठीक. जब॑ कोनों फंक्शन क॑ प्लेसमेंट निर्धारित करै लेली प्रयोग करलऽ जाय छै त॑ ओकरा टूलटिप DOM नोड क॑ ओकरऽ पहिलऽ आर्गुमेंट के रूप म॑ आरू ट्रिगरिंग एलिमेंट DOM नोड क॑ ओकरऽ दोसरऽ के रूप म॑ कॉल करलऽ जाय छै । |
selector |
तार | झूठ | false |
यदि कोनों चयनकर्ता उपलब्ध करायल गेल छै, त टूलटिप वस्तुअक कें निर्दिष्ट लक्ष्यक कें लेल प्रत्यायोजित कैल जेतय. jQuery.on व्यवहार मे, एकर उपयोग गतिशील रूप सं जोडल गेल डीओएम तत्वक ( समर्थन) पर टूलटिप्स लागू करय कें लेल सेहो कैल जायत छै . ई आ एकटा जानकारीपूर्ण उदाहरण देखू . |
template |
डोरी | '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' |
टूलटिप बनाबय के समय उपयोग करय लेल एचटीएमएल के आधार बनाउ. टूलटिप के
सबसँ बाहरी रैपर तत्व मे |
title |
तार | तत्व | आयोजन | '' |
यदि कोनो फंक्शन देल गेल अछि त ओकरा अपन |
trigger |
डोरी | 'hover focus' |
टूलटिप कोना ट्रिगर होइत अछि - क्लिक करू | मंडराइत | फोकस | हाथ सं कएल गेल. अहाँ अनेक ट्रिगर पास क सकैत छी; एकरा सभकेँ एकटा रिक्त स्थानसँ अलग करू।
|
fallbackPlacements |
सरणी | ['top', 'right', 'bottom', 'left'] |
सरणी मे प्लेसमेंट कें सूची उपलब्ध करा क (प्राथमिकता कें क्रम मे) फॉलबैक प्लेसमेंट कें परिभाषित करूं. अधिक जानकारी के लेल पॉपर के व्यवहार डॉक्स देखू |
boundary |
तार | तत्त्व | 'clippingParents' |
टूलटिप क' ओवरफ्लो बाधा सीमा (केवल पॉपर क' preventOverflow संशोधक पर लागू होइत अछि)। डिफ़ॉल्ट रूप स॑ ई 'clippingParents' HTMLElement संदर्भ (केवल जावास्क्रिप्ट के माध्यम स॑) छै आरू स्वीकार करी सकै छै । अधिक जानकारी क लेल Popper क detectOverflow docs देखू . |
customClass |
तार | आयोजन | '' |
टूलटिप देखाओल गेला पर क्लास जोड़ू. ध्यान रहे कि ई वर्ग टेम्पलेट म॑ निर्दिष्ट कोनो भी वर्ग के अलावा जोड़लऽ जैतै । एक सँ बेसी वर्ग जोड़बाक लेल, ओकरा रिक्त स्थान सँ अलग करू: अहां एकटा एहन फंक्शन सेहो पास क सकय छी जे एकटा स्ट्रिंग रिटर्न करबाक चाही जाहि मे अतिरिक्त क्लास नाम होएत. |
sanitize |
बूलियन | true |
सेनेटाइजेशन सक्षम या अक्षम करू। अगर सक्रिय भ 'template' गेल आ 'title' विकल्प के सेनेटाइज कएल जाएत। हमर जावास्क्रिप्ट दस्तावेजीकरण मे सेनेटाइजर खंड देखू . |
allowList |
वस्तु | पूर्वनिर्धारित मान | ऑब्जेक्ट जइ मे अनुमति देल गेल विशेषता आ टैग होयत छै |
sanitizeFn |
शून्य | आयोजन | null |
एतय अहां अपन सेनेटाइज फंक्शन के सप्लाई क सकय छी. यदि अहां सेनेटाइजेशन करएय कें लेल समर्पित पुस्तकालय कें उपयोग करनाय पसंद करएयत छी त इ उपयोगी भ सकएय छै. |
offset |
सरणी | तार | आयोजन | [0, 0] |
टूलटिप के अपन लक्ष्य के सापेक्ष ऑफसेट। अहां अल्पविराम सं अलग मान कें साथ डाटा विशेषताक मे एकटा स्ट्रिंग पास कयर सकय छी जेना: जब॑ कोनो फंक्शन क॑ ऑफसेट निर्धारित करै लेली प्रयोग करलऽ जाय छै त॑ ओकरा एगो ऑब्जेक्ट स॑ कॉल करलऽ जाय छै जेकरा म॑ पॉपर प्लेसमेंट, रेफरेंस, आरू पॉपर रेक्ट्स क॑ ओकरऽ पहिलऽ आर्गुमेंट के रूप म॑ शामिल करलऽ जाय छै । ट्रिगरिंग तत्व DOM नोड कें दोसर तर्क कें रूप मे पास करल गेलय छै. फंक्शन केँ दू नंबरक संग एकटा सरणी वापस करबाक चाही: . अधिक जानकारी के लेल पॉपर के ऑफसेट डॉक्स देखू . |
popperConfig |
शून्य | वस्तु | आयोजन | null |
बूटस्ट्रैप क पूर्वनिर्धारित Popper कॉन्फ़िगरेशन बदलबाक लेल, देखू Popper क विन्यास . जब॑ कोनों फंक्शन क॑ पॉपर कॉन्फ़िगरेशन बनाबै लेली इस्तेमाल करलऽ जाय छै, त॑ ओकरा एगो ऑब्जेक्ट स॑ कॉल करलऽ जाय छै जेकरा म॑ बूटस्ट्रैप केरऽ डिफ़ॉल्ट पॉपर कॉन्फ़िगरेशन होय छै. इ अहां कें डिफ़ॉल्ट कें उपयोग आ अपन विन्यास कें साथ मर्ज करय मे मदद करयत छै. फंक्शन केँ पॉपर क' लेल एकटा कॉन्फ़िगरेशन ऑब्जेक्ट वापस करबाक चाही. |
व्यक्तिगत टूलटिप्स के लिये डेटा विशेषताएँ
व्यक्तिगत टूलटिप्स कें लेल विकल्प वैकल्पिक रूप सं डेटा विशेषताक कें उपयोग कें माध्यम सं निर्दिष्ट कैल जा सकय छै, जैना की ऊपर व्याख्या कैल गेल छै.
के साथ फंक्शन का प्रयोगpopperConfig
var tooltip = new bootstrap.Tooltip(element, {
popperConfig: function (defaultBsPopperConfig) {
// var newPopperConfig = {...}
// use defaultBsPopperConfig if needed...
// return newPopperConfig
}
})
विधियाँ
अतुल्यकालिक विधि एवं संक्रमण
सब एपीआई विधि एसिंक्रोनस अछि आ एकटा संक्रमण शुरू करैत अछि . संक्रमण शुरू होइते मुदा समाप्त होए सं पहिने फोन करय वाला के पास वापस आबि जाइत छथिन्ह . एकर अलावा, एकटा संक्रमण घटक पर एकटा विधि कॉल कें अनदेखी कैल जेतय .
प्रदर्शन
कोनो तत्व के टूलटिप के उजागर करैत अछि. टूलटिप कें वास्तव मे दिखाएय सं पहिले (अर्थात shown.bs.tooltip
घटना घटित हुअ सं पहिले) कॉलर कें पास वापस आबि जायत छै. एकरा टूलटिप केरऽ “मैनुअल” ट्रिगरिंग मानलऽ जाय छै । शून्य-लंबाई शीर्षक वाला टूलटिप कहियो प्रदर्शित नहि कएल जाएत अछि.
tooltip.show()
नुकाउ
कोनो तत्वक टूलटिपकेँ नुकाबैत अछि। टूलटिप कें वास्तव मे नुकाएय सं पहिले (अर्थात hidden.bs.tooltip
घटना घटित हुअ सं पहिले) कॉलर कें वापस आबि जायत छै. एकरा टूलटिप केरऽ “मैनुअल” ट्रिगरिंग मानलऽ जाय छै ।
tooltip.hide()
टॉगल करब
कोनो तत्वक टूलटिप टॉगल करैत अछि. टूलटिप कें वास्तव मे दिखायल गेलय या नुकाएलय सं पहिले (अर्थात shown.bs.tooltip
या hidden.bs.tooltip
घटना घटित हुअ सं पहिले) कॉलर कें पास वापस आबै छै. एकरा टूलटिप केरऽ “मैनुअल” ट्रिगरिंग मानलऽ जाय छै ।
tooltip.toggle()
निपटान करब
कोनों तत्व कें टूलटिप कें छिपायत छै आ नष्ट करयत छै (DOM तत्व पर संग्रहीत डाटा कें हटायत छै). टूलटिप्स जे प्रत्यायोजन कें उपयोग करयत छै (जे विकल्प कें उपयोग करयतselector
बनायल गेल छै ) कें वंशज ट्रिगर तत्वक पर व्यक्तिगत रूप सं नष्ट नहि कैल जा सकय छै.
tooltip.dispose()
योग्य करनाइ
कोनो तत्व के टूलटिप के देखाबय के क्षमता दैत अछि. टूलटिप्स डिफ़ॉल्ट रूप सँ सक्षम अछि.
tooltip.enable()
असमर्थ
कोनो तत्व क' टूलटिप क' लेल देखाओल जेबाक क्षमता हटा दैत अछि. टूलटिप तखने देखाओल जा सकैत अछि जखन ओकरा पुनः सक्षम कएल जाएत.
tooltip.disable()
toggleसक्षम कएल गेल
कोनों तत्व कें टूलटिप कें दिखावा या छिपाबै कें क्षमता कें टॉगल करयत छै.
tooltip.toggleEnabled()
अपडेट
कोनो तत्व क' टूलटिप क' स्थिति अपडेट करैत अछि.
tooltip.update()
getInstance
स्थिर विधि जे अहां कें कोनों डोम तत्व सं जुड़ल टूलटिप इंस्टेंस प्राप्त करय कें अनुमति देयत छै
var exampleTriggerEl = document.getElementById('example')
var tooltip = bootstrap.Tooltip.getInstance(exampleTriggerEl) // Returns a Bootstrap tooltip instance
getOrCreateInstance के लिये
स्थिर विधि जे अहां कें कोनों DOM तत्व सं जुड़ल टूलटिप इंस्टेंस प्राप्त करय कें अनुमति देयत छै, या एकटा नव बनावा कें स्थिति मे इ आरंभ नहि कैल गेलय
var exampleTriggerEl = document.getElementById('example')
var tooltip = bootstrap.Tooltip.getOrCreateInstance(exampleTriggerEl) // Returns a Bootstrap tooltip instance
घटनाक्रम
घटना प्रकार | वर्णन |
---|---|
show.bs.tooltip |
show इंस्टेंस मेथड कें कॉल करय पर इ घटना तुरंत फायर भ जायत छै. |
shown.bs.tooltip |
ई घटना तखन फायर कएल जाइत अछि जखन टूलटिप उपयोगकर्ताक लेल दृश्यमान बनाओल गेल अछि (सीएसएस संक्रमण पूरा होएबाक प्रतीक्षा करत)। |
hide.bs.tooltip |
ई घटना तुरंत फायर कएल जाइत अछि जखन hide इंस्टेंस मेथड कॉल कएल गेल अछि. |
hidden.bs.tooltip |
ई घटना तखन फायर कएल जाइत अछि जखन टूलटिप उपयोगकर्ता सँ नुकाएब समाप्त भ' जाइत अछि (सीएसएस संक्रमण पूरा होएबाक प्रतीक्षा करत)। |
inserted.bs.tooltip |
ई घटना घटना के बाद फायर करलऽ जाय छै show.bs.tooltip जब॑ टूलटिप टेम्पलेट क॑ DOM म॑ जोड़लऽ गेलऽ छै । |
var myTooltipEl = document.getElementById('myTooltip')
var tooltip = new bootstrap.Tooltip(myTooltipEl)
myTooltipEl.addEventListener('hidden.bs.tooltip', function () {
// do something...
})
tooltip.hide()