کتابخانه
Leaflet یه کتابخونه جاوااسکریپت متن باز برای ساخت نقشه های تعاملی و سازگار با موبایله. با Leaflet می تونی نقشه رو توی صفحه بذاری، روش نشانگر و پاپ آپ بسازی، مسیر و محدوده رسم کنی و داده جغرافیایی نشون بدی، بدون اینکه سایتت سنگین بشه.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز BSD-2-Clause؛ هش هر فایل با منبع بررسی شده است.
۱٫۴ مگابایت · ۹۷ فایل · انتشار
دانلود هفتگی جهانی
۱۰٫۲ میلیون
هفته ۲۵ مهر تا ۱ آبان۳٫۲٪ بیشتر از هفته قبل
منبع: npmبه‌روزرسانی آمار
SHA-256: db49d009c841f5ca34a888c96511ae936fd9f5533e90d8b2c4d57596f4e5641a
خیلی از سایت ها یه جایی به نقشه نیاز پیدا می کنن: صفحه «تماس با ما» با آدرس دفتر، فهرست شعبه ها، محل فروشگاه های همکار یا مسیر یه رویداد. تعبیه یه نقشه آماده با iframe ساده ترین راهه، ولی کنترل زیادی بهت نمی ده. نمی تونی ظاهرش رو دلخواه کنی، چند نقطه با پاپ آپ مخصوص خودت بذاری یا داده خودت رو روش بکشی. Leaflet دقیقاً برای همین جاهاست.
Leaflet یه کتابخونه متن باز و سبکه که نقشه رو توی صفحه می سازه و کار کردن باهاش راحته. لایه های نقشه، نشانگر، پاپ آپ، خط، چند ضلعی، دایره و داده GeoJSON رو پشتیبانی می کنه. روی موبایل هم با لمس، بزرگ نمایی با دو انگشت و حرکت روان خوب کار می کنه. هسته اش عمداً کوچیک نگه داشته شده. قابلیت های اضافه مثل خوشه بندی نشانگرها یا نقشه حرارتی رو از افزونه های جانبی می گیری. مجوزش BSD-2-Clause هست و استفاده تجاری آزاده، فقط اعلان مجوز رو باید حفظ کنی.
یه نکته رو خیلی ها اولش جا می ندازن: Leaflet خودش داده نقشه نداره. فقط موتور نمایشه و تصویر نقشه رو از یه منبع تایل می گیره. مثال های رسمی معمولاً از تایل های OpenStreetMap استفاده می کنن، ولی از ایران گاهی کند یا در دسترس نیست. سیاست استفاده اون سرور هم برای ترافیک سنگین مناسب نیست. پس برای یه سایت جدی یا سراغ سرویس نقشه ای برو که شرایطش رو بررسی کردی، یا تایل سرور خودت رو راه بنداز. شرایط استفاده هر منبع رو قبل از انتشار حتماً بخون.
یه مشکل رایج دیگه هم اینه که وقتی با باندلر کار می کنی، آیکون پیش فرض نشانگر گاهی نمایش داده نمی شه، چون مسیر تصویرها رو درست پیدا نمی کنه. اون موقع باید آیکون رو دستی تنظیم کنی.
Leaflet برای صفحه آدرس، فروشگاه یاب، نمایش نقطه ها روی نقشه و داشبوردهای ساده با داده جغرافیایی انتخاب خوبیه. برای نقشه سه بعدی، چرخوندن و شیب دادن نقشه یا نمایش سنگین تایل برداری مناسب نیست و بهتره سراغ کتابخونه های تخصصی تر بری. نسخه های رسمی و بدون تغییر Leaflet توی مخزن داخلی ما هم هست، پس اگه اینترنت بین الملل محدود بود، می تونی از همین جا بگیری و روی هاست خودت سرو کنی.
استفاده ازش چند قدم بیشتر نیست:
اگه پروژه ات با npm کار می کنه، بسته leaflet رو نصب کن و با import بارگذاری کن. توی وردپرس هم می تونی فایل ها رو با wp_enqueue_style و wp_enqueue_script از پوشه قالب یا افزونه ات لود کنی. بهتره فایل ها روی همون هاست خودت باشن تا به CDN خارجی وابسته نباشی. اگه سایتت راست به چپه و متن پاپ آپ ها بهم ریخت، جهت متن داخل پاپ آپ رو جدا تنظیم کن.
Leaflet یه کتابخونه جاوااسکریپت متن باز برای ساخت نقشه های تعاملیه. باهاش می تونی توی صفحه وب نقشه نشون بدی، نشانگر و پاپ آپ بذاری، خط و محدوده بکشی و داده GeoJSON رو نمایش بدی. روی موبایل هم خوب کار می کنه و سنگین نیست.
بله. مجوزش BSD-2-Clause هست و استفاده تجاری رو آزاد می ذاره. فقط باید اعلان مجوز و حق نشر رو حفظ کنی. یادت باشه مجوز Leaflet یه چیزه و شرایط استفاده از منبع تایل نقشه ای که انتخاب می کنی چیز دیگه ای. اون رو جدا بررسی کن.
سه دلیل رایج داره. اول اینکه div نقشه ارتفاع نداره. دوم اینکه فایل CSS لود نشده یا بعد از اسکریپت اومده. سوم اینکه تایل ها از منبع بیرونی نمی رسن، که از ایران گاهی پیش میاد. کنسول مرورگر و تب شبکه معمولاً علتش رو نشون می ده.
بله، چون Leaflet به منبع تایل خاصی وابسته نیست. می تونی از سرویس نقشه داخلی یا تایل سرور خودت استفاده کنی. خود فایل های کتابخونه رو هم می شه روی هاست خودت نگه داشت تا لود شدنشون به سرور خارجی بستگی نداشته باشه.
دو راه داری. یا افزونه ای نصب کن که از Leaflet استفاده می کنه، یا فایل های CSS و جاوااسکریپت رو توی قالب یا افزونه خودت با wp_enqueue_style و wp_enqueue_script لود کن و نقشه رو با چند خط اسکریپت بساز. راه دوم کنترل بیشتری بهت می ده.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.