پاپورز
Bootstrap popovers کي شامل ڪرڻ لاءِ دستاويز ۽ مثال، جهڙوڪ جيڪي iOS ۾ مليا آهن، توهان جي سائيٽ تي ڪنهن به عنصر تي.
Popover پلگ ان کي استعمال ڪرڻ وقت ڄاڻڻ لاء شيون:
- Popovers پوزيشن لاء 3rd پارٽي لائبريري Popper.js تي ڀروسو . توهان کي bootstrap.js کان اڳ popper.min.js شامل ڪرڻ گهرجي يا استعمال ڪرڻ
bootstrap.bundle.min.js
/bootstrap.bundle.js
جنهن ۾ Popper.js شامل آهي popovers ڪم ڪرڻ لاءِ! - Popovers هڪ انحصار جي طور تي ٽول ٽائپ پلگ ان جي ضرورت آهي.
- جيڪڏهن توهان اسان جي جاوا اسڪرپٽ ماخذ کان ٺاهي رهيا آهيو، ان جي ضرورت آهي
util.js
. - Popovers ڪارڪردگي سببن لاء آپٽ-ان آهن، تنهنڪري توهان کي انهن کي پنهنجو پاڻ شروع ڪرڻ گهرجي .
- زيرو ڊگھائي
title
۽content
قدر ڪڏهن به پاپ اوور نه ڏيکاريندا. container: 'body'
وڌيڪ پيچيده اجزاء (جهڙوڪ اسان جي ان پٽ گروپن، بٽڻ گروپن، وغيره) ۾ رينجرنگ مسئلن کان بچڻ لاء وضاحت ڪريو .- لڪيل عناصر تي پاپ اوور کي ڇڪڻ ڪم نه ڪندو.
.disabled
يا عنصرن لاءِ پوپ اوورdisabled
لازمي طور تي چاڙهيو وڃي ٿو چادر واري عنصر تي.- جڏهن اينڪرز مان شروع ڪيو ويو آهي جيڪي ڪيترن ئي لائينن ۾ لپي ويندا آهن، پاپ اوور لنگر جي مجموعي چوٽي جي وچ ۾ مرڪز هوندا. هن رويي کان بچڻ لاء
white-space: nowrap;
توهان جي ايس تي استعمال ڪريو .<a>
- Popovers کي لڪايو وڃي ان کان اڳ جو انهن جي لاڳاپيل عناصر کي DOM مان هٽايو ويو آهي.
پڙهو ته ڏسو ته ڪيئن popovers ڪم ڪن مثالن سان.
ھڪڙي صفحي تي سڀني پاپورز کي شروع ڪرڻ جو ھڪڙو طريقو انھن کي انھن جي data-toggle
خاصيت سان چونڊيو ويندو:
جڏهن توهان وٽ والدين عنصر تي ڪجهه انداز آهن جيڪي پاپ اوور سان مداخلت ڪن ٿا، توهان چاهيو ٿا ته هڪ ڪسٽم بيان ڪريو container
ته جيئن پاپ اوور جو HTML ان عنصر جي بدران ظاهر ٿئي.
<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>
چار آپشن موجود آھن: مٿي، ساڄي، ھيٺ، ۽ کاٻي سان ترتيب ڏنل.
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>
وصف سان گڏ عناصر انٽرايڪٽو 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>
جاوا اسڪرپٽ ذريعي پاپ اوور کي فعال ڪريو:
اختيارن کي ڊيٽا جي خاصيتن يا جاوا اسڪرپٽ ذريعي منظور ڪري سگھجي ٿو. ڊيٽا جي خاصيتن لاء، اختيار جو نالو شامل ڪريو data-
، جيئن data-animation=""
.
نالو | قسم | ڊفالٽ | وصف |
---|---|---|---|
انيميشن | بولين | سچو | پاپ اوور تي سي ايس ايس فيڊ ٽرانسشن لاڳو ڪريو |
ڪنٽينر | تار | عنصر | ڪوڙو | ڪوڙو | پوپ اوور کي خاص عنصر ۾ شامل ڪري ٿو. مثال: |
مواد | تار | عنصر | فنڪشن | '' | ڊفالٽ مواد جي قيمت جيڪڏهن جيڪڏهن هڪ فنڪشن ڏنو ويو آهي، ان کي سڏيو ويندو ان جي |
دير ڪرڻ | نمبر | اعتراض | 0 | پوپ اوور (ms) ڏيکارڻ ۽ لڪائڻ ۾ دير - دستي ٽرگر جي قسم تي لاڳو نٿو ٿئي جيڪڏهن هڪ نمبر فراهم ڪيو ويو آهي، دير سان لڪايو / ڏيکاريو ٻنهي تي لاڳو ٿئي ٿو اعتراض جي جوڙجڪ آهي: |
html | بولين | ڪوڙو | پاپ اوور ۾ HTML داخل ڪريو. جيڪڏهن غلط آهي، jQuery جو text طريقو استعمال ڪيو ويندو مواد کي DOM ۾ داخل ڪرڻ لاء. متن استعمال ڪريو جيڪڏھن توھان پريشان آھيو XSS حملن بابت. |
لڳائڻ | تار | فنڪشن | 'ساڄو' | پوپ اوور کي پوزيشن ڪيئن ڪجي - آٽو | مٿي | هيٺان | کاٻي | ساڄو. جڏهن هڪ فنڪشن استعمال ڪيو ويندو آهي جڳهه جو تعين ڪرڻ لاء، ان کي سڏيو ويندو آهي پاپ اوور DOM نوڊ ان جي پهرين دليل طور ۽ ٽارگيٽ عنصر DOM نوڊ ان جي سيڪنڊ طور. |
چونڊيندڙ | تار | ڪوڙو | ڪوڙو | جيڪڏهن هڪ چونڊيندڙ مهيا ڪيو ويو آهي، پاپ اوور شيون مقرر ڪيل هدفن کي ورهايو ويندو. عملي طور تي، اهو استعمال ڪيو ويندو آهي متحرڪ HTML مواد کي فعال ڪرڻ لاءِ پاپ اوور شامل ڪرڻ لاءِ. هي ڏسو ۽ هڪ معلوماتي مثال . |
ٽيمپليٽ | تار | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>' |
پاپ اوور ٺاهڻ وقت استعمال ڪرڻ لاءِ بنيادي HTML. پاپ اوور کي انجيڪشن پاپ اوور کي انجيڪشن
ٻاهرين لفافي عنصر کي |
عنوان | تار | عنصر | فنڪشن | '' | ڊفالٽ عنوان جي قيمت جيڪڏهن جيڪڏهن هڪ فنڪشن ڏنو ويو آهي، ان کي سڏيو ويندو ان جي |
محرڪ | تار | 'ڪلڪ' | پاپ اوور ڪيئن شروع ٿئي ٿو - ڪلڪ ڪريو | هور | ڌيان | دستور. توھان ڪيترائي محرڪ پاس ڪري سگھو ٿا؛ انھن کي ھڪڙي جڳھ سان الڳ ڪريو. 'دستي' کي ڪنهن ٻئي ٽرگر سان گڏ نه ٿو ڪري سگھجي. |
بند ڪرڻ | نمبر | تار | 0 | ان جي حدف جي نسبت سان پاپ اوور جو آفسٽ. وڌيڪ معلومات لاءِ ڏسو Popper.js جي آفسٽ ڊيڪس . |
fallback جي جڳھ | تار | صف | 'ڦٽڻ' | وضاحت ڪرڻ جي اجازت ڏيو ته پوپر ڪهڙي پوزيشن تي استعمال ڪندو. وڌيڪ معلومات لاءِ ڏسو Popper.js جي رويي جا دستاويز |
حد | تار | عنصر | 'اسڪرول والدين' | پاپ اوور جي اوور فلو پابندي جي حد. 'viewport' , , 'window' , 'scrollParent' , or an HTMLElement reference (صرف JavaScript) جا قدر قبول ڪري ٿو . وڌيڪ معلومات لاءِ ڏسو Popper.js's preventOverflow docs . |
انفرادي پاپورز لاءِ ڊيٽا جون خاصيتون
انفرادي پاپورز لاءِ اختيارات متبادل طور تي بيان ڪري سگھجن ٿا ڊيٽا خاصيتن جي استعمال ذريعي، جيئن مٿي بيان ڪيو ويو آهي.
هم وقت سازي طريقا ۽ منتقلي
سڀ API طريقا غير مطابقت رکندڙ آهن ۽ هڪ منتقلي شروع ڪن ٿا . اهي ڪالر ڏانهن موٽندا آهن جيئن ئي منتقلي شروع ٿئي ٿي پر ان کان اڳ ختم ٿي وڃي . ان کان علاوه، هڪ طريقو ڪال هڪ منتقلي جزو تي نظر انداز ڪيو ويندو .
هڪ عنصر گڏ ڪرڻ لاء popovers جي شروعات.
هڪ عنصر جي پاپ اوور کي ظاهر ڪري ٿو. پوپ اوور اصل ۾ ڏيکاريو ويو آهي (يعني واقعي ٿيڻ کان اڳ) ڪالر ڏانهن واپسي . shown.bs.popover
اهو سمجهيو ويندو آهي "دستي" پاپ اوور جي ٽارگيٽ. Popovers جن جا عنوان ۽ مواد ٻئي صفر ڊگھائي آهن ڪڏهن به ڏيکاريل نه آهن.
هڪ عنصر جي پاپ اوور کي لڪائيندو آهي. پوپ اوور اصل ۾ لڪايو ويو آهي (يعني واقعي ٿيڻ کان اڳ) ڪالر ڏانهن واپسي . hidden.bs.popover
اهو سمجهيو ويندو آهي "دستي" پاپ اوور جي ٽارگيٽ.
هڪ عنصر جي پاپ اوور کي ٽوگل ڪري ٿو. پوپ اوور اصل ۾ ڏيکاريو ويو يا لڪايو ويو (يعني واقعي يا واقعو ٿيڻ کان اڳ) ڪالر ڏانهن واپسي . اهو سمجهيو ويندو آهي "دستي" پاپ اوور جي ٽارگيٽ.shown.bs.popover
hidden.bs.popover
هڪ عنصر جي پاپ اوور کي لڪائي ۽ تباهه ڪري ٿو. پاپورز جيڪي وفد استعمال ڪندا آهن (جيڪي اختيار استعمال ڪندي ٺاهيا ويا آهن ) selector
انفرادي طور تي نسلي ٽرگر عناصر تي تباهه نه ٿي سگهن.
هڪ عنصر جي پاپ اوور کي ڏيکاريو وڃڻ جي صلاحيت ڏئي ٿي. Popovers ڊفالٽ طور تي فعال آهن.
هڪ عنصر جي پاپ اوور کي ڏيکارڻ جي صلاحيت کي هٽائي ٿو. پاپ اوور صرف ان صورت ۾ ڏيکاريو ويندو جڏهن ان کي ٻيهر فعال ڪيو ويندو.
هڪ عنصر جي پاپ اوور کي ڏيکارڻ يا لڪائڻ جي صلاحيت کي ٽوگل ڪري ٿو.
هڪ عنصر جي پاپ اوور جي پوزيشن کي اپڊيٽ ڪري ٿو.
واقعي جو قسم | وصف |
---|---|
show.bs.popover | اهو واقعو فوري طور تي فائر ڪندو آهي جڏهن show مثال جو طريقو سڏيو ويندو آهي. |
ڏيکاريو ويو.bs.popover | اهو واقعو فائر ڪيو ويو آهي جڏهن پاپ اوور کي صارف لاءِ ظاهر ڪيو ويو آهي (سي ايس ايس جي منتقلي مڪمل ٿيڻ جو انتظار ڪندو). |
hide.bs.popover | اهو واقعو فوري طور تي فائر ڪيو ويو آهي جڏهن hide مثال جو طريقو سڏيو ويو آهي. |
hidden.bs.popover | هي واقعو فائر ڪيو ويندو آهي جڏهن پاپ اوور ختم ٿي چڪو آهي صارف کان لڪايو وڃي (سي ايس ايس جي منتقلي مڪمل ٿيڻ جو انتظار ڪندو). |
inserted.bs.popover | اهو واقعو ان واقعي کان پوءِ فائر ڪيو ويو آهي show.bs.popover جڏهن پاپ اوور ٽيمپليٽ ڊوم ۾ شامل ڪيو ويو آهي. |