Skip to content

Migration Guide

Upgrading Leaflet to v2

Leaflet released a new major version in alpha state. With the modernization comes a bunch of changes. If you use leaflet directly in your code make sure to follow the leaflet migration guide.

Upgrading the vue-leaflet wrapper

Major Changes

  • core: remove WINDOW_OR_GLOBAL from utils
  • core: remove useGlobalLeaflet
    • is not necessary with leaflet v2 and ESM support
  • core: remove type Data from utils
  • core: crs value in LMap now needs to be a value of CRS class
  • interactiveLayer: rename bubblingMouseEvents to bubblingPointerEvents, see Leaflet v2
    • also applies to Path, Polyline, Polygon, CircleMarker, Circle
  • deprecate unreachable code (see #56)
  • types: remove IMapBlueprint

New Components

Two new components have been added:

  • LSVGOverlay
  • LVideoOverlay

Plugin support

Check out vue-leaflet-plugins for the new plugin support.