جاوا اسکریپت
بوت استرپ را با افزونه های اختیاری جاوا اسکریپت ساخته شده بر روی jQuery زنده کنید. درباره هر افزونه، گزینههای API دادهها و برنامهای ما و موارد دیگر اطلاعات کسب کنید.
پلاگینها را میتوان بهصورت جداگانه (با استفاده از *.js
فایلهای فردی بوت استرپ)، یا بهطور همزمان با استفاده bootstrap.js
یا کوچکسازی bootstrap.min.js
(هر دو را شامل نشود) گنجاند.
برخی از پلاگین ها و اجزای CSS به پلاگین های دیگر بستگی دارند. اگر افزونهها را به صورت جداگانه اضافه میکنید، حتماً این وابستگیها را در اسناد بررسی کنید. همچنین توجه داشته باشید که همه پلاگین ها به jQuery وابسته هستند (این بدان معناست که jQuery باید قبل از فایل های افزونه گنجانده شود). با ما مشورتpackage.json
کنید تا ببینید کدام نسخه از jQuery پشتیبانی می شود.
بازشوها، پاپاورها و نکات ابزار ما نیز به Popper.js بستگی دارد .
تقریباً تمام پلاگین های بوت استرپ را می توان تنها از طریق HTML با ویژگی های داده (روش ترجیحی ما برای استفاده از عملکرد جاوا اسکریپت) فعال و پیکربندی کرد. مطمئن شوید که فقط از یک مجموعه از ویژگیهای داده در یک عنصر استفاده میکنید (به عنوان مثال، نمیتوانید یک tooltip و modal را از همان دکمه فعال کنید.)
با این حال، در برخی شرایط ممکن است غیرفعال کردن این عملکرد مطلوب باشد. برای غیرفعال کردن API مشخصه داده، همه رویدادها را در فضای نام سند با data-api
شکل زیر لغو پیوند کنید:
از طرف دیگر، برای هدف قرار دادن یک پلاگین خاص، فقط نام افزونه را به عنوان فضای نام به همراه فضای نام data-api مانند زیر وارد کنید:
بوت استرپ رویدادهای سفارشی را برای اقدامات منحصر به فرد بیشتر افزونه ها فراهم می کند. به طور کلی، این ها به صورت مصدر و ماضی هستند - که در آن مصدر (مثل show
) در شروع یک رویداد تحریک می شود، و شکل ماضی آن (مصدر) shown
پس از اتمام یک عمل فعال می شود.
همه رویدادهای نامتناهی preventDefault()
عملکردی را ارائه می دهند. این امکان را فراهم می کند تا اجرای یک عمل قبل از شروع آن متوقف شود. بازگشت false از یک کنترل کننده رویداد نیز به طور خودکار تماس preventDefault()
می گیرد.
ما همچنین معتقدیم که شما باید بتوانید از تمام پلاگین های Bootstrap صرفاً از طریق JavaScript API استفاده کنید. همه APIهای عمومی متدهای تکی و زنجیرهای هستند و مجموعهای را که بر اساس آن عمل شده است برمیگردانند.
همه متدها باید یک شی گزینه اختیاری، رشتهای که یک متد خاص را هدف قرار میدهد یا هیچ چیز (که یک پلاگین را با رفتار پیشفرض شروع میکند) بپذیرند:
هر افزونه همچنین سازنده خام خود را در یک Constructor
ویژگی نشان می دهد: $.fn.popover.Constructor
. اگر میخواهید نمونه پلاگین خاصی را دریافت کنید، آن را مستقیماً از یک عنصر بازیابی کنید: $('[rel="popover"]').data('popover')
.
همه روشهای API برنامهریزی ناهمزمان هستند و پس از شروع انتقال، اما قبل از پایان آن ، به تماسگیرنده بازمیگردند .
به منظور اجرای یک عمل پس از اتمام انتقال، می توانید به رویداد مربوطه گوش دهید.
علاوه بر این، فراخوانی متد بر روی یک جزء انتقال نادیده گرفته خواهد شد .
میتوانید تنظیمات پیشفرض یک افزونه را با تغییر Constructor.Default
شیء افزونه تغییر دهید:
گاهی اوقات لازم است از افزونه های بوت استرپ با سایر فریم ورک های UI استفاده کنید. در این شرایط، گاهی اوقات ممکن است برخورد فضای نام رخ دهد. اگر این اتفاق افتاد، میتوانید با .noConflict
افزونهای که میخواهید ارزش آن را برگردانید تماس بگیرید.
نسخه هر یک از پلاگین های جی کوئری بوت استرپ از طریق VERSION
ویژگی سازنده افزونه قابل دسترسی است. به عنوان مثال، برای افزونه tooltip:
وقتی جاوا اسکریپت غیرفعال است، پلاگینهای بوت استرپ بهخوبی کار نمیکنند. اگر در این مورد به تجربه کاربری اهمیت می دهید، <noscript>
برای توضیح وضعیت (و نحوه فعال کردن مجدد جاوا اسکریپت) به کاربران خود و/یا اضافه کردن بک گراندهای سفارشی خود استفاده کنید.
کتابخانه های شخص ثالث
بوت استرپ به طور رسمی از کتابخانه های جاوا اسکریپت شخص ثالث مانند Prototype یا jQuery UI پشتیبانی نمی کند. با وجود .noConflict
رویدادها و فضای نام، ممکن است مشکلات سازگاری وجود داشته باشد که باید به تنهایی آنها را برطرف کنید.
همه فایل های جاوا اسکریپت بوت استرپ به این بستگی دارد util.js
و باید در کنار سایر فایل های جاوا اسکریپت گنجانده شود. اگر از کامپایلشده (یا کوچکسازیشده) استفاده میکنید bootstrap.js
، نیازی به اضافه کردن این نیست - قبلاً وجود دارد.
util.js
شامل توابع ابزار و یک کمک کننده اساسی برای transitionEnd
رویدادها و همچنین یک شبیه ساز انتقال CSS است. توسط سایر پلاگین ها برای بررسی پشتیبانی از انتقال CSS و برای گرف��ن ترانزیشن های معلق استفاده می شود.