بوٽ اسٽريپ ڊراپ ڊائون پلگ ان سان لنڪن جي لسٽن ۽ وڌيڪ ڏيکارڻ لاءِ لاڳاپيل اوورليز کي ٽوگل ڪريو.
اوسر
ڊراپ ڊائونز ٽوگليبل، ڳنڍين جي فهرستن ۽ وڌيڪ ڏيکارڻ لاءِ لاڳاپيل اوورليز آهن. اهي شامل ڪيل بوٽ اسٽريپ ڊراپ ڊائون جاوا اسڪرپٽ پلگ ان سان متعامل ڪيا ويا آهن. اهي ڪلڪ ڪرڻ سان ٽوگل ڪيا ويا آهن، نه هوور ڪرڻ سان؛ هي هڪ ارادي ڊيزائن جو فيصلو آهي.
ڊراپ ڊائونز هڪ ٽئين پارٽي لائبريري تي ٺاهيا ويا آهن، Popper.js ، جيڪا متحرڪ پوزيشن ۽ ڏيک پورٽ جي سڃاڻپ مهيا ڪري ٿي. Bootstrap جي JavaScript کان اڳ popper.min.js شامل ڪرڻ جي پڪ ڪريو يا استعمال ڪريو bootstrap.bundle.min.js/ bootstrap.bundle.jsجنهن ۾ Popper.js شامل آهي. Popper.js استعمال نه ڪيو ويو آهي ڊراپ ڊائونز کي نيوبارز ۾ پوزيشن ڪرڻ لاءِ جيتوڻيڪ متحرڪ پوزيشن جي ضرورت ناهي.
جيڪڏهن توهان اسان جي جاوا اسڪرپٽ ماخذ کان ٺاهي رهيا آهيو، ان جي ضرورت آهيutil.js .
پهچ
WAI ARIA معيار هڪ حقيقي role="menu"ويجيٽ جي وضاحت ڪري ٿو ، پر اهو مخصوص آهي ايپليڪيشن-جهڙي مينيو لاءِ جيڪو عملن يا ڪمن کي متحرڪ ڪري ٿو. ARIA مينيو صرف مينيو شيون، چيڪ باڪس مينيو شيون، ريڊيو بٽڻ مينيو شيون، ريڊيو بٽڻ گروپ، ۽ ذيلي مينيو شامل ڪري سگھن ٿا.
بوٽ اسٽريپ جا ڊراپ ڊائونز، ٻئي طرف، عام طور تي ٺهيل آهن ۽ مختلف حالتن ۽ مارڪ اپ ساختن تي لاڳو ٿين ٿيون. مثال طور، اهو ممڪن آهي ڊراپ ڊائونز ٺاهڻ جنهن ۾ اضافي ان پٽ ۽ فارم ڪنٽرول شامل هجن، جهڙوڪ سرچ فيلڊز يا لاگ ان فارم. انهي سبب لاء، بوٽ اسٽريپ جي توقع نه آهي (نه ئي خودڪار طور تي شامل ڪريو) ڪنهن به role۽ خاصيتن جي حقيقي ARIA مينيو aria-لاء گهربل . ليکڪ کي پاڻ ۾ اهي وڌيڪ مخصوص خاصيتون شامل ڪرڻ گهرجن.
بهرحال، بوٽ اسٽريپ اڪثر معياري ڪيبورڊ مينيو رابطي لاءِ بلٽ ان سپورٽ شامل ڪندو آهي، جيئن ته ڪيبورڊ ڪيبورڊ .dropdown-itemاستعمال ڪندي انفرادي عناصر ذريعي منتقل ڪرڻ جي صلاحيت ۽ مينيو کي ESCڪيئي سان بند ڪرڻ.
مثال
ڊراپ ڊائون جي ٽوگل (توهان جو بٽڻ يا لنڪ) ۽ ڊراپ ڊائون مينيو کي لفاف ڪريو اندر .dropdown، يا ٻيو عنصر جيڪو اعلان ڪري ٿو position: relative;. توهان جي امڪاني ضرورتن کي بهتر طور تي پورو ڪرڻ لاءِ ڊراپ ڊائونز شروع ٿي سگهن ٿا <a>يا عناصر.<button>
اڪيلو بٽڻ
ڪنهن به هڪ .btnکي ڪجهه مارڪ اپ تبديلين سان ڊراپ ڊائون ٽوگل ۾ تبديل ڪري سگهجي ٿو. هتي اهو آهي ته توهان انهن کي ڪنهن به <button>عناصر سان ڪم ڪرڻ لاء ڪيئن رکي سگهو ٿا:
تاريخي طور تي ڊراپ ڊائون مينيو مواد کي لنڪس هجڻ گهرجن، پر اهو هاڻي v4 سان معاملو ناهي. ھاڻي توھان اختياري طور تي <button>عناصر استعمال ڪري سگھوٿا توھان جي ڊراپ ڊائونز ۾ صرف <a>ايس جي بدران.
توهان پڻ ٺاهي سگهو ٿا غير انٽرايڪٽو ڊراپ ڊائون شيون .dropdown-item-text. ڪسٽم CSS يا ٽيڪسٽ يوٽيلٽيز سان وڌيڪ انداز ۾ آزاد ٿيو.
ڊفالٽ طور، هڪ ڊراپ ڊائون مينيو خود بخود 100٪ مٿي کان مٿي ۽ ان جي والدين جي کاٻي پاسي سان رکيل آهي. شامل ڪريو .dropdown-menu-righta .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ڪلاس کي ٽوگل ڪندي والدين جي فهرست جي آئٽم تي. وصف هڪ ايپليڪيشن سطح تي ڊراپ ڊائون مينيو کي بند ڪرڻ لاءِ انحصار ڪيو data-toggle="dropdown"ويو آهي، تنهنڪري اهو هميشه استعمال ڪرڻ سٺو خيال آهي.
ٽچ-فعال ڊوائيسز تي، ڊراپ ڊائون کولڻ سان خالي ( $.noop) ھينڊلر کي عنصر mouseoverجي فوري ٻارن ۾ شامل ڪري ٿو. iOS جي ايونٽ ڊيليگيشن ۾ نرالا<body> ڪم ڪرڻ لاءِ هي اعترافي طور تي بدصورت هيڪ ضروري آهي ، جيڪو ٻي صورت ۾ ڊراپ ڊائون کان ٻاهر ڪٿي به ٽيپ کي روڪيندو ان ڪوڊ کي ٽرگر ڪرڻ کان جيڪو ڊراپ ڊائون کي بند ڪري ٿو. هڪ دفعو ڊراپ ڊائون بند ڪيو ويو آهي، اهي اضافي خالي هينڊلر ختم ڪيا ويا آهن.mouseover
ڊيٽا خاصيتن جي ذريعي
data-toggle="dropdown"ڊراپ ڊائون کي ٽوگل ڪرڻ لاءِ لنڪ يا بٽڻ شامل ڪريو .
جاوا اسڪرپٽ ذريعي
جاوا اسڪرپٽ ذريعي ڊراپ ڊائونز کي ڪال ڪريو:
data-toggle="dropdown"اڃا به گهربل
ان کان سواءِ ته توهان پنهنجي ڊراپ ڊائون کي JavaScript ذريعي ڪال ڪريو يا ان جي بدران data-api استعمال ڪريو، data-toggle="dropdown"هميشه لاءِ ضروري آهي ته ڊراپ ڊائون جي ٽرگر عنصر تي موجود هجي.
اختيارن
اختيارن کي ڊيٽا جي خاصيتن يا جاوا اسڪرپٽ ذريعي منظور ڪري سگھجي ٿو. ڊيٽا جي خاصيتن لاء، اختيار جو نالو شامل ڪريو data-، جيئن data-offset="".
نالو
قسم
ڊفالٽ
وصف
بند ڪرڻ
نمبر | تار | فنڪشن
0
ان جي ھدف سان لاڳاپيل ڊراپ ڊائون جو آفسيٽ.
جڏهن هڪ فنڪشن استعمال ڪيو ويندو آهي آفسيٽ کي طئي ڪرڻ لاء، اهو هڪ اعتراض سان سڏيو ويندو آهي جنهن ۾ آفسٽ ڊيٽا شامل آهي ان جي پهرين دليل طور. فنڪشن کي ساڳيو ڍانچي سان هڪ اعتراض واپس ڪرڻ گهرجي. ٽاريندڙ عنصر DOM نوڊ ٻئي دليل طور منظور ڪيو ويو آهي.
ريفرنس عنصر تي اوورليپنگ جي صورت ۾ ڊراپ ڊائون کي فلپ ڪرڻ جي اجازت ڏيو. وڌيڪ معلومات لاءِ ڏسو Popper.js جي فلپ ڊيڪس .
حد
تار | عنصر
'اسڪرول والدين'
ڊراپ ڊائون مينيو جي اوور فلو پابندي جي حد. 'viewport', , 'window', 'scrollParent', or an HTMLElement reference (صرف JavaScript) جا قدر قبول ڪري ٿو . وڌيڪ معلومات لاءِ ڏسو Popper.js's preventOverflow docs .
حوالو
تار | عنصر
'ٽگل'
ڊراپ ڊائون مينيو جو حوالو عنصر. 'toggle', 'parent', يا HTMLElement ريفرنس جي قدرن کي قبول ڪري ٿو . وڌيڪ معلومات لاءِ ڏسو Popper.js جي حوالي سان اعتراض جا دستاويز .
ڊسپلي
تار
'متحرڪ'
ڊفالٽ طور، اسان استعمال ڪندا آهيون Popper.js متحرڪ پوزيشن لاءِ. هن سان غير فعال ڪريو static.
popperConfig
null | اعتراض
null
Bootstrap جي ڊفالٽ Popper.js ترتيب کي تبديل ڪرڻ لاءِ، ڏسو Popper.js جي ترتيب
نوٽ ڪريو جڏهن 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
هي واقعو فائر ڪيو ويو آهي جڏهن ڊراپ ڊائون صارف کي ڏيکاريو ويو ��هي (سي ايس ايس جي منتقلي جو انتظار ڪندو، مڪمل ٿيڻ لاء).
hide.bs.dropdown
اهو واقعو فوري طور تي فائر ڪيو ويو آهي جڏهن لڪائڻ جو طريقو سڏيو ويندو آهي.
hidden.bs.dropdown
هي واقعو فائر ڪيو ويندو آهي جڏهن ڊراپ ڊائون ختم ٿي چڪو آهي صارف کان لڪايو وڃي (سي ايس ايس جي منتقلي جو انتظار ڪندو، مڪمل ٿيڻ لاء).