کتابخانه
popper.js یه کتابخانه جاوااسکریپت برای جایگذاری دقیق عنصرهای شناور مثل تولتیپ، پاپ اور و منوی کشویی کنار عنصر مرجعشونه. لبه های صفحه، اسکرول و تغییر اندازه رو در نظر می گیره و موقعیت رو خودکار درست می کنه. مجوزش MIT هست و نسخه رسمیش تو مخزن ما در دسترسه.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
۵۴۶ کیلوبایت· ۷۶ فایل· انتشار
SHA-256: fe28dc38bc057f6eb11180235bbe458b3295a39b674d889075d3d9a0b5071d9f
popper.js یه کتابخانه کوچیک جاوااسکریپته که یه کار مشخص رو خوب انجام می ده: حساب می کنه یه عنصر شناور دقیقا کجا قرار بگیره. فرض کن می خوای کنار یه دکمه تولتیپ نشون بدی. با CSS و position ساده شاید اولش جواب بگیری، ولی همین که دکمه بیاد کنار لبه صفحه یا تو یه کانتینر با overflow بیفته، نصف تولتیپ بیرون می زنه و بریده می شه. popper.js دقیقا برای همین موقعیت ها ساخته شده.
تو سایت های وردپرسی کاربردش خیلی ملموسه. تولتیپ و پاپ اور، منوی دراپ داون، منوی کشویی کنار آیکون پروفایل، لیست پیشنهاد جستجو، انتخابگر تاریخ و سلکت سفارشی، همه یه نیاز مشترک دارن: یه پنجره کوچیک که باید کنار یه عنصر دیگه بیاد و با اسکرول و تغییر اندازه صفحه جابه جا بشه. خیلی از کتابخانه های رابط کاربری، از جمله نسخه های قدیمی تر بوت استرپ، همین کتابخانه رو زیر کارشون دارن. پس اگه قالب یا افزونه ات بوت استرپ داره، ممکنه popper.js قبلا همراه بسته اومده باشه. قبل از اضافه کردنش چک کن که دو بار لود نشه.
یه نکته رو از اول بگم: popper.js خودش ظاهر نمی سازه. استایل، انیمیشن و باز و بسته شدن عنصر یا کار خودته یا کار کتابخونه ای که روش سوار شده. اگه فقط یه تولتیپ ساده و ثابت می خوای که قرار نیست کنار لبه صفحه گیر کنه، همون CSS خالی کافیه و لازم نیست کتابخانه اضافه کنی.
موقع انتخاب این رو هم در نظر بگیر که بسته ای با نام popper.js مربوط به نسل قدیمی پروژه هست. نسل جدیدتر با نام @popperjs/core منتشر می شه و API اش فرق داره، پس کدی که برای یکی نوشته شده رو بدون تغییر نمی شه روی اون یکی گذاشت. اگه پروژه تازه شروع می کنی، اول ببین کتابخونه های دیگه ات کدوم رو می خوان. اگه یه قالب یا افزونه قدیمی دقیقا همین بسته رو لازم داره، همینو بذار و عوضش نکن. تو سایت های راست به چپ هم رفتار منوها و تولتیپ ها رو حتما تو خود صفحه ات تست کن.
نسخه های رسمی و بدون تغییر popper.js تو مخزن داخلی ما هم هست. اگه یه روز دسترسی به npm یا CDN های خارجی قطع یا کند بود، می تونی از فایل های همین مخزن استفاده کنی.
استفاده از popper.js تو یه صفحه معمولی ساده هست. کد آماده اضافه کردنش پایین همین صفحه هست و فقط باید بدونی کجای قالبت بذاریش.
بعد از نصب، صفحه رو یه بار کوچیک و بزرگ کن و اسکرول بده تا مطمئن بشی عنصر شناور تو حالت های مختلف سر جاش می مونه.
یه کتابخانه جاوااسکریپته که موقعیت عنصرهای شناور مثل تولتیپ، پاپ اور و منوی کشویی رو نسبت به یه عنصر دیگه حساب می کنه. اگه جا کم باشه یا صفحه اسکرول بخوره، موقعیت رو خودکار اصلاح می کنه. ظاهر و انیمیشن کار خودش نیست و فقط جایگذاری رو انجام می ده.
هر دو از یه پروژه ان. popper.js نام بسته نسل قدیمی تره و @popperjs/core نام نسل جدیده. API شون یکی نیست، برای همین کدی که برای یکی نوشته شده روی اون یکی مستقیم کار نمی کنه. اگه پروژه یا افزونه ات یکی از این دو رو مشخص خواسته، همون رو بذار و عوضش نکن.
بستگی به نسخه بوت استرپ داره. نسخه های قدیمی تر این کتابخانه رو جدا می خواستن و باید قبل از اسکریپت بوت استرپ لود می شد. بعضی بسته ها هم یه نسخه همراه خودشون دارن. مستندات همون نسخه ای که استفاده می کنی رو نگاه کن و مطمئن شو دو بار لود نمی شه.
نه، popper.js با جاوااسکریپت ساده کار می کنه و به jQuery وابسته نیست. تو سایت های وردپرسی با jQuery یا بدون اون می تونی ازش استفاده کنی. فقط اگه کتابخونه دیگه ای روش سوار شده، مثل بوت استرپ قدیمی، ممکنه اون یکی jQuery بخواد.
بله، مجوز MIT استفاده تو پروژه های شخصی و تجاری رو اجازه می ده. یعنی لازم نیست بابت استفاده پولی بدی یا از کسی اجازه بگیری. فقط باید اعلان کپی رایت و متن مجوز رو همراه کتابخانه نگه داری. برای جزئیات دقیق، متن مجوزی که همراه بسته هست رو بخون.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.