jes5e/Leaflet.FeatureGroup.SubGroup

Creates a Feature Group that adds its child layers into a parent group when added to a map (e.g. through L.Control.Layers)

Leaflet.FeatureGroup.SubGroup

Creates a Leaflet Feature Group that adds its child layers into a parent group when added to a map (e.g. through L.Control.Layers).

Typical usage is to dynamically add/remove groups of markers from Marker Cluster.

Leaflet.markercluster plugin provides beautiful animated Marker Clustering functionality.

Leaflet is the leading open-source JavaScript library for mobile-friendly interactive maps.

Current SubGroup version: 0.1.0

Requirements

• Leaflet stable (0.7.x)
• Leaflet.markercluster stable (0.4.x)

Demos

• SubGroup with standard L.Control.Layers and MarkerCluster
• SubGroup with standard L.Control.Layers to display Nested Groups

Usage instructions

Quick Guide

HTML head:

<link rel="stylesheet" href="leaflet.css" />

<!-- any plugin related CSS -->
<link rel="stylesheet" href="MarkerCluster.css" />
<link rel="stylesheet" href="MarkerCluster.Default.css" />

HTML body:

<div id="map" style="width: 800px; height: 600px;"></div>

<script src="leaflet.js"></script>
<script src="leaflet.markercluster.js"></script> <!-- any LayerGroup plugin -->

<!-- add SubGroup script -->
<script src="leaflet.featuregroup.subgroup-src.js"></script>

JavaScript:

var map = L.map("map"),
    parentGroup = L.markerClusterGroup(options),
    
    // This is where the magic happens!
    mySubGroup = L.featureGroup.subGroup(parentGroup, arrayOfMarkers);
    
parentGroup.addTo(map);
mySubGroup.addTo(map);

Now adding the sub-group to the map adds clustered markers!

It should virtually be compatible with any LayerGroup plugin, not only MarkerCluster.

Installing the sub-plugin

Simply add the "leaflet.featuregroup.subgroup-src.js" script file to your page after Leaflet and Leaflet.markercluster scripts (or any LayerGroup plugin script).

Creation

Simply use the L.featureGroup.subGroup factory instead of your regular L.featureGroup or L.layerGroup:

var mySubGroup = L.featureGroup.subGroup(parentGroup);

mySubGroup.addTo(map);

Do not forget to add the parent group to your map.

API Reference

Creation

Factory	Description
L.featureGroup.subGroup( <ILayer> parentGroup?, <ILayer[]> layersArray? )	Creates a sub-group with events, optionally given a parent group and an initial array of child layers.

Methods

Method	Returns	Description
setParentGroup( <ILayer> parentGroup )	this	Changes the parent group into which child markers are added to / removed from.
setParentGroupSafe( <ILayer> parentGroup )	this	Removes the current sub-group from map before changing the parent group. Re-adds the sub-group to map if it was before changing.
getParentGroup()	<ILayer>	Returns the current parent group.

SubGroup does not provide any extra option or event beyond what L.LayerGroup and L.FeatureGroup already provide.

Limitations

If you change the parent group while the sub-group and/or its child markers are still on map, unexpected behaviour of the previous and/or new parent groups can happen.

Make sure the sub-group and its child layers are removed from map before changing the parent group, or use the setParentGroupSafe method instead.

Contributing

1. Install node.
2. Clone this repository $ git clone https://github.com/jes5e/Leaflet.FeatureGroup.SubGroup.git.
3. Install dependencies $ npm install.
4. Run build $ jake.

License

Leaflet.FeatureGroup.SubGroup is distributed under the BSD 2-clause "Simplified" License, like Leaflet.