جاوا اسڪرپٽ
jQuery تي ٺهيل اسان جي اختياري جاوا اسڪرپٽ پلگ ان سان بوٽ اسٽريپ کي جاندار بڻايو. هر پلگ ان، اسان جي ڊيٽا ۽ پروگراماتي API اختيارن، ۽ وڌيڪ بابت سکو.
انفرادي يا مرتب ڪيل
پلگ ان انفرادي طور تي شامل ڪري سگھجن ٿيون (بوٽ اسٽريپ جي انفرادي استعمال ڪندي js/dist/*.js
)، يا سڀ هڪ ڀيرو استعمال ڪندي bootstrap.js
يا گھٽ ۾ گھٽ bootstrap.min.js
(ٻنهي شامل نه ڪريو).
جيڪڏهن توهان هڪ بنڊل استعمال ڪندا آهيو (ويب پيڪ، رول اپ…)، توهان /js/dist/*.js
فائلون استعمال ڪري سگهو ٿا جيڪي UMD تيار آهن.
انحصار
ڪجھ پلگ ان ۽ سي ايس ايس جزا ٻين پلگ ان تي ڀاڙين ٿا. جيڪڏهن توهان انفرادي طور تي پلگ ان شامل ڪريو ٿا، پڪ ڪريو ته انهن انحصارن لاءِ دستاويز ۾ چيڪ ڪريو. اهو پڻ نوٽ ڪريو ته سڀئي پلگ ان jQuery تي منحصر آهن (هن جو مطلب آهي jQuery پلگ ان فائلن کان اڳ شامل ٿيڻ گهرجي ). اسانpackage.json
سان صلاح ڪريو ته ڏسو jQuery جا ڪهڙا نسخا سپورٽ آهن.
اسان جا ڊراپ ڊائون، پاپ اوور ۽ ٽول ٽائپس پڻ Popper.js تي ڀاڙين ٿا .
ڊيٽا خاصيتون
لڳ ڀڳ سڀئي بوٽ اسٽريپ پلگ ان کي فعال ۽ ترتيب ڏئي سگھجي ٿو HTML ذريعي اڪيلو ڊيٽا جي خاصيتن سان (جاوا اسڪرپٽ ڪارڪردگي کي استعمال ڪرڻ جو اسان جو پسنديده طريقو). پڪ ڪريو ته صرف هڪ واحد عنصر تي ڊيٽا جي خاصيتن جو هڪ سيٽ استعمال ڪريو (مثال طور، توهان هڪ ئي بٽڻ مان ٽول ٽائپ ۽ موڊل ٽرگر نٿا ڪري سگهو.)
تنهن هوندي، ڪجهه حالتن ۾ اهو ضروري آهي ته هن ڪارڪردگي کي بند ڪرڻ لاء. ڊيٽا جي خصوصيت API کي غير فعال ڪرڻ لاء، سڀني واقعن کي بند ڪريو دستاويز جي نالي جي جاء تي data-api
جيئن ته:
متبادل طور تي، هڪ مخصوص پلگ ان کي نشانو بڻائڻ لاءِ، صرف پلگ ان جو نالو شامل ڪريو نالي جي جاءِ سان گڏ ڊيٽا-api نالي جي جڳهه هن طرح:
چونڊيندڙ
في الحال سوال ڪرڻ لاءِ DOM عنصرن جو اسان استعمال ڪريون ٿا ڏيهي طريقا querySelector
۽ querySelectorAll
ڪارڪردگي سببن لاءِ، تنهنڪري توهان کي استعمال ڪرڻو پوندو صحيح چونڊ ڪندڙ . جيڪڏهن توهان خاص چونڊيندڙ استعمال ڪندا آهيو، مثال طور: collapse:Example
انهن کان بچڻ جي پڪ ڪريو.
واقعا
بوٽ اسٽراپ اڪثر پلگ ان جي منفرد ڪارناما لاءِ ڪسٽم واقعا مهيا ڪري ٿو. عام طور تي، اهي هڪ لاتعداد ۽ ماضي حصو وٺندڙ فارم ۾ ايندا آهن - جتي infinitive (ex. show
) ڪنهن واقعي جي شروعات تي شروع ڪيو ويندو آهي، ۽ ان جو ماضي حصو وٺندڙ فارم (مثال طور shown
) هڪ عمل جي مڪمل ٿيڻ تي شروع ڪيو ويندو آهي.
سڀ لاتعداد واقعا preventDefault()
ڪارڪردگي مهيا ڪن ٿا. هي هڪ عمل کي شروع ڪرڻ کان پهريان ان جي عمل کي روڪڻ جي صلاحيت فراهم ڪري ٿو. ايونٽ هينڊلر کان غلط موٽڻ به پاڻمرادو ڪال ڪندو preventDefault()
.
پروگراماتي API
اسان اهو پڻ سمجهون ٿا ته توهان کي جاوا اسڪرپٽ API ذريعي خالص طور تي سڀئي بوٽ اسٽريپ پلگ ان استعمال ڪرڻ جي قابل هوندا. سڀ عوامي APIs واحد، زنجير وارا طريقا آهن، ۽ جمع ڪيل ڪم کي واپس آڻيندا آهن.
سڀني طريقن کي اختياري اختياري اعتراض کي قبول ڪرڻ گهرجي، هڪ اسٽرنگ جيڪو هڪ خاص طريقي کي نشانو بڻائي ٿو، يا ڪجھ به نه (جيڪو ڊفالٽ رويي سان هڪ پلگ ان شروع ڪري ٿو):
هر پلگ ان پنهنجي خام تعمير ڪندڙ کي Constructor
ملڪيت تي ظاهر ڪري ٿو: $.fn.popover.Constructor
. جيڪڏهن توهان چاهيو ٿا ته هڪ خاص پلگ ان مثال حاصل ڪريو، ان کي ٻيهر حاصل ڪريو هڪ عنصر مان: $('[rel="popover"]').data('popover')
.
هم وقت سازي افعال ۽ منتقلي
سڀ پروگراماتي API طريقا غير مطابقت پذير آهن ۽ واپسي ڪالر ڏانهن هڪ ڀيرو منتقلي شروع ٿيندي پر ان جي ختم ٿيڻ کان اڳ .
هڪ عمل تي عمل ڪرڻ لاءِ هڪ ڀيرو منتقلي مڪمل ٿي وڃي ٿي، توهان ٻڌي سگهو ٿا لاڳاپيل واقعو.
اضافي طور تي هڪ طريقو ڪال هڪ منتقلي جزو تي نظر انداز ڪيو ويندو .
ڊفالٽ سيٽنگون
توھان پلگ ان لاءِ ڊفالٽ سيٽنگ تبديل ڪري سگھو ٿا پلگ ان جي Constructor.Default
اعتراض کي تبديل ڪندي:
ڪوبه تڪرار ناهي
ڪڏهن ڪڏهن ٻين UI فريم ورڪ سان بوٽ اسٽريپ پلگ ان استعمال ڪرڻ ضروري آهي. انهن حالتن ۾، نالي جي جاء تي ٽڪراء ڪڏهن ڪڏهن ٿي سگهي ٿي. جيڪڏهن ائين ٿئي ٿو، ته توهان .noConflict
پلگ ان تي ڪال ڪري سگهو ٿا جنهن جي قيمت توهان واپس ڪرڻ چاهيو ٿا.
نسخي نمبر
VERSION
بوٽ اسٽريپ جي jQuery پلگ ان مان هر هڪ جو نسخو پلگ ان جي تعمير ڪندڙ جي ملڪيت ذريعي رسائي سگهجي ٿو . مثال طور، ٽول ٽائپ پلگ ان لاءِ:
جڏهن جاوا اسڪرپٽ بند ٿيل هجي ته ڪو خاص ناڪام نه ٿيندو
بوٽ اسٽريپ جا پلگ ان واپس نه ٿا اچن خاص طور تي جڏهن جاوا اسڪرپٽ غير فعال آهي. جيڪڏهن توهان هن معاملي ۾ استعمال ڪندڙ جي تجربي جو خيال رکو ٿا، استعمال ڪريو <noscript>
صورتحال کي بيان ڪرڻ لاءِ (۽ ڪيئن جاوا اسڪرپٽ کي ٻيهر فعال ڪجي) توهان جي استعمال ڪندڙن کي، ۽/يا پنهنجا پنهنجا ڪسٽم فال بيڪ شامل ڪريو.
ٽئين پارٽي لائبريريون
بوٽ اسٽراپ رسمي طور تي ٽئين پارٽي جاوا اسڪرپٽ لائبريرين کي سپورٽ نٿو ڪري جهڙوڪ پروٽوٽائپ يا jQuery UI. واقعن جي باوجود .noConflict
۽ نالن جي جاءِ تي، ٿي سگهي ٿي مطابقت جا مسئلا جيڪي توهان کي پاڻ تي حل ڪرڻ گهرجن.
استعمال
سڀئي بوٽ اسڪرپٽ جاوا اسڪرپٽ فائلن تي ڀاڙين ٿيون util.js
۽ ان کي ٻين جاوا اسڪرپٽ فائلن سان گڏ شامل ڪيو وڃي. جيڪڏھن توھان استعمال ڪري رھيا آھيو مرتب ڪيل (يا minified) bootstrap.js
، ھن کي شامل ڪرڻ جي ڪا ضرورت ناھي- اھو اڳ ۾ ئي موجود آھي.
util.js
يوٽيلٽي فنڪشن ۽ واقعن لاءِ بنيادي مددگار ۽ transitionEnd
گڏوگڏ هڪ CSS ٽرانسشن ايموليٽر شامل آهي. اهو استعمال ڪيو ويو آهي ٻين پلگ انز کي چيڪ ڪرڻ لاءِ CSS منتقلي جي مدد لاءِ ۽ پھانسي واري منتقلي کي پڪڙڻ لاءِ.
صفائي ڪندڙ
ٽول ٽائپس ۽ پاپورز اسان جي بلٽ ان سينٽيزر کي استعمال ڪن ٿا انهن اختيارن کي صاف ڪرڻ لاءِ جيڪي HTML قبول ڪن ٿا.
ڊفالٽ whiteList
قدر ھيٺ ڏنل آھي:
جيڪڏهن توهان هن ڊفالٽ ۾ نوان قدر شامل ڪرڻ چاهيو ٿا ته whiteList
توهان هيٺيان ڪري سگهو ٿا:
جيڪڏهن توهان چاهيو ٿا ته اسان جي صفائي واري مشين کي نظرانداز ڪيو ڇو ته توهان هڪ وقف لائبريري استعمال ڪرڻ کي ترجيح ڏيو ٿا، مثال طور DOMPurify ، توهان کي هيٺيان ڪرڻ گهرجي: