Popovers
बुटस्ट्र्याप पोपोभरहरू थप्नका लागि दस्तावेज र उदाहरणहरू, जस्तै iOS मा पाइने, तपाईंको साइटको कुनै पनि तत्वमा।
पपओभर प्लगइन प्रयोग गर्दा जान्नुपर्ने कुराहरू:
- पोपोभरहरू पोजिसनिङका लागि तेस्रो पक्षको पुस्तकालय Popper.js मा निर्भर हुन्छन् । तपाईंले bootstrap.js अघि popper.min.js समावेश गर्नुपर्छ वा popoovers काम गर्नको लागि Popper.js समावेश गर्ने
bootstrap.bundle.min.js
/ प्रयोग गर्नुहोस्!bootstrap.bundle.js
- Popovers लाई निर्भरताको रूपमा टुलटिप प्लगइन चाहिन्छ।
- यदि तपाइँ स्रोतबाट हाम्रो जाभास्क्रिप्ट निर्माण गर्दै हुनुहुन्छ भने, यो आवश्यक छ
util.js
। - Popovers कार्यसम्पादन कारणहरूको लागि अप्ट-इन हुन्छन्, त्यसैले तपाईंले तिनीहरूलाई आफैं सुरु गर्नुपर्छ ।
- शून्य-लम्बाइ
title
रcontent
मानहरूले कहिल्यै पपओभर देखाउँदैनन्। container: 'body'
थप जटिल कम्पोनेन्टहरू (जस्तै हाम्रो इनपुट समूहहरू, बटन समूहहरू, आदि) मा रेन्डरिङ समस्याहरूबाट बच्न निर्दिष्ट गर्नुहोस्।- लुकेका तत्वहरूमा पपओभर ट्रिगर गर्ने कार्यले काम गर्दैन।
.disabled
वा तत्वहरूका लागि पपओभरहरू र्यापरdisabled
तत्वमा ट्रिगर हुनुपर्छ।- एङ्करहरूबाट ट्रिगर गर्दा धेरै रेखाहरूमा लपेटिन्छ, पपोभरहरू एङ्करहरूको समग्र चौडाइको बीचमा केन्द्रित हुनेछन्। यो व्यवहारबाट बच्न
white-space: nowrap;
आफ्नो s मा प्रयोग गर्नुहोस्।<a>
- DOM बाट सम्बन्धित तत्वहरू हटाउनु अघि पोपोभरहरू लुकाउनु पर्छ।
popovers केहि उदाहरणहरु संग काम कसरी हेर्न को लागी पढ्न जारी राख्नुहोस्।
एक पृष्ठमा सबै popovers प्रारम्भ गर्न एक तरिका तिनीहरूलाई तिनीहरूको data-toggle
विशेषता द्वारा चयन गर्न हुनेछ:
$(function () {
$('[data-toggle="popover"]').popover()
})
जब तपाइँसँग एक अभिभावक तत्वमा केहि शैलीहरू छन् जुन पपओभरमा हस्तक्षेप गर्दछ, तपाइँ एक अनुकूलन निर्दिष्ट गर्न चाहानुहुन्छ container
ताकि पपओभरको HTML त्यस तत्व भित्र देखा पर्दछ।
$(function () {
$('.example-popover').popover({
container: 'body'
})
})
<button type="button" class="btn btn-lg btn-danger" data-toggle="popover" title="Popover title" data-content="And here's some amazing content. It's very engaging. Right?">Click to toggle popover</button>
चार विकल्पहरू उपलब्ध छन्: शीर्ष, दायाँ, तल, र बायाँ पङ्क्तिबद्ध।
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="top" data-content="Vivamus sagittis lacus vel augue laoreet rutrum faucibus.">
Popover on top
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="right" data-content="Vivamus sagittis lacus vel augue laoreet rutrum faucibus.">
Popover on right
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="bottom" data-content="Vivamus
sagittis lacus vel augue laoreet rutrum faucibus.">
Popover on bottom
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="left" data-content="Vivamus sagittis lacus vel augue laoreet rutrum faucibus.">
Popover on left
</button>
focus
टगल एलिमेन्ट भन्दा फरक तत्वको प्रयोगकर्ताको अर्को क्लिकमा पपओभरहरू खारेज गर्न ट्रिगर प्रयोग गर्नुहोस्।
खारेज-अन-अर्को-क्लिकको लागि विशिष्ट मार्कअप आवश्यक छ
उचित क्रस-ब्राउजर र क्रस-प्लेटफर्म व्यवहारको लागि, तपाईंले ट्याग प्रयोग गर्नुपर्छ, ट्याग <a>
होइन , र तपाईंले एट्रिब्यूट <button>
पनि समावेश गर्नुपर्छ ।tabindex
<a tabindex="0" class="btn btn-lg btn-danger" role="button" data-toggle="popover" data-trigger="focus" title="Dismissible popover" data-content="And here's some amazing content. It's very engaging. Right?">Dismissible popover</a>
$('.popover-dismiss').popover({
trigger: 'focus'
})
विशेषता भएका तत्वहरू disabled
अन्तरक्रियात्मक छैनन्, यसको मतलब प्रयोगकर्ताहरूले पपओभर (वा टूलटिप) ट्रिगर गर्न तिनीहरूलाई होभर वा क्लिक गर्न सक्दैनन्। एक समाधानको रूपमा, तपाइँ पपओभरलाई र्यापरबाट ट्रिगर गर्न <div>
वा असक्षम तत्वमा <span>
ओभरराइड गर्न चाहानुहुन्छ।pointer-events
अ���क्षम पपओभर ट्रिगरहरूका लागि, तपाईंले पपओभर तपाईंको प्रयोगकर्ताहरूलाई तत्काल भिजुअल प्रतिक्रियाको रूपमा देखा पर्न पनि रुचाउन सक्नुहुन्छ किनकि उनीहरूले असक्षम तत्वमा क्लिकdata-trigger="hover"
गर्ने अपेक्षा नगर्न सक्छन् ।
<span class="d-inline-block" data-toggle="popover" data-content="Disabled popover">
<button class="btn btn-primary" style="pointer-events: none;" type="button" disabled>Disabled button</button>
</span>
जाभास्क्रिप्ट मार्फत popovers सक्षम गर्नुहोस्:
$('#example').popover(options)
विकल्पहरू डेटा विशेषताहरू वा JavaScript मार्फत पास गर्न सकिन्छ। डेटा विशेषताहरूका लागि, विकल्पको नाम जोड्नुहोस् data-
, जस्तै मा data-animation=""
।
नाम | टाइप गर्नुहोस् | पूर्वनिर्धारित | विवरण |
---|---|---|---|
एनिमेसन | बुलियन | सत्य | पपओभरमा CSS फेड ट्रान्जिसन लागू गर्नुहोस् |
कन्टेनर | स्ट्रिङ | तत्व | गलत | गलत | पपओभरलाई विशेष तत्वमा जोड्छ। उदाहरण |
सामग्री | स्ट्रिङ | तत्व | समारोह | '' |
यदि एक प्रकार्य दिइएको छ भने, यो |
ढिला | नम्बर | वस्तु | ० | पपओभर (ms) देखाउन र लुकाउन ढिलाइ - म्यानुअल ट्रिगर प्रकारमा लागू हुँदैन यदि नम्बर प्रदान गरिएको छ भने, ढिलाइ लुकाउने/देखाउन दुवैमा लागू हुन्छ वस्तु संरचना हो: |
html | बुलियन | गलत | पपओभरमा HTML घुसाउनुहोस्। यदि गलत छ भने, text DOM मा सामग्री सम्मिलित गर्न jQuery को विधि प्रयोग गरिनेछ। यदि तपाईं XSS आक्रमणहरूको बारेमा चिन्तित हुनुहुन्छ भने पाठ प्रयोग गर्नुहोस्। |
नियुक्ति | स्ट्रिङ | समारोह | 'सही' | कसरी popover स्थिति - auto | शीर्ष | तल | बायाँ | सही। जब एक प्रकार्य स्थान निर्धारण गर्न प्रयोग गरिन्छ, यसलाई पहिलो तर्कको रूपमा popover DOM नोड र ट्रिगर गर्ने तत्व DOM नोडलाई दोस्रो रूपमा बोलाइन्छ। |
चयनकर्ता | स्ट्रिङ | गलत | गलत | यदि चयनकर्ता प्रदान गरिएको छ भने, पपओभर वस्तुहरूलाई निर्दिष्ट लक्ष्यहरूमा प्रत्यायोजित गरिनेछ। अभ्यासमा, यो गतिशील एचटीएमएल सामग्रीलाई पपओभरहरू थप्न सक्षम गर्न प्रयोग गरिन्छ। यो र एक जानकारीमूलक उदाहरण हेर्नुहोस् । |
टेम्प्लेट | तार | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>' |
पपओभर सिर्जना गर्दा प्रयोग गर्नको लागि आधार HTML। पपओभरमा पपओभरमा
|
शीर्षक | स्ट्रिङ | तत्व | समारोह | '' |
यदि एक प्रकार्य दिइएको छ भने, यो |
ट्रिगर | तार | 'क्लिक' | कसरी पपओभर ट्रिगर हुन्छ - क्लिक गर्नुहोस् | होभर | फोकस | म्यानुअल। तपाईले धेरै ट्रिगरहरू पास गर्न सक्नुहुन्छ; तिनीहरूलाई स्पेसको साथ अलग गर्नुहोस्। `म्यानुअल` कुनै अन्य ट्रिगरसँग जोड्न सकिँदैन। |
अफसेट | नम्बर | तार | ० | यसको लक्ष्य सापेक्ष popover को अफसेट। थप जानकारीको लागि Popper.js अफसेट कागजातहरू हेर्नुहोस् । |
फलब्याक प्लेसमेन्ट | स्ट्रिङ | array | 'फ्लिप' | पप्परले फलब्याकमा प्रयोग गर्ने स्थिति निर्दिष्ट गर्न अनुमति दिनुहोस्। थप जानकारीको लागि Popper.js को व्यवहार कागजातहरू हेर्नुहोस् |
सीमा | स्ट्रिङ | तत्व | 'स्क्रोल अभिभावक' | पपओभरको ओभरफ्लो अवरोध सीमा। 'viewport' , 'window' , 'scrollParent' , वा HTMLElement सन्दर्भ (जाभास्क्रिप्ट मात्र) को मानहरू स्वीकार गर्दछ । थप जानकारीको लागि Popper.js को preventOverflow कागजातहरू हेर्नुहोस् । |
व्यक्तिगत popovers लागि डाटा विशेषताहरू
व्यक्तिगत पोपोभरका लागि विकल्पहरू वैकल्पिक रूपमा डेटा विशेषताहरूको प्रयोग मार्फत निर्दिष्ट गर्न सकिन्छ, माथि वर्णन गरिए अनुसार।
एसिन्क्रोनस विधि र संक्रमण
सबै एपीआई विधिहरू एसिन्क्रोनस छन् र एक संक्रमण सुरु गर्नुहोस् । तिनीहरू संक्रमण सुरु हुने बित्तिकै तर यो समाप्त हुनु अघि कलरमा फर्कन्छन् । थप रूपमा, ट्रान्जिसनिङ कम्पोनेन्टमा विधि कललाई बेवास्ता गरिनेछ ।
तत्व सङ्कलनका लागि popovers प्रारम्भ गर्दछ।
तत्वको पपओभर देखाउँछ। पपओभर वास्तवमा देखाइनु अघि कलरमा फर्कन्छ (अर्थात shown.bs.popover
घटना हुनु अघि)। यसलाई पपओभरको "म्यानुअल" ट्रिगरिङ मानिन्छ। पोपोभरहरू जसको शीर्षक र सामग्री दुवै शून्य-लम्बाइ हुन्छन् कहिल्यै प्रदर्शित हुँदैनन्।
$('#element').popover('show')
तत्वको पपओभर लुकाउँछ। पपओभर लुकाउनु अघि कलरमा फर्कन्छ (अर्थात hidden.bs.popover
घटना हुनु अघि)। यसलाई पपओभरको "म्यानुअल" ट्रिगरिङ मानिन्छ।
$('#element').popover('hide')
तत्वको पपओभर टगल गर्छ। पपओभर वास्तवमा देखाइयो वा लुकाउनु अघि कलरमा फर्कन्छ (जस्तै shown.bs.popover
वा hidden.bs.popover
घटना हुनु अघि)। यसलाई पपओभरको "म्यानुअल" ट्रिगरिङ मानिन्छ।
$('#element').popover('toggle')
तत्वको पपओभर लुकाउँछ र नष्ट गर्दछ। डेलिगेशन प्रयोग गर्ने पोपोभरहरू (जसलाई विकल्प प्रयोग गरेरselector
सिर्जना गरिन्छ ) व्यक्तिगत रूपमा वंशज ट्रिगर तत्वहरूमा नष्ट गर्न सकिँदैन।
$('#element').popover('dispose')
तत्वको पपओभर देखाउन सक्ने क्षमता दिन्छ। Popovers पूर्वनिर्धारित रूपमा सक्षम छन्।
$('#element').popover('enable')
तत्वको पपओभर देखाउनको लागि क्षमता हटाउँछ। पपओभर मात्र देखाउन सक्षम हुनेछ यदि यो पुन: सक्षम छ।
$('#element').popover('disable')
तत्वको पपओभर देखाउन वा लुकाउनको लागि क्षमता टगल गर्दछ।
$('#element').popover('toggleEnabled')
तत्वको पपओभरको स्थिति अपडेट गर्दछ।
$('#element').popover('update')
घटना प्रकार | विवरण |
---|---|
show.bs.popover | show उदाहरण विधि बोलाउँदा यो घटना तुरुन्तै सक्रिय हुन्छ । |
देखाइएको.bs.popover | पपओभर प्रयोगकर्ताको लागि दृश्यात्मक बनाइएपछि यो घटना निकालिन्छ (CSS ट्रान्जिसनहरू पूरा हुनको लागि पर्खनेछ)। |
hide.bs.popover | यो घटना तुरुन्तै निकालिएको छ जब hide उदाहरण विधि कल गरिएको छ। |
hidden.bs.popover | पपओभर प्रयोगकर्ताबाट लुकाउन सकिएपछि यो घटना हटाइन्छ (CSS ट्रान्जिसनहरू पूरा हुनको लागि पर्खनेछ)। |
inserted.bs.popover | show.bs.popover DOM मा पपओभर टेम्प्लेट थपिएको घटना पछि यो घटना निकालिन्छ। |
$('#myPopover').on('hidden.bs.popover', function () {
// do something…
})