Skip to content

Latest commit

 

History

History
37 lines (25 loc) · 1.66 KB

File metadata and controls

37 lines (25 loc) · 1.66 KB

Map Legend

Make your legend visible, and clearly linked to your data, and if possible, expanded by default.

Some mapping libraries, such as Leaflet.js, do not have a legend expanded by default, even in larger browser windows.

screenshot of Leaflet legend icon unexpanded

While a minimized legend can have its purpose on mobile displays, it is an asset on larger displays to ensure your visitors can understand your map.

Instead of using the default display, you can add in a few lines of code to expand your map legend on larger displays with the following code in Leaflet.js:

/* Current as of Leaflet version 1.0.0 */

// Browsers larger than 767 pixels will see an expanded layer control
if (document.body.clientWidth <= 767) {
    isCollapsed = true;
} else {
    isCollapsed = false;
}

// Add the legend to the map
// Add the isCollapsed method to the legend
L.control.layers(baseMaps, overlayMaps, {
  	collapsed: isCollapsed
});

And, voila! You now have an expanded legend! 😜

screenshot of Leaflet legend fully expanded

Other Legend Tips

Link your legend to your data to make associations more apparent to users. For example: via an interactive mouseover, clickable popup, etc. Then, use intuitive symbology throughout your map to make your legend supplemental, instead of a necessity for visitors.

Return to the Best Practices homepage.