پاپورز
Bootstrap popovers کي شامل ڪرڻ لاءِ دستاويز ۽ مثال، جهڙوڪ جيڪي iOS ۾ مليا آهن، توهان جي سائيٽ تي ڪنهن به عنصر تي.
اوسر
Popover پلگ ان کي استعمال ڪرڻ وقت ڄاڻڻ لاء شيون:
- Popovers پوزيشن لاء 3rd پارٽي لائبريري Popper تي ڀروسو . توهان کي bootstrap.js کان اڳ popper.min.js شامل ڪرڻ گهرجي يا استعمال ڪرڻ
bootstrap.bundle.min.js
/bootstrap.bundle.js
جنهن ۾ Popper شامل آهي popovers ڪم ڪرڻ لاءِ! - Popovers هڪ انحصار جي طور تي ٽول ٽائپ پلگ ان جي ضرورت آهي.
- جيڪڏهن توهان اسان جي جاوا اسڪرپٽ ماخذ کان ٺاهي رهيا آهيو، ان جي ضرورت آهي
util.js
. - Popovers ڪارڪردگي سببن لاء آپٽ-ان آهن، تنهنڪري توهان کي انهن کي پنهنجو پاڻ شروع ڪرڻ گهرجي .
- زيرو ڊگھائي
title
۽content
قدر ڪڏهن به پاپ اوور نه ڏيکاريندا. container: 'body'
وڌيڪ پيچيده اجزاء (جهڙوڪ اسان جي ان پٽ گروپن، بٽڻ گروپن، وغيره) ۾ رينجرنگ مسئلن کان بچڻ لاء وضاحت ڪريو .- لڪيل عناصر تي پاپ اوور کي ڇڪڻ ڪم نه ڪندو.
.disabled
يا عنصرن لاءِ پوپ اوورdisabled
لازمي طور تي چاڙهيو وڃي ٿو چادر واري عنصر تي.- جڏهن اينڪرز مان شروع ڪيو ويو آهي جيڪي ڪيترن ئي لائينن ۾ لپي ويندا آهن، پاپ اوور لنگر جي مجموعي چوٽي جي وچ ۾ مرڪز هوندا. هن رويي کان بچڻ لاء
.text-nowrap
توهان جي ايس تي استعمال ڪريو .<a>
- Popovers کي لڪايو وڃي ان کان اڳ جو انهن جي لاڳاپيل عناصر کي DOM مان هٽايو ويو آهي.
- پاڇو DOM اندر هڪ عنصر جي مهرباني سان پاپ اوور شروع ٿي سگهي ٿو.
prefers-reduced-motion
ميڊيا جي سوال تي منحصر آھي. اسان جي پهچ واري دستاويزن جو گھٽ موشن سيڪشن ڏسو
.
پڙهو ته ڏسو ته ڪيئن popovers ڪم ڪن مثالن سان.
مثال: popovers هر جڳهه کي فعال ڪريو
ھڪڙي صفحي تي سڀني پاپورز کي شروع ڪرڻ جو ھڪڙو طريقو انھن کي انھن جي data-toggle
خاصيت سان چونڊيو ويندو:
$(function () {
$('[data-toggle="popover"]').popover()
})
مثال: container
اختيار استعمال ڪندي
جڏهن توهان وٽ والدين عنصر تي ڪجهه انداز آهن جيڪي پاپ اوور سان مداخلت ڪن ٿا، توهان چاهيو ٿا ته هڪ ڪسٽم بيان ڪريو 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="Top popover">
Popover on top
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="right" data-content="Right popover">
Popover on right
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="bottom" data-content="Bottom popover">
Popover on bottom
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="left" data-content="Left popover">
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>
استعمال
جاوا اسڪرپٽ ذريعي پاپ اوور کي فعال ڪريو:
$('#example').popover(options)
GPU تيز رفتار
Popovers ڪڏهن ڪڏهن blurry نظر اچن ٿا Windows 10 ڊوائيسز جي ڪري GPU تيز رفتار ۽ هڪ تبديل ٿيل سسٽم DPI جي ڪري. v4 ۾ ھن لاءِ ڪم ڪار آھي GPU جي رفتار کي غير فعال ڪرڻ جيئن توھان جي پاپ اوور تي ضرورت آھي.
تجويز ڪيل اصلاح:
Popper.Defaults.modifiers.computeStyle.gpuAcceleration = !(window.devicePixelRatio < 1.5 && /Win/.test(navigator.platform))
ڪيبورڊ ۽ مددگار ٽيڪنالاجي استعمال ڪندڙن لاءِ پاپ اوور ڪم ڪرڻ
ڪيبورڊ استعمال ڪندڙن کي اجازت ڏيڻ لاءِ توھان جي پاپ اوور کي چالو ڪرڻ لاءِ، توھان کي انھن کي صرف HTML عناصر ۾ شامل ڪرڻ گھرجي جيڪي روايتي طور ڪيبورڊ-فوڪسيبل ۽ متعامل آھن (جهڙوڪ لنڪس يا فارم ڪنٽرول). جيتوڻيڪ پاڻمرادو HTML عناصر (جهڙوڪ <span>
s) tabindex="0"
وصف شامل ڪرڻ سان ڌيان ڏيڻ جي قابل ٿي سگھن ٿا، اهو ڪيبورڊ استعمال ڪندڙن لاءِ غير انٽرايڪٽو عناصر تي امڪاني طور تي پريشان ڪندڙ ۽ پريشان ڪندڙ ٽيب اسٽاپ شامل ڪندو، ۽ گهڻيون مددگار ٽيڪنالاجيون في الحال پاپ اوور جي مواد جو اعلان نه ڪنديون آهن هن صورتحال ۾ . اضافي طور تي، مڪمل طور تي انحصار نه ڪريو hover
جيئن توهان جي پاپورز لاء ٽرگر، ڇاڪاڻ ته اهو انهن کي ڪيبورڊ استعمال ڪندڙن لاء ٽرڪ ڪرڻ ناممڪن بڻائيندو.
جڏهن ته توهان اختيار سان گڏ پوپ اوور ۾ امير، منظم ٿيل HTML داخل ڪري سگهو ٿا html
، اسان سختي سان صلاح ڏيو ٿا ته توهان مواد جي گهڻي مقدار کي شامل ڪرڻ کان پاسو ڪريو. هن وقت پاپورز جو طريقو اهو آهي ته، هڪ ڀيرو ڏيکاريل آهي، انهن جو مواد ٽرگر عنصر سان aria-describedby
وصف سان ڳنڍيل آهي. نتيجي طور، پاپ اوور جي مواد جي مڪمل طور تي اعلان ڪيو ويندو مددگار ٽيڪنالاجي استعمال ڪندڙن کي هڪ ڊگهو، اڻ رڪاوٽ وهڪرو.
اضافي طور تي، جڏهن ته توهان جي پاپ اوور ۾ انٽرايڪٽو ڪنٽرولز (جهڙوڪ فارم عناصر يا لنڪس) شامل ڪرڻ ممڪن آهي (انهن عناصر کي شامل ڪرڻ whiteList
يا اجازت ڏنل خاصيتون ۽ ٽيگ ذريعي)، خبردار ٿيو ته هن وقت پاپ اوور ڪيبورڊ فوڪس آرڊر کي منظم نٿو ڪري. جڏهن هڪ ڪيبورڊ استعمال ڪندڙ هڪ پاپ اوور کوليندو آهي، فوڪس محرڪ عنصر تي رهي ٿو، ۽ جيئن ته پاپ اوور عام طور تي فوري طور تي دستاويز جي جوڙجڪ ۾ ٽريگر جي پيروي نه ڪندو آهي، اتي ڪا به ضمانت نه آهي ته اڳتي وڌڻ/دٻائڻ.TABڪيبورڊ استعمال ڪندڙ کي پاپ اوور ۾ منتقل ڪندو. مختصر ۾، صرف هڪ پاپ اوور ۾ انٽرايڪٽو ڪنٽرول شامل ڪرڻ ممڪن آهي ته اهي ڪنٽرول ڪيبورڊ استعمال ڪندڙن ۽ مددگار ٽيڪنالاجيز جي استعمال ڪندڙن لاءِ ناقابل رسائي/ناقابل استعمال هجن، يا گهٽ ۾ گهٽ هڪ غير منطقي مجموعي فوڪس آرڊر لاءِ ٺاهيو وڃي. انهن حالتن ۾، ان جي بدران ماڊل ڊائلاگ استعمال ڪرڻ تي غور ڪريو.
اختيارن
اختيارن کي ڊيٽا جي خاصيتن يا جاوا اسڪرپٽ ذريعي منظور ڪري سگھجي ٿو. ڊيٽا جي خاصيتن لاء، اختيار جو نالو شامل ڪريو data-
، جيئن data-animation=""
.
sanitize
،
sanitizeFn
۽
whiteList
اختيارن کي مهيا نه ٿو ڪري سگھجي ڊيٽا خاصيتون استعمال ڪندي.
نالو | قسم | ڊفالٽ | وصف |
---|---|---|---|
انيميشن | بولين | سچو | پاپ اوور تي سي ايس ايس فيڊ ٽرانسشن لاڳو ڪريو |
ڪنٽينر | تار | عنصر | ڪوڙو | ڪوڙو | پوپ اوور کي خاص عنصر ۾ شامل ڪري ٿو. مثال: |
مواد | تار | عنصر | فنڪشن | '' | ڊفالٽ مواد جي قيمت جيڪڏهن جيڪڏهن هڪ فنڪشن ڏنو ويو آهي، ان کي سڏيو ويندو ان جي |
دير ڪرڻ | نمبر | اعتراض | 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. پاپ اوور کي انجيڪشن پاپ اوور کي انجيڪشن
ٻاهرين لفافي عنصر کي |
عنوان | تار | عنصر | فنڪشن | '' | ڊفالٽ عنوان جي قيمت جيڪڏهن جيڪڏهن هڪ فنڪشن ڏنو ويو آهي، ان کي سڏيو ويندو ان جي |
محرڪ | تار | 'ڪلڪ' | پاپ اوور ڪيئن شروع ٿئي ٿو - ڪلڪ ڪريو | هور | ڌيان | دستور. توھان ڪيترائي محرڪ پاس ڪري سگھو ٿا؛ انھن کي ھڪڙي جڳھ سان الڳ ڪريو. manual ڪنهن ٻئي ٽرڪ سان گڏ نه ٿو ڪري سگھجي. |
بند ڪرڻ | نمبر | تار | 0 | ان جي حدف جي نسبت سان پاپ اوور جو آفسٽ. وڌيڪ معلومات لاءِ ڏسو Popper's offset docs . |
fallback جي جڳھ | تار | صف | 'ڦٽڻ' | وضاحت ڪرڻ جي اجازت ڏيو ته پوپر ڪهڙي پوزيشن تي استعمال ڪندو. وڌيڪ معلومات لاءِ ڏسو پوپر جي رويي جا دستاويز |
ڪسٽم ڪلاس | تار | فنڪشن | '' | پوپ اوور ۾ ڪلاس شامل ڪريو جڏھن اھو ڏيکاريل آھي. ياد رهي ته اهي ڪلاس شامل ڪيا ويندا ڪنهن به طبقن کان علاوه ٽيمپليٽ ۾ بيان ڪيل. گھڻن طبقن کي شامل ڪرڻ لاء، انھن کي خالن سان الڳ ڪريو: توھان ھڪڙو فنڪشن پڻ پاس ڪري سگھو ٿا جيڪو ھڪڙي اسٽرنگ کي واپس ڪرڻ گھرجي جنھن ۾ اضافي ڪلاس جا نالا شامل آھن. |
حد | تار | عنصر | 'اسڪرول والدين' | پاپ اوور جي اوور فلو پابندي جي حد. 'viewport' , , 'window' , 'scrollParent' , or an HTMLElement reference (صرف JavaScript) جا قدر قبول ڪري ٿو . وڌيڪ معلومات لاءِ ڏسو Popper's preventOverflow docs . |
صفائي ڪرڻ | بولين | سچو | صفائي کي فعال يا غير فعال ڪريو. جيڪڏهن چالو ڪيو ويندو 'template' ، 'content' ۽ 'title' اختيارن کي صاف ڪيو ويندو. اسان جي جاوا اسڪرپٽ دستاويزن ۾ صاف ڪرڻ وارو سيڪشن ڏسو . |
وائيٽ لسٽ | اعتراض | ڊفالٽ قدر | اعتراض جنهن ۾ اجازت ڏنل خاصيتون ۽ ٽيگ شامل آهن |
sanitizeFn | null | فنڪشن | null | هتي توهان پنهنجي صفائي واري فنڪشن کي فراهم ڪري سگهو ٿا. اهو ڪارائتو ٿي سگهي ٿو جيڪڏهن توهان صفائي ڪرڻ لاءِ وقف ٿيل لائبريري استعمال ڪرڻ چاهيندا آهيو. |
popperConfig | null | اعتراض | null | Bootstrap جي ڊفالٽ Popper config کي تبديل ڪرڻ لاء، Popper جي ترتيب ڏسو |
انفرادي پاپورز لاءِ ڊيٽا جون خاصيتون
انفرادي پاپورز لاءِ اختيارات متبادل طور تي بيان ڪري سگھجن ٿا ڊيٽا خاصيتن جي استعمال ذريعي، جيئن مٿي بيان ڪيو ويو آهي.
طريقا
هم وقت سازي طريقا ۽ منتقلي
سڀ API طريقا غير مطابقت رکندڙ آهن ۽ هڪ منتقلي شروع ڪن ٿا . اهي ڪالر ڏانهن موٽندا آهن جيئن ئي منتقلي شروع ٿئي ٿي پر ان کان اڳ ختم ٿي وڃي . ان کان علاوه، هڪ طريقو ڪال هڪ منتقلي جزو تي نظر انداز ڪيو ويندو .
$().popover(options)
هڪ عنصر گڏ ڪرڻ لاء popovers جي شروعات.
.popover('show')
هڪ عنصر جي پاپ اوور کي ظاهر ڪري ٿو. پوپ اوور اصل ۾ ڏيکاريو ويو آهي (يعني واقعي ٿيڻ کان اڳ) ڪالر ڏانهن واپسي . shown.bs.popover
اهو سمجهيو ويندو آهي "دستي" پاپ اوور جي ٽارگيٽ. Popovers جن جو عنوان ۽ مواد ٻئي صفر ڊگھائي آهن ڪڏهن به ڏيکاريل نه آهن.
$('#element').popover('show')
.popover('hide')
هڪ عنصر جي پاپ اوور کي لڪائيندو آهي. پوپ اوور اصل ۾ لڪايو ويو آهي (يعني واقعي ٿيڻ کان اڳ) ڪالر ڏانهن واپسي . hidden.bs.popover
اهو سمجهيو ويندو آهي "دستي" پاپ اوور جي ٽارگيٽ.
$('#element').popover('hide')
.popover('toggle')
هڪ عنصر جي پاپ اوور کي ٽوگل ڪري ٿو. پوپ اوور اصل ۾ ڏيکاريو ويو يا لڪايو ويو (يعني واقعي يا واقعو ٿيڻ کان اڳ) ڪالر ڏانهن واپسي . اهو سمجهيو ويندو آهي "دستي" پاپ اوور جي ٽارگيٽ.shown.bs.popover
hidden.bs.popover
$('#element').popover('toggle')
.popover('dispose')
هڪ عنصر جي پاپ اوور کي لڪائي ۽ تباهه ڪري ٿو. پاپورز جيڪي وفد استعمال ڪندا آهن (جيڪي اختيار استعمال ڪندي ٺاهيا ويا آهن ) selector
انفرادي طور تي نسلي ٽرگر عناصر تي تباهه نه ٿي سگهن.
$('#element').popover('dispose')
.popover('enable')
هڪ عنصر جي پاپ اوور کي ڏيکاريو وڃڻ جي صلاحيت ڏئي ٿي. Popovers ڊفالٽ طور تي فعال آهن.
$('#element').popover('enable')
.popover('disable')
هڪ عنصر جي پاپ اوور کي ڏيکارڻ جي صلاحيت کي هٽائي ٿو. پاپ اوور صرف ان صورت ۾ ڏيکاريو ويندو جڏهن ان کي ٻيهر فعال ڪيو ويندو.
$('#element').popover('disable')
.popover('toggleEnabled')
هڪ عنصر جي پاپ اوور کي ڏيکارڻ يا لڪائڻ جي صلاحيت کي ٽوگل ڪري ٿو.
$('#element').popover('toggleEnabled')
.popover('update')
هڪ عنصر جي پاپ اوور جي پوزيشن کي اپڊيٽ ڪري ٿو.
$('#element').popover('update')
واقعا
واقعي جو قسم | وصف |
---|---|
show.bs.popover | اهو واقعو فوري طور تي فائر ڪندو آهي جڏهن show مثال جو طريقو سڏيو ويندو آهي. |
ڏيکاريو ويو.bs.popover | اهو واقعو فائر ڪيو ويو آهي جڏهن پاپ اوور کي صارف لاءِ ظاهر ڪيو ويو آهي (سي ايس ايس جي منتقلي مڪمل ٿيڻ جو انتظار ڪندو). |
hide.bs.popover | اهو واقعو فوري طور تي فائر ڪيو ويو آهي جڏهن hide مثال جو طريقو سڏيو ويو آهي. |
hidden.bs.popover | هي واقعو فائر ڪيو ويندو آهي جڏهن پاپ اوور ختم ٿي چڪو آهي صارف کان لڪايو وڃي (سي ايس ايس جي منتقلي مڪمل ٿيڻ جو انتظار ڪندو). |
inserted.bs.popover | اهو واقعو ان واقعي کان پوءِ فائر ڪيو ويو آهي show.bs.popover جڏهن پاپ اوور ٽيمپليٽ ڊوم ۾ شامل ڪيو ويو آهي. |
$('#myPopover').on('hidden.bs.popover', function () {
// do something...
})