पोपोव्हर्स हें नांव
तुमच्या साइटचेर खंयच्याय घटकाक iOS त मेळपी सारके Bootstrap popovers जोडपा खातीर दस्तावेजीकरण आनी उदाहरणां.
नियाळ
पॉपओवर प्लगइन वापरतना कळपाच्यो गजाली:
- पोपोव्हर्स पोझिशनिंग खातीर 3 व्या पक्षाच्या लायब्ररी पॉपराचेर आदारून आसतात . तुमी bootstrap.js पयलीं popper.min.js समाविष्ट करपाक जाय वा popovers काम करपाक
bootstrap.bundle.min.js
/ वापरपाक जायbootstrap.bundle.js
जातूंत Popper आसा! - Popovers एक अवलंबन म्हणून टूलटिप प्लगइनाची गरज आसा.
- Popovers कार्यक्षमताय कारणांक लागून ऑप्ट-इन आसात, देखून तुमी स्वता तांकां आरंभ करपाक जाय .
- शून्य-लांबाय
title
आनीcontent
मोलां केन्नाच पोपोव्हर दाखोवचीं नात. container: 'body'
चड गुंतागुंतीच्या घटकांत (जशे आमचे इनपुट गट, बटण गट, आदी) रेंडरिंग समस्या टाळपाक निर्देशीत करात .- लिपिल्ल्या घटकांचेर पोपोव्हर ट्रिगर करप काम करचें ना.
.disabled
वा घटकांखातीर पोपोव्हरdisabled
रॅपर घटकाचेर ट्रिगर करपाक जाय.- एका परस चड ओळीं वयल्यान गुठलायल्ल्या नांगरांतल्यान ट्रिगर करतना, पोपोव्हर नांगरांच्या एकंदर रुंदाये मदीं केंद्रीत आसतले. ही वागणूक टाळपाक
.text-nowrap
तुमच्या s चेर वापरात .<a>
- डीओएमांतल्यान तांचे संबंदीत घटक काडून उडोवचे पयलीं पोपोव्हर लिपोवंक जाय.
- सावळी DOM भितरल्या एका घटकाक लागून पॉपओव्हर ट्रिगर जावंक शकतात.
prefers-reduced-motion
माध्यम क्वेरीचेर आदारून आसता. आमच्या सुलभताय दस्तावेजीकरणाचो उणो केल्ली गती विभाग पळयात
.
कांय उदाहरणां सयत पोपोव्हर कशे काम करतात तें पळोवपाक वाचत रावचें.
देखीक: सगळेकडेन पोपोव्हर सक्षम करात
पानाचेर सगळे पॉपओव्हर आरंभ करपाचो एक मार्ग म्हणल्यार तांच्या data-bs-toggle
गुणधर्मा प्रमाणें निवडप:
var popoverTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="popover"]'))
var popoverList = popoverTriggerList.map(function (popoverTriggerEl) {
return new bootstrap.Popover(popoverTriggerEl)
})
देखीक: container
पर्याय वापरप
जेन्ना तुमचे कडेन पालक घटकाचेर कांय शैली आसतात जीं पॉपओवरांत हस्तक्षेप करतात, तेन्ना तुमकां सानुकूल निर्देशीत करूंक जाय container
जेणे करून ताचे बदला पोपोव्हराचो HTML त्या घटका भितर दिसतलो.
var popover = new bootstrap.Popover(document.querySelector('.example-popover'), {
container: 'body'
})
उदारण
<button type="button" class="btn btn-lg btn-danger" data-bs-toggle="popover" title="Popover title" data-bs-content="And here's some amazing content. It's very engaging. Right?">Click to toggle popover</button>
चार दिकां
चार पर्याय उपलब्ध आसात: वयर, उजवें, सकयल, आनी डावें संरेखित. RTL त Bootstrap वापरतना दिश्टीकोन मिरर जातात.
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="top" data-bs-content="Top popover">
Popover on top
</button>
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="right" data-bs-content="Right popover">
Popover on right
</button>
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="bottom" data-bs-content="Bottom popover">
Popover on bottom
</button>
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="left" data-bs-content="Left popover">
Popover on left
</button>
फुडल्या क्लिकाचेर डिसमिस करात
focus
टॉगल घटका परस वेगळ्या घटकाचेर वापरप्याच्या फुडल्या क्लिकाचेर पॉपओव्हर काडून उडोवपाक ट्रिगर वापरात .
फुडल्या क्लिकाचेर डिसमिस करपाक विशिश्ट मार्कअप जाय
<a>
योग्य क्रॉस-ब्राउझर आनी क्रॉस-प्लॅटफॉर्म वर्तना खातीर, तुमी टॅग वापरपाक जाय, टॅग न्हय<button>
, आनी तुमी गुणधर्मूय समाविष्ट करपाक जाय tabindex
.
<a tabindex="0" class="btn btn-lg btn-danger" role="button" data-bs-toggle="popover" data-bs-trigger="focus" title="Dismissible popover" data-bs-content="And here's some amazing content. It's very engaging. Right?">Dismissible popover</a>
var popover = new bootstrap.Popover(document.querySelector('.popover-dismiss'), {
trigger: 'focus'
})
अक्षम केल्ले घटक
गुणधर्म आशिल्ले घटक disabled
परस्पर संवादात्मक नात, म्हळ्यार वापरप्यांक पॉपओवर (वा साधनटिप) सुरू करपाक तांकां होवर वा क्लिक करूंक मेळना. एक उपाय म्हणून, तुमकां एक रॅपरांतल्यान पॉपओवर ट्रिगर करपाक जाय <div>
वा <span>
, आदर्श रितीन वापरून कीबोर्ड-केंद्रीत करपाक योग्य केल्लें tabindex="0"
.
अक्षम पॉपओवर ट्रिगरां खातीर, तुमी पसंत करूंक शकतात data-bs-trigger="hover focus"
जेणे करून पॉपओवर तुमच्या वापरप्यांक तात्काळ दृश्य प्रतिसाद दिसतलो कारण ते अक्षम घटकाचेर क्लिक करपाची अपेक्षा करूंक शकनात.
<span class="d-inline-block" tabindex="0" data-bs-toggle="popover" data-bs-trigger="hover focus" data-bs-content="Disabled popover">
<button class="btn btn-primary" type="button" disabled>Disabled button</button>
</span>
सास
चड-उणें
$popover-font-size: $font-size-sm;
$popover-bg: $white;
$popover-max-width: 276px;
$popover-border-width: $border-width;
$popover-border-color: rgba($black, .2);
$popover-border-radius: $border-radius-lg;
$popover-inner-border-radius: subtract($popover-border-radius, $popover-border-width);
$popover-box-shadow: $box-shadow;
$popover-header-bg: shade-color($popover-bg, 6%);
$popover-header-color: $headings-color;
$popover-header-padding-y: .5rem;
$popover-header-padding-x: $spacer;
$popover-body-color: $body-color;
$popover-body-padding-y: $spacer;
$popover-body-padding-x: $spacer;
$popover-arrow-width: 1rem;
$popover-arrow-height: .5rem;
$popover-arrow-color: $popover-bg;
$popover-arrow-outer-color: fade-in($popover-border-color, .05);
वापर
जावास्क्रिप्ट वरवीं पॉपओव्हर सक्षम करात:
var exampleEl = document.getElementById('example')
var popover = new bootstrap.Popover(exampleEl, options)
कीबोर्ड आनी सहाय्यक तंत्रज्ञान वापरप्यां खातीर पॉपओव्हर काम करप
कीबोर्ड वापरप्यांक तुमचे पॉपओव्हर सक्रिय करपाक परवानगी दिवपाक, तुमी फकत HTML घटकांत जोडपाक जाय जे परंपरेन कीबोर्ड-केंद्रीत करपाक येवपी आनी परस्पर संवादात्मक आसात (देखीक दुवे वा फॉर्म नियंत्रण). जरी मनमानी HTML घटक (देखीक <span>
s) गुणधर्म जोडून केंद्रीत करूंक शकता tabindex="0"
, तरी कीबोर्ड वापरप्यां खातीर बिगर परस्पर संवादात्मक घटकांचेर संभाव्य त्रासदायक आनी गोंदळाचे टॅब थांब जोडटले, आनी चडशे सहाय्यक तंत्रज्ञान सद्या हे परिस्थितींत पॉपओवराची सामग्री जाहीर करिनात हें . ते भायर, तुमच्या पॉपओव्हरां खातीर फकत ट्रिगर म्हणून आदारून रावूं नाकात hover
, कारण हाका लागून कीबोर्ड वापरप्यां खातीर तांकां ट्रिगर करप अशक्य जातलें.
तुमी पर्याया सयत popovers मदीं गिरेस्त, संरचीत HTML घालूंक शकतात, तरी तुमी html
चड प्रमाणांत सामुग्री जोडप टाळपाची आमी खर शिफारस करतात. सद्या पॉपओव्हर काम करपाची पद्दत म्हळ्यार, एकदां दाखयल्या उपरांत, तांची सामग्री aria-describedby
गुणधर्म आशिल्ल्या ट्रिगर घटकाक बांदिल्ली आसता. ताका लागून, पॉपओवराची पुराय सामग्री एक लांब, अखंड प्रवाह म्हणून सहाय्यक तंत्रज्ञान वापरप्यांक जाहीर करतले.
ते भायर, तुमच्या पॉपओवरांत परस्पर नियंत्रणां (देखीक फॉर्म घटक वा दुवे) लेगीत समाविष्ट करप शक्य आसलें तरी (हे घटक allowList
परवानगी दिल्ल्या गुणधर्म आनी टॅगांत जोडून), सद्या पॉपओवर कीबोर्ड फोकस क्रम वेवस्थापन करिना हाची जतनाय घेयात. जेन्ना कीबोर्ड वापरपी पॉपओवर उगडटा, तेन्ना लक्ष ट्रिगर करपी घटकाचेर उरता, आनी पॉपओव्हर चड करून दस्तावेजाच्या संरचनेंत ट्रिगराक रोखडोच पाळनाशिल्ल्यान, मुखार वचप/दाबपाची हमी नाTABकीबोर्ड वापरप्याक स्वता पॉपओवरांत व्हरतले. थोडयाच उतरांनी, फकत पॉपओवरांत परस्पर नियंत्रण जोडल्यार हे नियंत्रण कीबोर्ड वापरप्यां खातीर आनी सहाय्यक तंत्रज्ञानाच्या वापरप्यां खातीर अप्राप्य/वापरपाक शकना अशीं करपाची शक्यताय आसा, वा उण्यांत उणें एक अतार्किक एकंदर फोकस ऑर्डर करपाची शक्यताय आसा. ह्या प्रकरणांत, ताचे बदला मोडल संवाद वापरपाचो विचार करात.
पर्याय आसात
पर्याय डेटा गुणधर्म वा जावास्क्रिप्ट वरवीं पास करूंक शकतात. डेटा गुणधर्मांखातीर, पर्याय नांव जोडात data-bs-
, जशें data-bs-animation=""
. डेटा गुणधर्मां वरवीं पर्याय पास करतना पर्याय नांवाचो केस प्रकार camelCase वयल्यान kebab-case कडेन बदलपाची खात्री करात. देखीक, वापरचे बदला data-bs-customClass="beautifier"
वापरात data-bs-custom-class="beautifier"
.
sanitize
,
sanitizeFn
, आनी
allowList
पर्याय डेटा गुणधर्म वापरून पुरवण करूंक शकना.
नांव | प्रकार | डिफॉल्ट | वर्णन |
---|---|---|---|
animation |
बूलियन हें नांव | true |
पॉपओवराक CSS फेड संक्रमण लागू करात |
container |
तार | तत्व | फट | false |
एका विशिश्ट घटकाक पोपोव्हर जोडटा. देखीक: |
content |
तार | तत्व | कार्य | '' |
फंक्शन दिल्लें आसल्यार, तें |
delay |
संख्या | ऑब्जॅक्ट | 0 |
पॉपओवर दाखोवपाक आनी लिपोवपाक कळाव (ms) - हाताळणी ट्रिगर प्रकाराक लागू जायना क्रमांक पुरवण केल्यार, लिपोवप/दाखोवप ह्या दोनूय गजालींक विलंब लागू जाता वस्तूची रचणूक अशी आसा: १. |
html |
बूलियन हें नांव | false |
पॉपओवरांत एचटीएमएल घालात. खोटें आसल्यार, innerText DOM त सामुग्री घालपाक गुणधर्म वापरतले. XSS हल्ल्याचो हुस्को आसल्यार मजकूर वापरात. |
placement |
तार | कार्य | 'right' |
पोपोवर कशें पोजीशन दिवप - ऑटो | शीर्ष | तळें | उवें | उजवें. जेन्ना प्लेसमेंट थारावपाखातीर फंक्शन वापरतात, तेन्ना ताका पॉपओवर DOM नोड हो पयलो आर्ग्युमेंट आनी ट्रिगरिंग एलिमेंट DOM नोड दुसरो म्हूण कॉल करतात. संदर्भ |
selector |
तार | फट | false |
निवडक पुरवण केल्यार, पॉपओवर वस्तू निर्दिश्ट लक्ष्यांक प्रत्यायित करतले. वेव्हारांत, डायनॅमिक HTML सामुग्री पॉपओव्हर जोडपाक सक्षम करपाक हाचो वापर जाता. हें आनी एक माहितीपूर्ण उदाहरण पळयात . |
template |
माळ | '<div class="popover" role="tooltip"><div class="popover-arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>' |
पॉपओवर तयार करतना वापरपाक बेस HTML. पोपोव्हर'स पोपोव्हर'स
सगळ्यांत भायल्या आवरण घटकाक |
title |
तार | तत्व | कार्य | '' |
फंक्शन दिल्लें आसल्यार, तें |
trigger |
माळ | 'click' |
पॉपओवर कसो सुरू जाता - क्लिक करात | होवर करप | लक्ष केंद्रीत करप | मॅन्युअल. तुमी जायते ट्रिगर पास करूंक शकतात; तांकां एक जाग्यान वेगळें करतात. manual हेर खंयच्याय ट्रिगराक जोडूंक मेळना. |
fallbackPlacements |
सरणी | ['top', 'right', 'bottom', 'left'] |
ऍरेंतल्या प्लेसमेंटांची वळेरी दिवन (पसंतीच्या क्रमांकान) फॉलबॅक प्लेसमेंट व्याख्या करात. चड म्हायती खातीर Popper च्या वर्तनाच्या डॉक्स पळयात |
boundary |
तार | घटक | 'clippingParents' |
पॉपओवराची ओव्हरफ्लो बंधन मर्यादा (फकत पॉपराच्या preventOverflow संशोधकाक लागू जाता). पूर्वनिर्धारीतपणान तो 'clippingParents' HTMLElement संदर्भ आसा आनी मान्य करूंक शकता (फकत JavaScript वरवीं). चड म्हायती खातीर पळयात Popper's detectOverflow docs . |
customClass |
तार | कार्य | '' |
पोपोव्हर दाखयल्या उपरांत वर्ग जोडात. लक्षांत दवरात की हे वर्ग साच्यांत निर्देशीत केल्ल्या खंयच्याय वर्गांवांगडाच जोडटले. जायते वर्ग जोडपाक, तांकां रिक्तींनी वेगळे करात: तुमी एक फंक्शनय पास करूंक शकतात जें अतिरिक्त वर्ग नांवां आशिल्ली एकूच स्ट्रिंग परत दिवपाक जाय. |
sanitize |
बूलियन हें नांव | true |
सॅनिटायझेशन सक्षम वा अक्षम करचें. If activated 'template' , 'content' आनी 'title' पर्याय सॅनिटायझ जातले. आमच्या जावास्क्रिप्ट दस्तावेजीकरणांतलो सॅनिटायझर विभाग पळयात . |
allowList |
ऑब्जॅक्ट | मुलभूत मोल | परवानगी दिल्ले गुणधर्म आनी टॅग आशिल्ली वस्तू |
sanitizeFn |
शून्य | कार्य | null |
हांगा तुमी तुमचें स्वताचें सॅनिटायज फंक्शन पुरवण करूंक शकतात. सॅनिटायझेशन करपाक तुमकां समर्पीत लायब्ररी वापरपाक आवडटा जाल्यार हें उपेगी पडूं येता. |
offset |
सरणी | तार | कार्य | [0, 8] |
ताच्या लक्ष्याच्या सापेक्ष पोपोव्हराचें ऑफसेट. तुमी स्वल्पविराम वेगळे केल्ल्या मोलां सयत डेटा गुणधर्मांत स्ट्रिंग पास करूंक शकतात जशे की: जेन्ना ऑफसेट थारावपाखातीर फंक्शन वापरतात तेन्ना ताका पॉपर प्लेसमेंट, संदर्भ आनी पॉपर रेक्ट्स हें ताचो पयलो आर्ग्युमेंट म्हणून आशिल्ल्या वस्तून कॉल करतात. ट्रिगर करपी घटक DOM नोड दुसरो आर्ग्युमेंट म्हणून पास जाता. फंक्शनान दोन क्रमांक आशिल्ली ऍरे परत दिवपाक जाय: . चड म्हायती खातीर पळयात Popper's offset docs . |
popperConfig |
शून्य | वस्तू | कार्य | null |
Bootstrap ची मुलभूत Popper संरचना बदलपाक, पळयात Popper ची संरचना . जेन्ना Popper संरचना तयार करपाक फंक्शन वापरतात, तेन्ना तें Bootstrap ची मुलभूत Popper संरचना आशिल्ल्या वस्तून कॉल करतात. तो तुमकां तुमच्या स्वताच्या संरचने वांगडा मुलभूत वापरपाक आनी विलीन करपाक मदत करता. फंक्शनान Popper खातीर संरचना वस्तू परत दिवपाक जाय. |
वैयक्तीक पोपोव्हरां खातीर डेटा गुणधर्म
वैयक्तीक पॉपओव्हरां खातीर पर्याय पर्यायीपणान डेटा गुणधर्मांच्या वापरा वरवीं निर्देशीत करूंक शकतात, जशें वयर स्पश्ट केलां.
कडेन फंक्शन वापरपpopperConfig
var popover = new bootstrap.Popover(element, {
popperConfig: function (defaultBsPopperConfig) {
// var newPopperConfig = {...}
// use defaultBsPopperConfig if needed...
// return newPopperConfig
}
})
पद्दती
अतुल्यकालिक पद्दती आनी संक्रमण
सगळ्यो एपीआय पद्दती अतुल्यकालिक आसतात आनी संक्रमण सुरू करतात . संक्रमण सुरू जातकच पूण सोंपचे पयलीं ते फोन करप्या कडेन परततात . ते भायर, संक्रमण घटकाचेर एक पद्दत कॉल दुर्लक्षीत जातलें .
दाखोवचें
एका घटकाचो पोपोव्हर उक्तो करता. पॉपओवर प्रत्यक्षांत दाखोवचे पयलीं (म्हळ्यार shown.bs.popover
घडणूक घडचे पयलीं) कॉलराक परतता. हाका पोपोव्हराचें “हस्तिका” ट्रिगरिंग मानतात. ज्या पोपोव्हरांचें शीर्षक आनी आशय दोनूय शून्य लांबायेचे आसतात, ते केन्नाच दाखोवंक नात.
myPopover.show()
लिपोवचें
एका घटकाचो पोपोव्हर लिपयता. पॉपओव्हर प्रत्यक्षांत लिपोवचे पयलीं (म्हळ्यार hidden.bs.popover
घडणूक घडचे पयलीं) कॉलराक परतता. हाका पोपोव्हराचें “हस्तिका” ट्रिगरिंग मानतात.
myPopover.hide()
टॉगल करप
एका घटकाचो पॉपओवर टॉगल करता. पॉपओवर प्रत्यक्षांत दाखोवचे पयलीं वा लिपोवचे पयलीं (म्हळ्यार shown.bs.popover
वा hidden.bs.popover
घडणूक घडचे पयलीं) कॉलराक परतता. हाका पोपोव्हराचें “हस्तिका” ट्रिगरिंग मानतात.
myPopover.toggle()
विलो लावप
घटकाचो पॉपओवर लिपयता आनी नश्ट करता (DOM घटकाचेर सांठयल्लो डेटा काडून उडयता). प्रतिनिधीत्व वापरपी पोपोव्हर (जे पर्याय वापरून तयार केल्लेselector
आसात ) वंशज ट्रिगर घटकांचेर वैयक्तीकपणान नश्ट करूंक शकना.
myPopover.dispose()
सक्षम
एका घटकाच्या पोपोव्हराक दाखोवपाची तांक दिता. Popovers पूर्वनिर्धारीतपणान सक्षम केल्ले आसात.
myPopover.enable()
निश्क्रीय करचें
एका घटकाचो पोपोव्हर दाखोवपाची तांक काडून उडयता. पोपोव्हर फकत परतून सक्षम केल्यारूच दाखोवंक मेळटलो.
myPopover.disable()
toggleसक्षम केला
घटकाचो पॉपओवर दाखोवपाची वा लिपोवपाची क्षमता टॉगल करता.
myPopover.toggleEnabled()
अपडेट
घटकाच्या पॉपओवराची सुवात अद्ययावत करता.
myPopover.update()
getInstance हें नांव
स्थिर पद्दत जी तुमकां DOM घटकाकडेन संबंदीत आशिल्ली पॉपओवर दृष्टांत मेळोवपाक परवानगी दिता
var exampleTriggerEl = document.getElementById('example')
var popover = bootstrap.Popover.getInstance(exampleTriggerEl) // Returns a Bootstrap popover instance
getOrCreateInstance हें पान करचें
स्थिर पद्दत जी तुमकां DOM घटका कडेन संबंदीत पॉपओवर दृष्टांत मेळोवपाक परवानगी दिता, वा ती आरंभ करूंक नाशिल्ल्या प्रकरणांत नवी तयार करपाक परवानगी दिता
var exampleTriggerEl = document.getElementById('example')
var popover = bootstrap.Popover.getOrCreateInstance(exampleTriggerEl) // Returns a Bootstrap popover instance
घडणुको
इव्हेंट प्रकार | वर्णन |
---|---|
शो.बीएस.पोपओव्हर | show दृष्टांत पद्दत कॉल करतना ही घडणूक रोखडीच फायर जाता . |
दाखयलें.bs.popover | वापरप्याक पॉपओव्हर दिसपाक लायल्यार ही घडणूक फायर जाता (CSS संक्रमण पुराय जावपाची वाट पळयतले). |
hide.bs.popover हें नांव | hide दृष्टांत पद्दत कॉल केल्या उपरांत ही घडणूक रोखडीच फायर जाता . |
लिपलां.बीएस.गरीबी | वापरप्या कडल्यान लिपोवपाचें पॉपओवर सोंपतकच ही घडणूक फायर जाता (CSS संक्रमण पुराय जावपाची वाट पळयतले). |
घालून.bs.popover | show.bs.popover जेन्ना पॉपओव्हर साचा DOM कडेन जोडला तेन्ना घडणुके उपरांत ही इव्हेंट फायर करतात. |
var myPopoverTrigger = document.getElementById('myPopover')
myPopoverTrigger.addEventListener('hidden.bs.popover', function () {
// do something...
})