बूटस्ट्रॅप ड्रॉपडाउन प्लगइनसह लिंक्स आणि अधिकच्या सूची प्रदर्शित करण्यासाठी संदर्भित आच्छादन टॉगल करा.
आढावा
ड्रॉपडाउन टॉगल करण्यायोग्य आहेत, लिंक्सच्या सूची आणि बरेच काही प्रदर्शित करण्यासाठी संदर्भित आच्छादन. ते समाविष्ट केलेल्या बूटस्ट्रॅप ड्रॉपडाउन JavaScript प्लगइनसह परस्परसंवादी बनवले आहेत. ते क्लिक करून टॉगल केले जातात, फिरवून नाही; हा मुद्दाम डिझाइन निर्णय आहे .
ड्रॉपडाउन तृतीय पक्ष लायब्ररीवर तयार केले आहेत, Popper.js , जे डायनॅमिक पोझिशनिंग आणि व्ह्यूपोर्ट शोध प्रदान करते. Bootstrap च्या JavaScript आधी popper.min.js समाविष्ट करण्याचे सुनिश्चित करा किंवा वापरा bootstrap.bundle.min.js/ bootstrap.bundle.jsज्यामध्ये Popper.js आहे. Popper.js चा वापर navbars मध्ये ड्रॉपडाउन ठेवण्यासाठी केला जात नाही कारण डायनॅमिक पोझिशनिंग आवश्यक नाही.
WAI ARIA मानक वास्तविक role="menu"विजेट परिभाषित करते , परंतु हे ऍप्लिकेशन सारख्या मेनूसाठी विशिष्ट आहे जे क्रिया किंवा कार्ये ट्रिगर करतात. ARIA मेनूमध्ये फक्त मेनू आयटम, चेकबॉक्स मेनू आयटम, रेडिओ बटण मेनू आयटम, रेडिओ बटण गट आणि उप-मेनू असू शकतात.
बूटस्ट्रॅपचे ड्रॉपडाउन, दुसरीकडे, जेनेरिक आणि विविध परिस्थिती आणि मार्कअप संरचनांना लागू करण्यासाठी डिझाइन केलेले आहेत. उदाहरणार्थ, ड्रॉपडाउन तयार करणे शक्य आहे ज्यात अतिरिक्त इनपुट आणि फॉर्म नियंत्रणे आहेत, जसे की शोध फील्ड किंवा लॉगिन फॉर्म. या कारणास्तव, बूटस्ट्रॅप खर्या एआरआयए मेनूसाठी आवश्यक असलेल्या कोणत्याही गुणधर्मांची अपेक्षा roleकरत नाही (किंवा आपोआप जोडत नाही). लेखकांना या अधिक विशिष्ट गुणधर्मांचा स्वतः समावेश करावा लागेल.aria-
तथापि, बूटस्ट्रॅप बहुतेक मानक कीबोर्ड मेनू परस्परसंवादासाठी अंगभूत समर्थन जोडते, जसे की .dropdown-itemकर्सर की वापरून वैयक्तिक घटकांमधून जाण्याची आणि कीसह मेनू बंद करण्याची क्षमता ESC.
उदाहरणे
ड्रॉपडाउनचे टॉगल (तुमचे बटण किंवा लिंक) आणि ड्रॉपडाउन मेनूमध्ये गुंडाळा .dropdown, किंवा घोषित करणारा दुसरा घटक position: relative;. तुमच्या संभाव्य गरजा चांगल्या प्रकारे बसवण्यासाठी ड्रॉपडाउन्स <a>किंवा घटकांमधून ट्रिगर केले जाऊ शकते .<button>
सिंगल बटण
कोणतेही एकल .btnकाही मार्कअप बदलांसह ड्रॉपडाउन टॉगलमध्ये बदलले जाऊ शकते. <button>आपण त्यांना दोन्ही घटकांसह कसे कार्य करू शकता ते येथे आहे :
त्याचप्रमाणे, स्प्लिट बटण ड्रॉपडाउन तयार करा ज्यात अक्षरशः सिंगल बटण ड्रॉपडाउन सारख्याच मार्कअपसह, परंतु .dropdown-toggle-splitड्रॉपडाउन कॅरेटभोवती योग्य अंतर ठेवण्यासाठी जोडणे.
paddingआम्ही कॅरेटच्या दोन्ही बाजूचे क्षैतिज 25% कमी करण्यासाठी आणि margin-leftनियमित बटण ड्रॉपडाउनसाठी जोडलेले काढून टाकण्यासाठी हा अतिरिक्त वर्ग वापरतो . हे अतिरिक्त बदल कॅरेटला स्प्लिट बटणाच्या मध्यभागी ठेवतात आणि मुख्य बटणाच्या पुढे अधिक योग्य आकाराचे हिट क्षेत्र प्रदान करतात.
ऐतिहासिकदृष्ट्या ड्रॉपडाउन मेनू सामग्री दुवे असणे आवश्यक होते , परंतु v4 च्या बाबतीत असे नाही. आता तुम्ही तुमच्या ड्रॉपडाउनमध्ये फक्त s <button>ऐवजी वैकल्पिकरित्या घटक वापरू शकता .<a>
तुम्ही सह गैर-परस्परसंवादी ड्रॉपडाउन आयटम देखील तयार करू शकता .dropdown-item-text. सानुकूल CSS किंवा मजकूर युटिलिटिजसह पुढे स्टाईल करण्यास मोकळ्या मनाने.
डीफॉल्टनुसार, ड्रॉपडाउन मेनू स्वयंचलितपणे 100% शीर्षस्थानी आणि त्याच्या पालकाच्या डाव्या बाजूला स्थित असतो. ड्रॉपडाउन मेनू उजवीकडे संरेखित .dropdown-menu-rightकरण्यासाठी a मध्ये जोडा ..dropdown-menu
सावधान! ड्रॉपडाउन Popper.js (नॅव्हीबारमध्ये समाविष्ट असताना वगळता) स्थीत केले जातात.
प्रतिसादात्मक संरेखन
तुम्हाला रिस्पॉन्सिव्ह अलाइनमेंट वापरायचे असल्यास, विशेषता जोडून डायनॅमिक पोझिशनिंग अक्षम data-display="static"करा आणि रिस्पॉन्सिव्ह व्हेरिएशन क्लासेस वापरा.
दिलेल्या ब्रेकपॉईंटसह ड्रॉपडाउन मेनू उजवीकडे संरेखित करण्यासाठी किंवा मोठ्या, जोडा .dropdown-menu{-sm|-md|-lg|-xl}-right.
दिलेल्या ब्रेकपॉईंटसह ड्रॉपडाउन मेनू डावीकडे संरेखित करण्यासाठी किंवा मोठ्या, जोडा .dropdown-menu-rightआणि .dropdown-menu{-sm|-md|-lg|-xl}-left.
लक्षात घ्या की तुम्हाला navbars मधील ड्रॉपडाउन बटणांमध्ये विशेषता जोडण्याची आवश्यकता नाही data-display="static", कारण Popper.js हे navbars मध्ये वापरले जात नाही.
मेनू सामग्री
शीर्षलेख
कोणत्याही ड्रॉपडाउन मेनूमधील क्रियांच्या विभागांना लेबल करण्यासाठी शीर्षलेख जोडा.
मजकूरासह ड्रॉपडाउन मेनूमध्ये कोणताही फ्रीफॉर्म मजकूर ठेवा आणि स्पेसिंग युटिलिटी वापरा . लक्षात ठेवा की मेनू रुंदी मर्यादित करण्यासाठी तुम्हाला अतिरिक्त आकारमान शैलींची आवश्यकता असेल.
ड्रॉपडाउन मेनूमध्ये मुक्त-प्रवाह असलेला काही उदाहरण मजकूर.
आणि हा अधिक उदाहरण मजकूर आहे.
फॉर्म
ड्रॉपडाउन मेनूमध्ये एक फॉर्म ठेवा किंवा त्यास ड्रॉपडाउन मेनूमध्ये बनवा आणि आपल्याला आवश्यक असलेली नकारात्मक जागा देण्यासाठी मार्जिन किंवा पॅडिंग उपयुक्तता वापरा.
.showडेटा विशेषता किंवा JavaScript द्वारे, ड्रॉपडाउन प्लगइन लपलेली सामग्री (ड्रॉपडाउन मेनू) पालक सूची आयटमवर वर्ग टॉगल करून टॉगल करते . data-toggle="dropdown"अॅप्लिकेशन स्तरावर ड्रॉपडाउन मेनू बंद करण्यासाठी विशेषता अवलंबून असते, म्हणून ती नेहमी वापरणे चांगली कल्पना आहे .
टच-सक्षम डिव्हाइसेसवर, ड्रॉपडाउन उघडल्याने घटकाच्या तात्काळ मुलांसाठी रिक्त ( $.noop) हँडलर जोडले जातात. iOS च्या इव्हेंट डेलिगेशन मधील क्विर्कवर कार्य करण्यासाठी हे मान्यपणे कुरूप हॅक आवश्यक आहे , जे अन्यथा ड्रॉपडाउन बंद करणार्या कोडला ट्रिगर करण्यापासून ड्रॉपडाउनच्या बाहेर कुठेही टॅप करण्यास प्रतिबंधित करेल. ड्रॉपडाउन बंद केल्यावर, हे अतिरिक्त रिकामे हँडलर काढले जातात.mouseover<body>mouseover
डेटा विशेषतांद्वारे
data-toggle="dropdown"ड्रॉपडाउन टॉगल करण्यासाठी लिंक किंवा बटणावर जोडा .
JavaScript द्वारे
JavaScript द्वारे ड्रॉपडाउन कॉल करा:
data-toggle="dropdown"अजूनही आवश्यक आहे
तुम्ही तुमच्या ड्रॉपडाउनला JavaScript द्वारे कॉल करत असलात किंवा त्याऐवजी डेटा-एपीआय वापरत असलात तरीही, data-toggle="dropdown"ड्रॉपडाउनच्या ट्रिगर घटकावर नेहमी उपस्थित असणे आवश्यक आहे.
पर्याय
डेटा विशेषता किंवा JavaScript द्वारे पर्याय पास केले जाऊ शकतात. डेटा विशेषतांसाठी, पर्यायाचे नाव , मध्ये data-प्रमाणे जोडा data-offset="".
नाव
प्रकार
डीफॉल्ट
वर्णन
ऑफसेट
संख्या | स्ट्रिंग | कार्य
0
त्याच्या लक्ष्याशी संबंधित ड्रॉपडाउनचा ऑफसेट.
जेव्हा ऑफसेट निर्धारित करण्यासाठी फंक्शन वापरले जाते, तेव्हा ते प्रथम युक्तिवाद म्हणून ऑफसेट डेटा असलेल्या ऑब्जेक्टसह कॉल केले जाते. फंक्शनने समान संरचनेसह ऑब्जेक्ट परत करणे आवश्यक आहे. ट्रिगरिंग घटक DOM नोड दुसरा युक्तिवाद म्हणून पास केला जातो.
संदर्भ घटकावर ओव्हरलॅपिंग झाल्यास ड्रॉपडाउनला फ्लिप करण्यास अनुमती द्या. अधिक माहितीसाठी Popper.js च्या फ्लिप डॉक्सचा संदर्भ घ्या .
सीमा
स्ट्रिंग | घटक
'स्क्रोल पालक'
ड्रॉपडाउन मेनूची ओव्हरफ्लो मर्यादा सीमा. 'viewport', 'window', 'scrollParent', किंवा HTMLElement संदर्भ (केवळ JavaScript) ची मूल्ये स्वीकारते . अधिक माहितीसाठी Popper.js च्या preventOverflow डॉक्स पहा .
संदर्भ
स्ट्रिंग | घटक
'टॉगल'
ड्रॉपडाउन मेनूचा संदर्भ घटक. 'toggle', 'parent', किंवा HTMLElement संदर्भाची मूल्ये स्वीकारते . अधिक माहितीसाठी Popper.js च्या referenceObject डॉक्स पहा .
प्रदर्शन
स्ट्रिंग
'गतिशील'
डीफॉल्टनुसार, डायनॅमिक पोझिशनिंगसाठी आम्ही Popper.js वापरतो. यासह अक्षम करा static.
लक्षात ठेवा की boundaryव्यतिरिक्त कोणत्याही मूल्यावर सेट केव्हा 'scrollParent', शैली कंटेनरवर position: staticलागू केली जाते ..dropdown
पद्धती
पद्धत
वर्णन
$().dropdown('toggle')
दिलेल्या नॅव्हबार किंवा टॅब केलेल्या नेव्हिगेशनचा ड्रॉपडाउन मेनू टॉगल करते.
$().dropdown('show')
दिलेल्या नॅव्हबार किंवा टॅब केलेल्या नेव्हिगेशनचा ड्रॉपडाउन मेनू दाखवतो.
$().dropdown('hide')
दिलेल्या नॅव्हबार किंवा टॅब केलेल्या नेव्हिगेशनचा ड्रॉपडाउन मेनू लपवतो.
$().dropdown('update')
घटकाच्या ड्रॉपडाउनची स्थिती अपडेट करते.
$().dropdown('dispose')
घटकाचे ड्रॉपडाउन नष्ट करते.
कार्यक्रम
सर्व ड्रॉपडाउन इव्हेंट्सच्या .dropdown-menuमूळ घटकावर फायर केले जातात आणि त्यांची relatedTargetमालमत्ता असते, ज्याचे मूल्य टॉगलिंग अँकर घटक असते. hide.bs.dropdownआणि hidden.bs.dropdownइव्हेंटमध्ये एक clickEventगुणधर्म असतो (केवळ मूळ इव्हेंट प्रकार असतो तेव्हा click) ज्यामध्ये क्लिक इव्हेंटसाठी इव्हेंट ऑब्जेक्ट असतो.
कार्यक्रम
वर्णन
show.bs.dropdown
जेव्हा शो उदाहरण पद्धत कॉल केली जाते तेव्हा हा इव्हेंट लगेच फायर होतो.
shown.bs.dropdown
जेव्हा ड्रॉपडाउन वापरकर्त्यासाठी दृश्यमान केले जाते तेव्हा हा कार्यक्रम काढला जातो (CSS संक्रमण पूर्ण होण्याची प्रतीक्षा करेल).
hide.bs.dropdown
जेव्हा लपवा उदाहरण पद्धत कॉल केली जाते तेव्हा हा इव्हेंट लगेच काढला जातो.
hidden.bs.dropdown
जेव्हा ड्रॉपडाउन वापरकर्त्यापासून लपविले जाणे पूर्ण केले जाते तेव्हा हा कार्यक्रम काढला जातो (CSS संक्रमण पूर्ण होण्याची प्रतीक्षा करेल).