/Vue2Leaflet

Vue 2 components for Leaflet maps

Primary LanguageVueMIT LicenseMIT

Vue2Leaflet

Join the chat at https://gitter.im/Vue2Leaflet/Lobby

Downloads Downloads Version License

Vue2 component that helps with leaflet interaction

How to display a map with a marker

Register Map and TileLayer components from Vue2Leaflet

import Vue2Leaflet from 'vue2-leaflet';

Vue.component('v-map', Vue2Leaflet.Map);
Vue.component('v-tilelayer', Vue2Leaflet.TileLayer);
Vue.component('v-marker', Vue2Leaflet.Marker);

Add the map to your page

<div id="app" style="height: 100%">
  <v-map :zoom=13 :center="[47.413220, -1.219482]">
    <v-tilelayer url="http://{s}.tile.osm.org/{z}/{x}/{y}.png"></v-tilelayer>
    <v-marker :lat-lng="[47.413220, -1.219482]"></v-marker>
  </v-map>
</div>
new Vue({ el: '#app'});

Make sure the leaflet.css is included, either via a HTML link tag or in your vue component style

@import "~leaflet/dist/leaflet.css";

Here is the result

Image of Map

More live demos will come soon

If you want to try it here is a JS Fiddle Hello Map of the World

How to install

$ npm install vue2-leaflet --save

List of currently implemented components

  • Map
  • Marker
  • Popup
  • Tooltip
  • TileLayer
  • TileLayer.WMS
  • ImageOverlay
  • Polyline
  • Polygon
  • Rectangle
  • Circle
  • CircleMarker
  • LayerGroup
  • FeatureGroup
  • GeoJSON

Build Setup

# Once you have cloned this repo, install dependencies
$ npm install

# build for development and production with minification
$ npm run build

Leaflet Plugins

This repo is a wrapper for Leafet and VueJs. I want to keep it as simple as possible so I don't want to add any plugin support into this repo.

Leaflet plugins can easily work with Vue2Leaflet, if you want to use one I would recommand to look at the awesome work made by the community in the list below.

Vue2Leafet plugins:

If you have created a plugin and want it to be listed here, let me know :-).

FAQ

How can I access the Leaflet map object ?

First add a ref to the map

<div id="app" style="height: 100%">
  <v-map ref="map" :zoom=13 :center="[47.413220, -1.219482]">
    <v-tilelayer url="http://{s}.tile.osm.org/{z}/{x}/{y}.png"></v-tilelayer>
  </v-map>
</div>

Then in you javascript you can use mapObject which is Leaflet map instance :

this.$refs.map.mapObject;

This also work for any other component (Marker, Polyline, etc...)

How can I bind events of Vue2Leaflet components ?

All event binding can be done to event called l-[leaflet_event], where [leaflet_event] is the name of the event from leaflet documentation.

For example if you want to bind to leaflet marker move event, you can bind to Vue2Leaflet.Marker l-move event.

<div id="app" style="height: 100%">
  <v-map :zoom=13 :center="[47.413220, -1.219482]">
    <v-tilelayer url="http://{s}.tile.osm.org/{z}/{x}/{y}.png"></v-tilelayer>
    <v-marker :lat-lng="[47.413220, -1.219482]" @l-move="doSomething"></v-marker>
  </v-map>
</div>

Run demo locally

# Run demo at localhost:8080
$ npm link
$ cd examples
$ npm link vue2-leaflet
$ npm install
# serve with hot reload at localhost:8080
$ npm run dev

Go to http://localhost:8080/ to see a some examples

NOTE: If you make changes to the library you should run 'npm run build' again in the root folder. The dev server should detect modification and reload the demo

Authors

Mickaël Bouchaud

Inspired by many map wrapper (google and leaflet) for many framework (React, Angular and Vue 1.0)

Contributors

Thanks goes to these wonderful people:

License

This project is licensed under the MIT License - see the LICENSE file for details