
Security News
Oracle Drags Its Feet in the JavaScript Trademark Dispute
Oracle seeks to dismiss fraud claims in the JavaScript trademark dispute, delaying the case and avoiding questions about its right to the name.
leaflet-minimap
Advanced tools
A plugin for Leaflet that provides a minimap in the corner of the map view.
Leaflet.MiniMap is a simple minimap control that you can drop into your leaflet map, and it will create a small map in the corner which shows the same as the main map with a set zoom offset. (By default it is -5
.)
The control can be inserted in two lines: First you have to construct a layer for it to use, and then you create and attach the minimap control. Don't reuse the layer you added to the main map, strange behaviour will ensue! Alternatively, you can pass in a LayerGroup with multiple layers (for example with overlays or suitably themed markers). Marker layers can't be reused either. (See issue #52 for a discussion of synchronising marker layers.)
From the example:
var osm2 = new L.TileLayer(osmUrl, {minZoom: 0, maxZoom: 13, attribution: osmAttrib});
var miniMap = new L.Control.MiniMap(osm2).addTo(map);
As the minimap control inherits from leaflet's control, positioning is handled automatically by leaflet. However, you can still style the minimap and set its size by modifying the css file.
Note: Leaflet version 0.7.7 or higher is required, but the plugin has been tested and verified to work fine with Leaflet 1.0.0-beta2.
var MiniMap = require('leaflet-minimap');
new MiniMap(layer, options).addTo(map);
If you prefer ES6 style (for example with babel):
import MiniMap from 'leaflet-minimap';
new MiniMap(layer, options).addTo(map);
require(['leaflet-minimap'], function(MiniMap) {
new Minimap(layer, options).addTo(map);
});
changeLayer
: Swaps out the minimap layer for the one provided. See the layerchange example for hints on good uses.
The mini map uses options which can be set in the same way as other leaflet options, and these are the available options:
position
: The standard Leaflet.Control position parameter, used like all the other controls. Defaults to 'bottomright'.
width
: The width of the minimap in pixels. Defaults to 150.
height
: The height of the minimap in pixels. Defaults to 150.
collapsedWidth
: The width of the toggle marker and the minimap when collapsed, in pixels. Defaults to 19.
collapsedHeight
: The height of the toggle marker and the minimap when collapsed, in pixels. Defaults to 19.
zoomLevelOffset
: The offset applied to the zoom in the minimap compared to the zoom of the main map. Can be positive or negative, defaults to -5.
zoomLevelFixed
: Overrides the offset to apply a fixed zoom level to the minimap regardless of the main map zoom. Set it to any valid zoom level, if unset zoomLevelOffset
is used instead.
centerFixed
: Applies a fixed position to the minimap regardless of the main map's view / position. Prevents panning the minimap, but does allow zooming (both in the minimap and the main map). If the minimap is zoomed, it will always zoom around the centerFixed
point. You can pass in a LatLng-equivalent object. Defaults to false.
zoomAnimation
: Sets whether the minimap should have an animated zoom. (Will cause it to lag a bit after the movement of the main map.) Defaults to false.
toggleDisplay
: Sets whether the minimap should have a button to minimise it. Defaults to false.
autoToggleDisplay
: Sets whether the minimap should hide automatically if the parent map bounds does not fit within the minimap bounds. Especially useful when 'zoomLevelFixed' is set.
minimized
: Sets whether the minimap should start in a minimized position.
aimingRectOptions
: Sets the style of the aiming rectangle by passing in a Path.Options object. (Clickable will always be overridden and set to false.)
shadowRectOptions
: Sets the style of the aiming shadow rectangle by passing in a Path.Options object. (Clickable will always be overridden and set to false.)
strings
: Overrides the default strings allowing for translation. See below for available strings and example/example_i18n.html
for an example.
mapOptions
: Sets Leaflet options for the MiniMap map. It does not override the MiniMap default map options but extends them.
hideText
: The text to be displayed as Tooltip when hovering over the toggle button on the MiniMap and it is visible. Defaults to 'Hide MiniMap'
showText
: The text to be displayed as Tooltip when hovering over the toggle button on the MiniMap and it is hidden. Defaults to 'Show MiniMap'
The MiniMap fires minimize
, restore
events and toggle
for both.
First, install node.js on your system. Then run npm install
to get the dependencies, and npm build
to build
the minified js and css. Use npm test
to lint the code so you can check that it follows our
coding standard. (Any pull requests will be checked this way by the build server.)
FAQs
A plugin for Leaflet that provides a minimap in the corner of the map view.
The npm package leaflet-minimap receives a total of 3,504 weekly downloads. As such, leaflet-minimap popularity was classified as popular.
We found that leaflet-minimap demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Oracle seeks to dismiss fraud claims in the JavaScript trademark dispute, delaying the case and avoiding questions about its right to the name.
Security News
The Linux Foundation is warning open source developers that compliance with global sanctions is mandatory, highlighting legal risks and restrictions on contributions.
Security News
Maven Central now validates Sigstore signatures, making it easier for developers to verify the provenance of Java packages.