roxeteer / Leaflet-active-area

A Leaflet plugin to center the map not in the center of the map but inside a DIV. Useful for responsive design.

Leaflet-active-area

That Leaflet plugin allows you to use a DIV as the active area. All positionning methods (setView, fitBounds, setZoom) will be applyed on this DIV instead of the all map. A typical use case is to set a map as background (like that example) and center it on the top of the screen for example. Defining media queries on that DIV make it easy to adapt the active area according client resolution.

Demo

Try the example page !

Versions

The "master" branch supports the last stable version of leaflet (0.7.7) If you need to use this plugin with leaflet 1.0 beta, you can use the specific branch of leaflet-active-area leaflet-1.0

Usage

Include the javascript file :

<script src="L.activearea.js"></script>

Add a CSS class (".activeArea" in that example) with absolute position

.activeArea { position: absolute; top: 50px; left: 50px; right: 50px; height: 200px; }

And instanciate your map like that :

var map = new L.Map(document.createElement('div')).setActiveArea('activeArea');

You can also give an object with HTML style properties:

var map = new L.Map(document.createElement('div')).setActiveArea({
    position: 'absolute',
    top: '50px',
    left: '50px',
    right: '50px',
    height: '200px'
});

Then, the map will center itself in the center of that DIV when calling setView, setZoom, fitBounds, etc.

Contribute

To run tests, you’ll need to install npm and bower libraries :

npm install && bower install

then :

(cd spec && ../node_modules/karma/bin/karma start)

Contributors

• Samuel Piquet (sa3m, Mappy), creator of this plugin
• Grégory Paul (paulgreg, Mappy)
• Michael Cellier (mcellier, Mappy)
• Frederic Le Menach (flemenach, Mappy)
• Eric Brelsford (ebrelsford)
• Dag Jomar Mersland (dagjomar)
• Miroslav Petrik (11th)

License

This code is provided under the Apache 2.0 license.