BREAKINGCHANGES.md

How to upgrade from 0.1 to 0.2

There are a number of changes to the plugin in 0.2 that may break peoples implementations of Leaflet.draw 0.1. If you I will try my best to list any changes here.

Event consolidation

Leaflet.draw 0.1 had a created event for each different shape that was created. 0.2 now consolidates these into a single created shape.

The vector or marker is accessed by the layer property of the event arguments, the type of layer by the layerType.

New way

map.on('draw:created', function (e) {
	var type = e.layerType,
		layer = e.layer;

	if (type === 'marker') {
		// Do any marker specific logic here
	}

	map.addLayer(layer);
});

Old way

map.on('draw:poly-created', function (e) {
	map.addLayer(e.poly);
});
map.on('draw:rectangle-created', function (e) {
	map.addLayer(e.rect);
});
map.on('draw:circle-created', function (e) {
	map.addLayer(e.circ);
});
map.on('draw:marker-created', function (e) {
	e.marker.bindPopup('A popup!');
	map.addLayer(e.marker);
});

Draw handler started/stopped event change

Renamed the drawing started and stopped events to be the same as the created standard.

drawing -> draw:drawstart and drawing-disabled -> draw:drawstop.

The event argument has also changed from drawingType -> layerType.

CSS changes

There has been a whole bunch of CSS changes, if you have customized any of these please see leaflet.draw.css.