leaflet-sidebar

A responsive sidebar plugin for for Leaflet, a JS library for interactive maps.

Examples

Examples are available in the examples folder and on Github Pages:

Using the plugin

See the included examples for usage.

Usage

Add a content container somewhere in your document:

<div id="sidebar">
    <h1>leaflet-sidebar</h1>
</div>

Create a new L.Control.Sidebar and add it to the map:

var sidebar = L.control.sidebar('sidebar', {
    position: 'left'
});

map.addControl(sidebar);

The sidebar will be hidden on startup, use the following methods to show or hide it:

// Show sidebar
sidebar.show();

// Hide sidebar
sidebar.hide();

// Toggle sidebar visibility
sidebar.toggle();

// Check sidebar visibility
var visible = sidebar.isVisible();

If you want the sidebar to be visible on startup use the following snippet after adding it to the map:

setTimeout(function () {
    sidebar.show();
}, 500);

Do not call show() directly after adding the control to the map. The setTimeout will work around some CSS quirks for you.

The content of the sidebar can be changed dynamically:

sidebar.setContent('test <b>test</b> test');

If you need more flexibility you can use sidebar.getContainer() to get the content container element or use e.g. jQuery on the <div id="sidebar"> element.

Options

The sidebar can be configured with these options:

position: Can be left (default) or right and shouldn't need explaining.
closeButton: Can be true (default) or false. If true a close button will be added to the sidebar.

Events

Whenever the visibility of the sidebar is changed, an event is fired on the sidebar instance. You can listen for these events like this:

sidebar.on('hide', function () {
    console.log('Sidebar is now hidden.');
});

Compatibility

leaflet-sidebar was developed to work with Leaflet 0.6.4 and should work fine with v0.7 too. I have no information whether it works well with older versions.

The leaflet-sidebar plugin has been tested on the following systems and browsers:

Ubuntu: Firefox, Chrome
Mac OS X: Firefox, Chrome, Safari
Android 4.3: Firefox, Chrome, Opera
iOS: Safari
Windows XP: Internet Explorer 6 (failed!)

Changelog

v0.1.2 (not yet released)

Fixed broken stopPropagation() call (#2)
Fire show and hide events on sidebar instances
Added getCloseButton() method

v0.1.1 (2013-11-03)

Fixed close button event handler (#1)

v0.1.0 (2013-10-30)

First official release
position option
closeButton option
getContainer() and setContent() methods
two more examples

v0.0.0 (2013-10-29)

Preview release

License

leaflet-sidebar is free software, and may be redistributed under the MIT license.

robertbak / leaflet-sidebar