@drustack/leaflet.fullscreen
v1.0.3-alpha3.0
Published
A fullscreen control for Leaflet
Downloads
3
Maintainers
Readme
Leaflet.fullscreen
A HTML5 fullscreen plugin for Leaflet.
Usage
To provide a button for toggling fullscreen on and off:
// Create a new map with a fullscreen button:
var map = new L.Map('map', {
fullscreenControl: true,
// OR
fullscreenControl: {
pseudoFullscreen: false // if true, fullscreen to page width and height
}
});
// or, add to an existing map:
map.addControl(new L.Control.Fullscreen());
The plugin also adds several methods to L.Map
which are always available, even if you choose not to use the fullscreen button:
map.isFullscreen() // Is the map fullscreen?
map.toggleFullscreen() // Either go fullscreen, or cancel the existing fullscreen.
// `fullscreenchange` Event that's fired when entering or exiting fullscreen.
map.on('fullscreenchange', function () {
if (map.isFullscreen()) {
console.log('entered fullscreen');
} else {
console.log('exited fullscreen');
}
});
Localization
To change fullscreen control text:
map.addControl(new L.Control.Fullscreen({
title: {
'false': 'View Fullscreen',
'true': 'Exit Fullscreen'
}
}));
Including via CDN
Leaflet.fullscreen is available through the Mapbox Plugin CDN - just copy this include:
<script src='https://api.mapbox.com/mapbox.js/plugins/leaflet-fullscreen/v1.0.1/Leaflet.fullscreen.min.js'></script>
<link href='https://api.mapbox.com/mapbox.js/plugins/leaflet-fullscreen/v1.0.1/leaflet.fullscreen.css' rel='stylesheet' />
Building
npm install
npm run test
npm run uglifyjs
npm run sass
Supported Leaflet Versions
Leaflet 1.0 and later is supported. Earlier versions may work, but are not tested.
License
ISC
SVG icons from Font Awesome v5.15.4: Creative Commons Attribution 4.0