پرش به محتویات

Map (Leaflet)

Map (Leaflet) (map-leaflet) یک نقشه تعاملی با استفاده از Leaflet و tile layerها (پیش‌فرض: OpenStreetMap) embed می‌کند. برخلاف المان Google Map، از Google Maps JavaScript API استفاده نمی‌کند — از این المان وقتی tile های سبک OSM یا URL های tile سفارشی بدون Google می‌خواهید استفاده کنید.

این المان در سازنده draggable نیست (draggable = false) تا از تداخل با تعامل نقشه جلوگیری شود. اسکریپت‌ها و استایل‌های bricks-leaflet را enqueue می‌کند.

لایه‌ها (Layers)

Layers (repeater) — هر لایه شامل:

  • Name (text) — نام لایه، مثلاً OpenStreetMap.
  • URL (text) — قالب URL tile با placeholder های {z}، {x}، {y}.
  • Min Zoom، Max Zoom (number) — حداقل و حداکثر زوم.
  • Error Tile URL (text) — URL tile جایگزین در صورت خطا.
  • Attribution (text) — متن attribution نقشه.

ردیف پیش‌فرض repeater از URL tile استاندارد OpenStreetMap استفاده می‌کند.

نشانگرها (Markers)

Markers (repeater):

  • Coordinates (text) — latitude, longitude (جداشده با کاما). از dynamic data پشتیبانی می‌کند.
  • Label (text) — برچسب کمکی فقط در سازنده برای تمایز نشانگرها.
  • Icon (image) — تصویر مخصوص هر نشانگر؛ وقتی تنظیم شده، Height / Width (px).
  • Popup (Text) (editor) — محتوای popup برای آن نشانگر.

نشانگر پیش‌فرض (Marker Default)

تنظیمات global پیش‌فرض وقتی نشانگر آیکون سفارشی ندارد:

  • Icon (image)، Icon: Height (px)، Icon: Width (px).

نقشه (Map)

  • Height (number with units) — ارتفاع container نقشه. پیش‌فرض: 300px. هنگام تغییر، reload نقشه را trigger می‌کند.

  • Map center (text) — مرکز نقشه به فرمت latitude, longitude.

  • Zoom level (Initial) (number) — سطح زوم اولیه.

  • Zoom level (Min)، Zoom level (Max) (number) — حداقل و حداکثر سطح زوم.

  • Zoom: Snap، Zoom: Delta (number) — تنظیمات دقیق زوم.

  • Zoom: Double-click (select) — Enabled، Enabled (Center) یا Disabled.

  • Zoom: Scroll wheel (select) — همان گزینه‌ها.

  • Box Zoom (checkbox) — زوم با کشیدن کادر انتخاب.

  • Zoom Control (checkbox) — نمایش کنترل زوم روی نقشه.

  • Attribution Control (checkbox) — نمایش attribution نقشه.

  • Close popup on click (checkbox) — بستن popup با کلیک روی نقشه.

  • Dragging (checkbox) — امکان drag کردن نقشه.

  • Track resize (checkbox) — ردیابی تغییر اندازه container. گزینه‌های map Leaflet را ببینید.

مرجع توسعه‌دهنده

برای JSON schema کامل به Map (Leaflet) Schema مراجعه کنید.