13860 lines
402 KiB
JavaScript
13860 lines
402 KiB
JavaScript
/* @preserve
|
|
* Leaflet 2.0.0-alpha.1, a JS library for interactive maps. https://leafletjs.com
|
|
* (c) 2010-2025 Volodymyr Agafonkin, (c) 2010-2011 CloudMade
|
|
*/
|
|
|
|
(function (global, factory) {
|
|
typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
|
|
typeof define === 'function' && define.amd ? define(['exports'], factory) :
|
|
(global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.leaflet = {}));
|
|
})(this, (function (exports) { 'use strict';
|
|
|
|
/*
|
|
* @namespace Util
|
|
*
|
|
* Various utility functions, used by Leaflet internally.
|
|
*/
|
|
|
|
// @property lastId: Number
|
|
// Last unique ID used by [`stamp()`](#util-stamp)
|
|
let lastId = 0;
|
|
|
|
// @function stamp(obj: Object): Number
|
|
// Returns the unique ID of an object, assigning it one if it doesn't have it.
|
|
function stamp(obj) {
|
|
if (!('_leaflet_id' in obj)) {
|
|
obj['_leaflet_id'] = ++lastId;
|
|
}
|
|
return obj._leaflet_id;
|
|
}
|
|
|
|
// @function throttle(fn: Function, time: Number, context: Object): Function
|
|
// Returns a function which executes function `fn` with the given scope `context`
|
|
// (so that the `this` keyword refers to `context` inside `fn`'s code). The function
|
|
// `fn` will be called no more than one time per given amount of `time`. The arguments
|
|
// received by the bound function will be any arguments passed when binding the
|
|
// function, followed by any arguments passed when invoking the bound function.
|
|
function throttle(fn, time, context) {
|
|
let lock, queuedArgs;
|
|
|
|
function later() {
|
|
// reset lock and call if queued
|
|
lock = false;
|
|
if (queuedArgs) {
|
|
wrapperFn.apply(context, queuedArgs);
|
|
queuedArgs = false;
|
|
}
|
|
}
|
|
|
|
function wrapperFn(...args) {
|
|
if (lock) {
|
|
// called too soon, queue to call later
|
|
queuedArgs = args;
|
|
|
|
} else {
|
|
// call and lock until later
|
|
fn.apply(context, args);
|
|
setTimeout(later, time);
|
|
lock = true;
|
|
}
|
|
}
|
|
|
|
return wrapperFn;
|
|
}
|
|
|
|
// @function wrapNum(num: Number, range: Number[], includeMax?: Boolean): Number
|
|
// Returns the number `num` modulo `range` in such a way so it lies within
|
|
// `range[0]` and `range[1]`. The returned value will be always smaller than
|
|
// `range[1]` unless `includeMax` is set to `true`.
|
|
function wrapNum(x, range, includeMax) {
|
|
const max = range[1],
|
|
min = range[0],
|
|
d = max - min;
|
|
return x === max && includeMax ? x : ((x - min) % d + d) % d + min;
|
|
}
|
|
|
|
// @function falseFn(): Function
|
|
// Returns a function which always returns `false`.
|
|
function falseFn() { return false; }
|
|
|
|
// @function formatNum(num: Number, precision?: Number|false): Number
|
|
// Returns the number `num` rounded with specified `precision`.
|
|
// The default `precision` value is 6 decimal places.
|
|
// `false` can be passed to skip any processing (can be useful to avoid round-off errors).
|
|
function formatNum(num, precision) {
|
|
if (precision === false) { return num; }
|
|
const pow = 10 ** (precision === undefined ? 6 : precision);
|
|
return Math.round(num * pow) / pow;
|
|
}
|
|
|
|
// @function splitWords(str: String): String[]
|
|
// Trims and splits the string on whitespace and returns the array of parts.
|
|
function splitWords(str) {
|
|
return str.trim().split(/\s+/);
|
|
}
|
|
|
|
// @function setOptions(obj: Object, options: Object): Object
|
|
// Merges the given properties to the `options` of the `obj` object, returning the resulting options. See `Class options`.
|
|
function setOptions(obj, options) {
|
|
if (!Object.hasOwn(obj, 'options')) {
|
|
obj.options = obj.options ? Object.create(obj.options) : {};
|
|
}
|
|
for (const i in options) {
|
|
if (Object.hasOwn(options, i)) {
|
|
obj.options[i] = options[i];
|
|
}
|
|
}
|
|
return obj.options;
|
|
}
|
|
|
|
const templateRe = /\{ *([\w_ -]+) *\}/g;
|
|
|
|
// @function template(str: String, data: Object): String
|
|
// Simple templating facility, accepts a template string of the form `'Hello {a}, {b}'`
|
|
// and a data object like `{a: 'foo', b: 'bar'}`, returns evaluated string
|
|
// `('Hello foo, bar')`. You can also specify functions instead of strings for
|
|
// data values — they will be evaluated passing `data` as an argument.
|
|
function template(str, data) {
|
|
return str.replace(templateRe, (str, key) => {
|
|
let value = data[key];
|
|
|
|
if (value === undefined) {
|
|
throw new Error(`No value provided for variable ${str}`);
|
|
|
|
} else if (typeof value === 'function') {
|
|
value = value(data);
|
|
}
|
|
return value;
|
|
});
|
|
}
|
|
|
|
// @property emptyImageUrl: String
|
|
// Data URI string containing a base64-encoded empty GIF image.
|
|
// Used as a hack to free memory from unused images on WebKit-powered
|
|
// mobile devices (by setting image `src` to this string).
|
|
const emptyImageUrl = 'data:image/gif;base64,R0lGODlhAQABAAD/ACwAAAAAAQABAAACADs=';
|
|
|
|
var Util = {
|
|
__proto__: null,
|
|
emptyImageUrl: emptyImageUrl,
|
|
falseFn: falseFn,
|
|
formatNum: formatNum,
|
|
get lastId () { return lastId; },
|
|
setOptions: setOptions,
|
|
splitWords: splitWords,
|
|
stamp: stamp,
|
|
template: template,
|
|
throttle: throttle,
|
|
wrapNum: wrapNum
|
|
};
|
|
|
|
// @class Class
|
|
|
|
// @section
|
|
// @uninheritable
|
|
|
|
// Thanks to John Resig and Dean Edwards for inspiration!
|
|
|
|
class Class {
|
|
// @function extend(props: Object): Function
|
|
// [Extends the current class](#class-inheritance) given the properties to be included.
|
|
// Deprecated - use `class X extends Class` instead!
|
|
// Returns a Javascript function that is a class constructor (to be called with `new`).
|
|
static extend({statics, includes, ...props}) {
|
|
const NewClass = class extends this {};
|
|
|
|
// inherit parent's static properties
|
|
Object.setPrototypeOf(NewClass, this);
|
|
|
|
const parentProto = this.prototype;
|
|
const proto = NewClass.prototype;
|
|
|
|
// mix static properties into the class
|
|
if (statics) {
|
|
Object.assign(NewClass, statics);
|
|
}
|
|
|
|
// mix includes into the prototype
|
|
if (Array.isArray(includes)) {
|
|
for (const include of includes) {
|
|
Object.assign(proto, include);
|
|
}
|
|
} else if (includes) {
|
|
Object.assign(proto, includes);
|
|
}
|
|
|
|
// mix given properties into the prototype
|
|
Object.assign(proto, props);
|
|
|
|
// merge options
|
|
if (proto.options) {
|
|
proto.options = parentProto.options ? Object.create(parentProto.options) : {};
|
|
Object.assign(proto.options, props.options);
|
|
}
|
|
|
|
proto._initHooks = [];
|
|
|
|
return NewClass;
|
|
}
|
|
|
|
// @function include(properties: Object): this
|
|
// [Includes a mixin](#class-includes) into the current class.
|
|
static include(props) {
|
|
const parentOptions = this.prototype.options;
|
|
Object.assign(this.prototype, props);
|
|
if (props.options) {
|
|
this.prototype.options = parentOptions;
|
|
this.mergeOptions(props.options);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @function setDefaultOptions(options: Object): this
|
|
// Configures the [default `options`](#class-options) on the prototype of this class.
|
|
static setDefaultOptions(options) {
|
|
setOptions(this.prototype, options);
|
|
return this;
|
|
}
|
|
|
|
// @function mergeOptions(options: Object): this
|
|
// [Merges `options`](#class-options) into the defaults of the class.
|
|
static mergeOptions(options) {
|
|
this.prototype.options ??= {};
|
|
Object.assign(this.prototype.options, options);
|
|
return this;
|
|
}
|
|
|
|
// @function addInitHook(fn: Function): this
|
|
// Adds a [constructor hook](#class-constructor-hooks) to the class.
|
|
static addInitHook(fn, ...args) { // (Function) || (String, args...)
|
|
const init = typeof fn === 'function' ? fn : function () {
|
|
this[fn].apply(this, args);
|
|
};
|
|
|
|
this.prototype._initHooks ??= [];
|
|
this.prototype._initHooks.push(init);
|
|
return this;
|
|
}
|
|
|
|
constructor(...args) {
|
|
this._initHooksCalled = false;
|
|
|
|
setOptions(this);
|
|
|
|
// call the constructor
|
|
if (this.initialize) {
|
|
this.initialize(...args);
|
|
}
|
|
|
|
// call all constructor hooks
|
|
this.callInitHooks();
|
|
}
|
|
|
|
initialize(/* ...args */) {
|
|
// Override this method in subclasses to implement custom initialization logic.
|
|
// This method is called automatically when a new instance of the class is created.
|
|
}
|
|
|
|
callInitHooks() {
|
|
if (this._initHooksCalled) {
|
|
return;
|
|
}
|
|
|
|
// collect all prototypes in chain
|
|
const prototypes = [];
|
|
let current = this;
|
|
|
|
while ((current = Object.getPrototypeOf(current)) !== null) {
|
|
prototypes.push(current);
|
|
}
|
|
|
|
// reverse so the parent prototype is first
|
|
prototypes.reverse();
|
|
|
|
// call init hooks on each prototype
|
|
for (const proto of prototypes) {
|
|
for (const hook of proto._initHooks ?? []) {
|
|
hook.call(this);
|
|
}
|
|
}
|
|
|
|
this._initHooksCalled = true;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class Evented
|
|
* @inherits Class
|
|
*
|
|
* A set of methods shared between event-powered classes (like `Map` and `Marker`). Generally, events allow you to execute some function when something happens with an object (e.g. the user clicks on the map, causing the map to fire `'click'` event).
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* map.on('click', function(e) {
|
|
* alert(e.latlng);
|
|
* } );
|
|
* ```
|
|
*
|
|
* Leaflet deals with event listeners by reference, so if you want to add a listener and then remove it, define it as a function:
|
|
*
|
|
* ```js
|
|
* function onClick(e) { ... }
|
|
*
|
|
* map.on('click', onClick);
|
|
* map.off('click', onClick);
|
|
* ```
|
|
*/
|
|
|
|
class Evented extends Class {
|
|
/* @method on(type: String, fn: Function, context?: Object): this
|
|
* Adds a listener function (`fn`) to a particular event type of the object. You can optionally specify the context of the listener (object the this keyword will point to). You can also pass several space-separated types (e.g. `'click dblclick'`).
|
|
*
|
|
* @alternative
|
|
* @method on(eventMap: Object): this
|
|
* Adds a set of type/listener pairs, e.g. `{click: onClick, pointermove: onPointerMove}`
|
|
*/
|
|
on(types, fn, context) {
|
|
|
|
// types can be a map of types/handlers
|
|
if (typeof types === 'object') {
|
|
for (const [type, f] of Object.entries(types)) {
|
|
// we don't process space-separated events here for performance;
|
|
// it's a hot path since Layer uses the on(obj) syntax
|
|
this._on(type, f, fn);
|
|
}
|
|
|
|
} else {
|
|
// types can be a string of space-separated words
|
|
for (const type of splitWords(types)) {
|
|
this._on(type, fn, context);
|
|
}
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/* @method off(type: String, fn?: Function, context?: Object): this
|
|
* Removes a previously added listener function. If no function is specified, it will remove all the listeners of that particular event from the object. Note that if you passed a custom context to `on`, you must pass the same context to `off` in order to remove the listener.
|
|
*
|
|
* @alternative
|
|
* @method off(eventMap: Object): this
|
|
* Removes a set of type/listener pairs.
|
|
*
|
|
* @alternative
|
|
* @method off: this
|
|
* Removes all listeners to all events on the object. This includes implicitly attached events.
|
|
*/
|
|
off(types, fn, context) {
|
|
|
|
if (!arguments.length) {
|
|
// clear all listeners if called without arguments
|
|
delete this._events;
|
|
|
|
} else if (typeof types === 'object') {
|
|
for (const [type, f] of Object.entries(types)) {
|
|
this._off(type, f, fn);
|
|
}
|
|
|
|
} else {
|
|
const removeAll = arguments.length === 1;
|
|
for (const type of splitWords(types)) {
|
|
if (removeAll) {
|
|
this._off(type);
|
|
} else {
|
|
this._off(type, fn, context);
|
|
}
|
|
}
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
// attach listener (without syntactic sugar now)
|
|
_on(type, fn, context, _once) {
|
|
if (typeof fn !== 'function') {
|
|
console.warn(`wrong listener type: ${typeof fn}`);
|
|
return;
|
|
}
|
|
|
|
// check if fn already there
|
|
if (this._listens(type, fn, context) !== false) {
|
|
return;
|
|
}
|
|
|
|
if (context === this) {
|
|
// Less memory footprint.
|
|
context = undefined;
|
|
}
|
|
|
|
const newListener = {fn, ctx: context};
|
|
if (_once) {
|
|
newListener.once = true;
|
|
}
|
|
|
|
this._events ??= {};
|
|
this._events[type] ??= [];
|
|
this._events[type].push(newListener);
|
|
}
|
|
|
|
_off(type, fn, context) {
|
|
if (!this._events) {
|
|
return;
|
|
}
|
|
|
|
let listeners = this._events[type];
|
|
if (!listeners) {
|
|
return;
|
|
}
|
|
|
|
if (arguments.length === 1) { // remove all
|
|
if (this._firingCount) {
|
|
// Set all removed listeners to noop
|
|
// so they are not called if remove happens in fire
|
|
for (const listener of listeners) {
|
|
listener.fn = falseFn;
|
|
}
|
|
}
|
|
// clear all listeners for a type if function isn't specified
|
|
delete this._events[type];
|
|
return;
|
|
}
|
|
|
|
if (typeof fn !== 'function') {
|
|
console.warn(`wrong listener type: ${typeof fn}`);
|
|
return;
|
|
}
|
|
|
|
// find fn and remove it
|
|
const index = this._listens(type, fn, context);
|
|
if (index !== false) {
|
|
const listener = listeners[index];
|
|
if (this._firingCount) {
|
|
// set the removed listener to noop so that's not called if remove happens in fire
|
|
listener.fn = falseFn;
|
|
|
|
/* copy array in case events are being fired */
|
|
this._events[type] = listeners = listeners.slice();
|
|
}
|
|
listeners.splice(index, 1);
|
|
}
|
|
}
|
|
|
|
// @method fire(type: String, data?: Object, propagate?: Boolean): this
|
|
// Fires an event of the specified type. You can optionally provide a data
|
|
// object — the first argument of the listener function will contain its
|
|
// properties. The event can optionally be propagated to event parents.
|
|
fire(type, data, propagate) {
|
|
if (!this.listens(type, propagate)) { return this; }
|
|
|
|
const event = {
|
|
...data,
|
|
type,
|
|
target: this,
|
|
sourceTarget: data?.sourceTarget || this
|
|
};
|
|
|
|
if (this._events) {
|
|
const listeners = this._events[type];
|
|
if (listeners) {
|
|
this._firingCount = (this._firingCount + 1) || 1;
|
|
for (const l of listeners) {
|
|
// off overwrites l.fn, so we need to copy fn to a variable
|
|
const fn = l.fn;
|
|
if (l.once) {
|
|
this.off(type, fn, l.ctx);
|
|
}
|
|
fn.call(l.ctx || this, event);
|
|
}
|
|
|
|
this._firingCount--;
|
|
}
|
|
}
|
|
|
|
if (propagate) {
|
|
// propagate the event to parents (set with addEventParent)
|
|
this._propagateEvent(event);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method listens(type: String, propagate?: Boolean): Boolean
|
|
// @method listens(type: String, fn: Function, context?: Object, propagate?: Boolean): Boolean
|
|
// Returns `true` if a particular event type has any listeners attached to it.
|
|
// The verification can optionally be propagated, it will return `true` if parents have the listener attached to it.
|
|
listens(type, fn, context, propagate) {
|
|
if (typeof type !== 'string') {
|
|
console.warn('"string" type argument expected');
|
|
}
|
|
|
|
// we don't overwrite the input `fn` value, because we need to use it for propagation
|
|
let _fn = fn;
|
|
if (typeof fn !== 'function') {
|
|
propagate = !!fn;
|
|
_fn = undefined;
|
|
context = undefined;
|
|
}
|
|
|
|
if (this._events?.[type]?.length) {
|
|
if (this._listens(type, _fn, context) !== false) {
|
|
return true;
|
|
}
|
|
}
|
|
|
|
if (propagate) {
|
|
// also check parents for listeners if event propagates
|
|
for (const p of Object.values(this._eventParents ?? {})) {
|
|
if (p.listens(type, fn, context, propagate)) {
|
|
return true;
|
|
}
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
|
|
// returns the index (number) or false
|
|
_listens(type, fn, context) {
|
|
if (!this._events) {
|
|
return false;
|
|
}
|
|
|
|
const listeners = this._events[type] ?? [];
|
|
if (!fn) {
|
|
return !!listeners.length;
|
|
}
|
|
|
|
if (context === this) {
|
|
// Less memory footprint.
|
|
context = undefined;
|
|
}
|
|
|
|
const index = listeners.findIndex(l => l.fn === fn && l.ctx === context);
|
|
return index === -1 ? false : index;
|
|
|
|
}
|
|
|
|
// @method once(…): this
|
|
// Behaves as [`on(…)`](#evented-on), except the listener will only get fired once and then removed.
|
|
once(types, fn, context) {
|
|
|
|
// types can be a map of types/handlers
|
|
if (typeof types === 'object') {
|
|
for (const [type, f] of Object.entries(types)) {
|
|
// we don't process space-separated events here for performance;
|
|
// it's a hot path since Layer uses the on(obj) syntax
|
|
this._on(type, f, fn, true);
|
|
}
|
|
|
|
} else {
|
|
// types can be a string of space-separated words
|
|
for (const type of splitWords(types)) {
|
|
this._on(type, fn, context, true);
|
|
}
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method addEventParent(obj: Evented): this
|
|
// Adds an event parent - an `Evented` that will receive propagated events
|
|
addEventParent(obj) {
|
|
this._eventParents ??= {};
|
|
this._eventParents[stamp(obj)] = obj;
|
|
return this;
|
|
}
|
|
|
|
// @method removeEventParent(obj: Evented): this
|
|
// Removes an event parent, so it will stop receiving propagated events
|
|
removeEventParent(obj) {
|
|
if (this._eventParents) {
|
|
delete this._eventParents[stamp(obj)];
|
|
}
|
|
return this;
|
|
}
|
|
|
|
_propagateEvent(e) {
|
|
for (const p of Object.values(this._eventParents ?? {})) {
|
|
p.fire(e.type, {
|
|
propagatedFrom: e.target,
|
|
...e
|
|
}, true);
|
|
}
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class Point
|
|
*
|
|
* Represents a point with `x` and `y` coordinates in pixels.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* const point = new Point(200, 300);
|
|
* ```
|
|
*
|
|
* All Leaflet methods and options that accept `Point` objects also accept them in a simple Array form (unless noted otherwise), so these lines are equivalent:
|
|
*
|
|
* ```js
|
|
* map.panBy([200, 300]);
|
|
* map.panBy(new Point(200, 300));
|
|
* ```
|
|
*
|
|
* Note that `Point` does not inherit from Leaflet's `Class` object,
|
|
* which means new classes can't inherit from it, and new methods
|
|
* can't be added to it with the `include` function.
|
|
*/
|
|
|
|
// @constructor Point(x: Number, y: Number, round?: Boolean)
|
|
// Creates a Point object with the given `x` and `y` coordinates. If optional `round` is set to true, rounds the `x` and `y` values.
|
|
|
|
// @alternative
|
|
// @constructor Point(coords: Number[])
|
|
// Expects an array of the form `[x, y]` instead.
|
|
|
|
// @alternative
|
|
// @constructor Point(coords: Object)
|
|
// Expects a plain object of the form `{x: Number, y: Number}` instead.
|
|
class Point {
|
|
constructor(x, y, round) {
|
|
|
|
const valid = Point.validate(x, y);
|
|
if (!valid) {
|
|
throw new Error(`Invalid Point object: (${x}, ${y})`);
|
|
}
|
|
|
|
let _x, _y;
|
|
if (x instanceof Point) {
|
|
// We can use the same object, no need to clone it
|
|
// eslint-disable-next-line no-constructor-return
|
|
return x;
|
|
} else if (Array.isArray(x)) {
|
|
_x = x[0];
|
|
_y = x[1];
|
|
} else if (typeof x === 'object' && 'x' in x && 'y' in x) {
|
|
_x = x.x;
|
|
_y = x.y;
|
|
} else {
|
|
_x = x;
|
|
_y = y;
|
|
}
|
|
|
|
// @property x: Number; The `x` coordinate of the point
|
|
this.x = (round ? Math.round(_x) : _x);
|
|
// @property y: Number; The `y` coordinate of the point
|
|
this.y = (round ? Math.round(_y) : _y);
|
|
}
|
|
|
|
// @section
|
|
// There are several static functions which can be called without instantiating Point:
|
|
|
|
// @function validate(x: Number, y: Number): Boolean
|
|
// Returns `true` if the Point object can be properly initialized.
|
|
|
|
// @alternative
|
|
// @function validate(coords: Number[]): Boolean
|
|
// Expects an array of the form `[x, y]`. Returns `true` if the Point object can be properly initialized.
|
|
|
|
// @alternative
|
|
// @function validate(coords: Object): Boolean
|
|
// Returns `true` if the Point object can be properly initialized.
|
|
static validate(x, y) {
|
|
if (x instanceof Point || Array.isArray(x)) {
|
|
return true;
|
|
} else if (x && typeof x === 'object' && 'x' in x && 'y' in x) {
|
|
return true;
|
|
} else if ((x || x === 0) && (y || y === 0)) {
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
// @method clone(): Point
|
|
// Returns a copy of the current point.
|
|
clone() {
|
|
// to skip the validation in the constructor we need to initialize with 0 and then set the values later
|
|
const p = new Point(0, 0);
|
|
p.x = this.x;
|
|
p.y = this.y;
|
|
return p;
|
|
}
|
|
|
|
// @method add(otherPoint: Point): Point
|
|
// Returns the result of addition of the current and the given points.
|
|
add(point) {
|
|
// non-destructive, returns a new point
|
|
return this.clone()._add(new Point(point));
|
|
}
|
|
|
|
_add(point) {
|
|
// destructive, used directly for performance in situations where it's safe to modify existing point
|
|
this.x += point.x;
|
|
this.y += point.y;
|
|
return this;
|
|
}
|
|
|
|
// @method subtract(otherPoint: Point): Point
|
|
// Returns the result of subtraction of the given point from the current.
|
|
subtract(point) {
|
|
return this.clone()._subtract(new Point(point));
|
|
}
|
|
|
|
_subtract(point) {
|
|
this.x -= point.x;
|
|
this.y -= point.y;
|
|
return this;
|
|
}
|
|
|
|
// @method divideBy(num: Number): Point
|
|
// Returns the result of division of the current point by the given number.
|
|
divideBy(num) {
|
|
return this.clone()._divideBy(num);
|
|
}
|
|
|
|
_divideBy(num) {
|
|
this.x /= num;
|
|
this.y /= num;
|
|
return this;
|
|
}
|
|
|
|
// @method multiplyBy(num: Number): Point
|
|
// Returns the result of multiplication of the current point by the given number.
|
|
multiplyBy(num) {
|
|
return this.clone()._multiplyBy(num);
|
|
}
|
|
|
|
_multiplyBy(num) {
|
|
this.x *= num;
|
|
this.y *= num;
|
|
return this;
|
|
}
|
|
|
|
// @method scaleBy(scale: Point): Point
|
|
// Multiply each coordinate of the current point by each coordinate of
|
|
// `scale`. In linear algebra terms, multiply the point by the
|
|
// [scaling matrix](https://en.wikipedia.org/wiki/Scaling_%28geometry%29#Matrix_representation)
|
|
// defined by `scale`.
|
|
scaleBy(point) {
|
|
return new Point(this.x * point.x, this.y * point.y);
|
|
}
|
|
|
|
// @method unscaleBy(scale: Point): Point
|
|
// Inverse of `scaleBy`. Divide each coordinate of the current point by
|
|
// each coordinate of `scale`.
|
|
unscaleBy(point) {
|
|
return new Point(this.x / point.x, this.y / point.y);
|
|
}
|
|
|
|
// Returns a copy of the current point with rounded coordinates.
|
|
round() {
|
|
return this.clone()._round();
|
|
}
|
|
|
|
_round() {
|
|
this.x = Math.round(this.x);
|
|
this.y = Math.round(this.y);
|
|
return this;
|
|
}
|
|
|
|
// @method floor(): Point
|
|
// Returns a copy of the current point with floored coordinates (rounded down).
|
|
floor() {
|
|
return this.clone()._floor();
|
|
}
|
|
|
|
_floor() {
|
|
this.x = Math.floor(this.x);
|
|
this.y = Math.floor(this.y);
|
|
return this;
|
|
}
|
|
|
|
// @method ceil(): Point
|
|
// Returns a copy of the current point with ceiled coordinates (rounded up).
|
|
ceil() {
|
|
return this.clone()._ceil();
|
|
}
|
|
|
|
_ceil() {
|
|
this.x = Math.ceil(this.x);
|
|
this.y = Math.ceil(this.y);
|
|
return this;
|
|
}
|
|
|
|
// Returns a copy of the current point with truncated coordinates (rounded towards zero).
|
|
trunc() {
|
|
return this.clone()._trunc();
|
|
}
|
|
|
|
_trunc() {
|
|
this.x = Math.trunc(this.x);
|
|
this.y = Math.trunc(this.y);
|
|
return this;
|
|
}
|
|
|
|
// @method distanceTo(otherPoint: Point): Number
|
|
// Returns the cartesian distance between the current and the given points.
|
|
distanceTo(point) {
|
|
point = new Point(point);
|
|
|
|
const x = point.x - this.x,
|
|
y = point.y - this.y;
|
|
|
|
return Math.sqrt(x * x + y * y);
|
|
}
|
|
|
|
// @method equals(otherPoint: Point): Boolean
|
|
// Returns `true` if the given point has the same coordinates.
|
|
equals(point) {
|
|
point = new Point(point);
|
|
|
|
return point.x === this.x &&
|
|
point.y === this.y;
|
|
}
|
|
|
|
// @method contains(otherPoint: Point): Boolean
|
|
// Returns `true` if both coordinates of the given point are less than the corresponding current point coordinates (in absolute values).
|
|
contains(point) {
|
|
point = new Point(point);
|
|
|
|
return Math.abs(point.x) <= Math.abs(this.x) &&
|
|
Math.abs(point.y) <= Math.abs(this.y);
|
|
}
|
|
|
|
// @method toString(): String
|
|
// Returns a string representation of the point for debugging purposes.
|
|
toString() {
|
|
return `Point(${formatNum(this.x)}, ${formatNum(this.y)})`;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class Bounds
|
|
*
|
|
* Represents a rectangular area in pixel coordinates.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* const p1 = new Point(10, 10),
|
|
* p2 = new Point(40, 60),
|
|
* bounds = new Bounds(p1, p2);
|
|
* ```
|
|
*
|
|
* All Leaflet methods that accept `Bounds` objects also accept them in a simple Array form (unless noted otherwise), so the bounds example above can be passed like this:
|
|
*
|
|
* ```js
|
|
* otherBounds.intersects([[10, 10], [40, 60]]);
|
|
* ```
|
|
*
|
|
* Note that `Bounds` does not inherit from Leaflet's `Class` object,
|
|
* which means new classes can't inherit from it, and new methods
|
|
* can't be added to it with the `include` function.
|
|
*/
|
|
|
|
|
|
// @constructor Bounds(corner1: Point, corner2: Point)
|
|
// Creates a Bounds object from two corners coordinate pairs.
|
|
// @alternative
|
|
// @constructor Bounds(points: Point[])
|
|
// Creates a Bounds object from the given array of points.
|
|
class Bounds {
|
|
constructor(a, b) {
|
|
if (!a) { return; }
|
|
|
|
if (a instanceof Bounds) {
|
|
// We can use the same object, no need to clone it
|
|
// eslint-disable-next-line no-constructor-return
|
|
return a;
|
|
}
|
|
|
|
const points = b ? [a, b] : a;
|
|
for (const point of points) {
|
|
this.extend(point);
|
|
}
|
|
}
|
|
|
|
// @method extend(point: Point): this
|
|
// Extends the bounds to contain the given point.
|
|
|
|
// @alternative
|
|
// @method extend(otherBounds: Bounds): this
|
|
// Extend the bounds to contain the given bounds
|
|
extend(obj) {
|
|
let min2, max2;
|
|
if (!obj) { return this; }
|
|
|
|
if (obj instanceof Point || typeof obj[0] === 'number' || 'x' in obj) {
|
|
min2 = max2 = new Point(obj);
|
|
} else {
|
|
obj = new Bounds(obj);
|
|
min2 = obj.min;
|
|
max2 = obj.max;
|
|
|
|
if (!min2 || !max2) { return this; }
|
|
}
|
|
|
|
// @property min: Point
|
|
// The top left corner of the rectangle.
|
|
// @property max: Point
|
|
// The bottom right corner of the rectangle.
|
|
if (!this.min && !this.max) {
|
|
this.min = min2.clone();
|
|
this.max = max2.clone();
|
|
} else {
|
|
this.min.x = Math.min(min2.x, this.min.x);
|
|
this.max.x = Math.max(max2.x, this.max.x);
|
|
this.min.y = Math.min(min2.y, this.min.y);
|
|
this.max.y = Math.max(max2.y, this.max.y);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method getCenter(round?: Boolean): Point
|
|
// Returns the center point of the bounds.
|
|
getCenter(round) {
|
|
return new Point(
|
|
(this.min.x + this.max.x) / 2,
|
|
(this.min.y + this.max.y) / 2, round);
|
|
}
|
|
|
|
// @method getBottomLeft(): Point
|
|
// Returns the bottom-left point of the bounds.
|
|
getBottomLeft() {
|
|
return new Point(this.min.x, this.max.y);
|
|
}
|
|
|
|
// @method getTopRight(): Point
|
|
// Returns the top-right point of the bounds.
|
|
getTopRight() { // -> Point
|
|
return new Point(this.max.x, this.min.y);
|
|
}
|
|
|
|
// @method getTopLeft(): Point
|
|
// Returns the top-left point of the bounds (i.e. [`this.min`](#bounds-min)).
|
|
getTopLeft() {
|
|
return this.min; // left, top
|
|
}
|
|
|
|
// @method getBottomRight(): Point
|
|
// Returns the bottom-right point of the bounds (i.e. [`this.max`](#bounds-max)).
|
|
getBottomRight() {
|
|
return this.max; // right, bottom
|
|
}
|
|
|
|
// @method getSize(): Point
|
|
// Returns the size of the given bounds
|
|
getSize() {
|
|
return this.max.subtract(this.min);
|
|
}
|
|
|
|
// @method contains(otherBounds: Bounds): Boolean
|
|
// Returns `true` if the rectangle contains the given one.
|
|
// @alternative
|
|
// @method contains(point: Point): Boolean
|
|
// Returns `true` if the rectangle contains the given point.
|
|
contains(obj) {
|
|
let min, max;
|
|
|
|
if (typeof obj[0] === 'number' || obj instanceof Point) {
|
|
obj = new Point(obj);
|
|
} else {
|
|
obj = new Bounds(obj);
|
|
}
|
|
|
|
if (obj instanceof Bounds) {
|
|
min = obj.min;
|
|
max = obj.max;
|
|
} else {
|
|
min = max = obj;
|
|
}
|
|
|
|
return (min.x >= this.min.x) &&
|
|
(max.x <= this.max.x) &&
|
|
(min.y >= this.min.y) &&
|
|
(max.y <= this.max.y);
|
|
}
|
|
|
|
// @method intersects(otherBounds: Bounds): Boolean
|
|
// Returns `true` if the rectangle intersects the given bounds. Two bounds
|
|
// intersect if they have at least one point in common.
|
|
intersects(bounds) { // (Bounds) -> Boolean
|
|
bounds = new Bounds(bounds);
|
|
|
|
const min = this.min,
|
|
max = this.max,
|
|
min2 = bounds.min,
|
|
max2 = bounds.max,
|
|
xIntersects = (max2.x >= min.x) && (min2.x <= max.x),
|
|
yIntersects = (max2.y >= min.y) && (min2.y <= max.y);
|
|
|
|
return xIntersects && yIntersects;
|
|
}
|
|
|
|
// @method overlaps(otherBounds: Bounds): Boolean
|
|
// Returns `true` if the rectangle overlaps the given bounds. Two bounds
|
|
// overlap if their intersection is an area.
|
|
overlaps(bounds) { // (Bounds) -> Boolean
|
|
bounds = new Bounds(bounds);
|
|
|
|
const min = this.min,
|
|
max = this.max,
|
|
min2 = bounds.min,
|
|
max2 = bounds.max,
|
|
xOverlaps = (max2.x > min.x) && (min2.x < max.x),
|
|
yOverlaps = (max2.y > min.y) && (min2.y < max.y);
|
|
|
|
return xOverlaps && yOverlaps;
|
|
}
|
|
|
|
// @method isValid(): Boolean
|
|
// Returns `true` if the bounds are properly initialized.
|
|
isValid() {
|
|
return !!(this.min && this.max);
|
|
}
|
|
|
|
|
|
// @method pad(bufferRatio: Number): Bounds
|
|
// Returns bounds created by extending or retracting the current bounds by a given ratio in each direction.
|
|
// For example, a ratio of 0.5 extends the bounds by 50% in each direction.
|
|
// Negative values will retract the bounds.
|
|
pad(bufferRatio) {
|
|
const min = this.min,
|
|
max = this.max,
|
|
heightBuffer = Math.abs(min.x - max.x) * bufferRatio,
|
|
widthBuffer = Math.abs(min.y - max.y) * bufferRatio;
|
|
|
|
|
|
return new Bounds(
|
|
new Point(min.x - heightBuffer, min.y - widthBuffer),
|
|
new Point(max.x + heightBuffer, max.y + widthBuffer));
|
|
}
|
|
|
|
|
|
// @method equals(otherBounds: Bounds): Boolean
|
|
// Returns `true` if the rectangle is equivalent to the given bounds.
|
|
equals(bounds) {
|
|
if (!bounds) { return false; }
|
|
|
|
bounds = new Bounds(bounds);
|
|
|
|
return this.min.equals(bounds.getTopLeft()) &&
|
|
this.max.equals(bounds.getBottomRight());
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class LatLngBounds
|
|
*
|
|
* Represents a rectangular geographical area on a map.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* const corner1 = new LatLng(40.712, -74.227),
|
|
* corner2 = new LatLng(40.774, -74.125),
|
|
* bounds = new LatLngBounds(corner1, corner2);
|
|
* ```
|
|
*
|
|
* All Leaflet methods that accept LatLngBounds objects also accept them in a simple Array form (unless noted otherwise), so the bounds example above can be passed like this:
|
|
*
|
|
* ```js
|
|
* map.fitBounds([
|
|
* [40.712, -74.227],
|
|
* [40.774, -74.125]
|
|
* ]);
|
|
* ```
|
|
*
|
|
* Caution: if the area crosses the antimeridian (often confused with the International Date Line), you must specify corners _outside_ the [-180, 180] degrees longitude range.
|
|
*
|
|
* Note that `LatLngBounds` does not inherit from Leaflet's `Class` object,
|
|
* which means new classes can't inherit from it, and new methods
|
|
* can't be added to it with the `include` function.
|
|
*/
|
|
|
|
// TODO International date line?
|
|
|
|
// @constructor LatLngBounds(corner1: LatLng, corner2: LatLng)
|
|
// Creates a `LatLngBounds` object by defining two diagonally opposite corners of the rectangle.
|
|
|
|
// @alternative
|
|
// @constructor LatLngBounds(latlngs: LatLng[])
|
|
// Creates a `LatLngBounds` object defined by the geographical points it contains. Very useful for zooming the map to fit a particular set of locations with [`fitBounds`](#map-fitbounds).
|
|
class LatLngBounds {
|
|
constructor(corner1, corner2) { // (LatLng, LatLng) or (LatLng[])
|
|
if (!corner1) { return; }
|
|
|
|
if (corner1 instanceof LatLngBounds) {
|
|
// We can use the same object, no need to clone it
|
|
// eslint-disable-next-line no-constructor-return
|
|
return corner1;
|
|
}
|
|
|
|
const latlngs = corner2 ? [corner1, corner2] : corner1;
|
|
|
|
for (const latlng of latlngs) {
|
|
this.extend(latlng);
|
|
}
|
|
}
|
|
|
|
// @method extend(latlng: LatLng): this
|
|
// Extend the bounds to contain the given point
|
|
|
|
// @alternative
|
|
// @method extend(otherBounds: LatLngBounds): this
|
|
// Extend the bounds to contain the given bounds
|
|
extend(obj) {
|
|
const sw = this._southWest,
|
|
ne = this._northEast;
|
|
let sw2, ne2;
|
|
|
|
if (obj instanceof LatLng) {
|
|
sw2 = obj;
|
|
ne2 = obj;
|
|
|
|
} else if (obj instanceof LatLngBounds) {
|
|
sw2 = obj._southWest;
|
|
ne2 = obj._northEast;
|
|
|
|
if (!sw2 || !ne2) { return this; }
|
|
|
|
} else {
|
|
if (!obj) {
|
|
return this;
|
|
}
|
|
if (LatLng.validate(obj)) {
|
|
return this.extend(new LatLng(obj));
|
|
}
|
|
return this.extend(new LatLngBounds(obj));
|
|
}
|
|
|
|
if (!sw && !ne) {
|
|
this._southWest = new LatLng(sw2.lat, sw2.lng);
|
|
this._northEast = new LatLng(ne2.lat, ne2.lng);
|
|
} else {
|
|
sw.lat = Math.min(sw2.lat, sw.lat);
|
|
sw.lng = Math.min(sw2.lng, sw.lng);
|
|
ne.lat = Math.max(ne2.lat, ne.lat);
|
|
ne.lng = Math.max(ne2.lng, ne.lng);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method pad(bufferRatio: Number): LatLngBounds
|
|
// Returns bounds created by extending or retracting the current bounds by a given ratio in each direction.
|
|
// For example, a ratio of 0.5 extends the bounds by 50% in each direction.
|
|
// Negative values will retract the bounds.
|
|
pad(bufferRatio) {
|
|
const sw = this._southWest,
|
|
ne = this._northEast,
|
|
heightBuffer = Math.abs(sw.lat - ne.lat) * bufferRatio,
|
|
widthBuffer = Math.abs(sw.lng - ne.lng) * bufferRatio;
|
|
|
|
return new LatLngBounds(
|
|
new LatLng(sw.lat - heightBuffer, sw.lng - widthBuffer),
|
|
new LatLng(ne.lat + heightBuffer, ne.lng + widthBuffer));
|
|
}
|
|
|
|
// @method getCenter(): LatLng
|
|
// Returns the center point of the bounds.
|
|
getCenter() {
|
|
return new LatLng(
|
|
(this._southWest.lat + this._northEast.lat) / 2,
|
|
(this._southWest.lng + this._northEast.lng) / 2);
|
|
}
|
|
|
|
// @method getSouthWest(): LatLng
|
|
// Returns the south-west point of the bounds.
|
|
getSouthWest() {
|
|
return this._southWest;
|
|
}
|
|
|
|
// @method getNorthEast(): LatLng
|
|
// Returns the north-east point of the bounds.
|
|
getNorthEast() {
|
|
return this._northEast;
|
|
}
|
|
|
|
// @method getNorthWest(): LatLng
|
|
// Returns the north-west point of the bounds.
|
|
getNorthWest() {
|
|
return new LatLng(this.getNorth(), this.getWest());
|
|
}
|
|
|
|
// @method getSouthEast(): LatLng
|
|
// Returns the south-east point of the bounds.
|
|
getSouthEast() {
|
|
return new LatLng(this.getSouth(), this.getEast());
|
|
}
|
|
|
|
// @method getWest(): Number
|
|
// Returns the west longitude of the bounds
|
|
getWest() {
|
|
return this._southWest.lng;
|
|
}
|
|
|
|
// @method getSouth(): Number
|
|
// Returns the south latitude of the bounds
|
|
getSouth() {
|
|
return this._southWest.lat;
|
|
}
|
|
|
|
// @method getEast(): Number
|
|
// Returns the east longitude of the bounds
|
|
getEast() {
|
|
return this._northEast.lng;
|
|
}
|
|
|
|
// @method getNorth(): Number
|
|
// Returns the north latitude of the bounds
|
|
getNorth() {
|
|
return this._northEast.lat;
|
|
}
|
|
|
|
// @method contains(otherBounds: LatLngBounds): Boolean
|
|
// Returns `true` if the rectangle contains the given one.
|
|
|
|
// @alternative
|
|
// @method contains (latlng: LatLng): Boolean
|
|
// Returns `true` if the rectangle contains the given point.
|
|
contains(obj) { // (LatLngBounds) or (LatLng) -> Boolean
|
|
if (LatLng.validate(obj)) {
|
|
obj = new LatLng(obj);
|
|
} else {
|
|
obj = new LatLngBounds(obj);
|
|
}
|
|
|
|
const sw = this._southWest,
|
|
ne = this._northEast;
|
|
let sw2, ne2;
|
|
|
|
if (obj instanceof LatLngBounds) {
|
|
sw2 = obj.getSouthWest();
|
|
ne2 = obj.getNorthEast();
|
|
} else {
|
|
sw2 = ne2 = obj;
|
|
}
|
|
|
|
return (sw2.lat >= sw.lat) && (ne2.lat <= ne.lat) &&
|
|
(sw2.lng >= sw.lng) && (ne2.lng <= ne.lng);
|
|
}
|
|
|
|
// @method intersects(otherBounds: LatLngBounds): Boolean
|
|
// Returns `true` if the rectangle intersects the given bounds. Two bounds intersect if they have at least one point in common.
|
|
intersects(bounds) {
|
|
bounds = new LatLngBounds(bounds);
|
|
|
|
const sw = this._southWest,
|
|
ne = this._northEast,
|
|
sw2 = bounds.getSouthWest(),
|
|
ne2 = bounds.getNorthEast(),
|
|
|
|
latIntersects = (ne2.lat >= sw.lat) && (sw2.lat <= ne.lat),
|
|
lngIntersects = (ne2.lng >= sw.lng) && (sw2.lng <= ne.lng);
|
|
|
|
return latIntersects && lngIntersects;
|
|
}
|
|
|
|
// @method overlaps(otherBounds: LatLngBounds): Boolean
|
|
// Returns `true` if the rectangle overlaps the given bounds. Two bounds overlap if their intersection is an area.
|
|
overlaps(bounds) {
|
|
bounds = new LatLngBounds(bounds);
|
|
|
|
const sw = this._southWest,
|
|
ne = this._northEast,
|
|
sw2 = bounds.getSouthWest(),
|
|
ne2 = bounds.getNorthEast(),
|
|
|
|
latOverlaps = (ne2.lat > sw.lat) && (sw2.lat < ne.lat),
|
|
lngOverlaps = (ne2.lng > sw.lng) && (sw2.lng < ne.lng);
|
|
|
|
return latOverlaps && lngOverlaps;
|
|
}
|
|
|
|
// @method toBBoxString(): String
|
|
// Returns a string with bounding box coordinates in a 'southwest_lng,southwest_lat,northeast_lng,northeast_lat' format. Useful for sending requests to web services that return geo data.
|
|
toBBoxString() {
|
|
return [this.getWest(), this.getSouth(), this.getEast(), this.getNorth()].join(',');
|
|
}
|
|
|
|
// @method equals(otherBounds: LatLngBounds, maxMargin?: Number): Boolean
|
|
// Returns `true` if the rectangle is equivalent (within a small margin of error) to the given bounds. The margin of error can be overridden by setting `maxMargin` to a small number.
|
|
equals(bounds, maxMargin) {
|
|
if (!bounds) { return false; }
|
|
|
|
bounds = new LatLngBounds(bounds);
|
|
|
|
return this._southWest.equals(bounds.getSouthWest(), maxMargin) &&
|
|
this._northEast.equals(bounds.getNorthEast(), maxMargin);
|
|
}
|
|
|
|
// @method isValid(): Boolean
|
|
// Returns `true` if the bounds are properly initialized.
|
|
isValid() {
|
|
return !!(this._southWest && this._northEast);
|
|
}
|
|
}
|
|
|
|
/* @class LatLng
|
|
*
|
|
* Represents a geographical point with a certain latitude and longitude.
|
|
*
|
|
* @example
|
|
*
|
|
* ```
|
|
* const latlng = new LatLng(50.5, 30.5);
|
|
* ```
|
|
*
|
|
* All Leaflet methods that accept LatLng objects also accept them in a simple Array form and simple object form (unless noted otherwise), so these lines are equivalent:
|
|
*
|
|
* ```
|
|
* map.panTo([50, 30]);
|
|
* map.panTo({lat: 50, lng: 30});
|
|
* map.panTo({lat: 50, lon: 30});
|
|
* map.panTo(new LatLng(50, 30));
|
|
* ```
|
|
*
|
|
* Note that `LatLng` does not inherit from Leaflet's `Class` object,
|
|
* which means new classes can't inherit from it, and new methods
|
|
* can't be added to it with the `include` function.
|
|
*/
|
|
|
|
// @constructor LatLng(latitude: Number, longitude: Number, altitude?: Number): LatLng
|
|
// Creates an object representing a geographical point with the given latitude and longitude (and optionally altitude).
|
|
|
|
// @alternative
|
|
// @constructor LatLng(coords: Array): LatLng
|
|
// Expects an array of the form `[Number, Number]` or `[Number, Number, Number]` instead.
|
|
|
|
// @alternative
|
|
// @constructor LatLng(coords: Object): LatLng
|
|
// Expects an plain object of the form `{lat: Number, lng: Number}` or `{lat: Number, lng: Number, alt: Number}` instead.
|
|
// You can also use `lon` in place of `lng` in the object form.
|
|
class LatLng {
|
|
constructor(lat, lng, alt) {
|
|
const valid = LatLng.validate(lat, lng, alt);
|
|
if (!valid) {
|
|
throw new Error(`Invalid LatLng object: (${lat}, ${lng})`);
|
|
}
|
|
|
|
let _lat, _lng, _alt;
|
|
if (lat instanceof LatLng) {
|
|
// We can use the same object, no need to clone it
|
|
// eslint-disable-next-line no-constructor-return
|
|
return lat;
|
|
} else if (Array.isArray(lat) && typeof lat[0] !== 'object') {
|
|
if (lat.length === 3) {
|
|
_lat = lat[0];
|
|
_lng = lat[1];
|
|
_alt = lat[2];
|
|
} else if (lat.length === 2) {
|
|
_lat = lat[0];
|
|
_lng = lat[1];
|
|
}
|
|
} else if (typeof lat === 'object' && 'lat' in lat) {
|
|
_lat = lat.lat;
|
|
_lng = 'lng' in lat ? lat.lng : lat.lon;
|
|
_alt = lat.alt;
|
|
} else {
|
|
_lat = lat;
|
|
_lng = lng;
|
|
_alt = alt;
|
|
}
|
|
|
|
|
|
// @property lat: Number
|
|
// Latitude in degrees
|
|
this.lat = +_lat;
|
|
|
|
// @property lng: Number
|
|
// Longitude in degrees
|
|
this.lng = +_lng;
|
|
|
|
// @property alt: Number
|
|
// Altitude in meters (optional)
|
|
if (_alt !== undefined) {
|
|
this.alt = +_alt;
|
|
}
|
|
}
|
|
|
|
// @section
|
|
// There are several static functions which can be called without instantiating LatLng:
|
|
|
|
// @function validate(latitude: Number, longitude: Number, altitude?: Number): Boolean
|
|
// Returns `true` if the LatLng object can be properly initialized.
|
|
|
|
// @alternative
|
|
// @function validate(coords: Array): Boolean
|
|
// Expects an array of the form `[Number, Number]` or `[Number, Number, Number]`.
|
|
// Returns `true` if the LatLng object can be properly initialized.
|
|
|
|
// @alternative
|
|
// @function validate(coords: Object): Boolean
|
|
// Returns `true` if the LatLng object can be properly initialized.
|
|
|
|
// eslint-disable-next-line no-unused-vars
|
|
static validate(lat, lng, alt) {
|
|
if (lat instanceof LatLng || (typeof lat === 'object' && 'lat' in lat)) {
|
|
return true;
|
|
} else if (lat && Array.isArray(lat) && typeof lat[0] !== 'object') {
|
|
if (lat.length === 3 || lat.length === 2) {
|
|
return true;
|
|
}
|
|
return false;
|
|
} else if ((lat || lat === 0) && (lng || lng === 0)) {
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
|
|
// @method equals(otherLatLng: LatLng, maxMargin?: Number): Boolean
|
|
// Returns `true` if the given `LatLng` point is at the same position (within a small margin of error). The margin of error can be overridden by setting `maxMargin` to a small number.
|
|
equals(obj, maxMargin) {
|
|
if (!obj) { return false; }
|
|
|
|
obj = new LatLng(obj);
|
|
|
|
const margin = Math.max(
|
|
Math.abs(this.lat - obj.lat),
|
|
Math.abs(this.lng - obj.lng));
|
|
|
|
return margin <= (maxMargin ?? 1.0E-9);
|
|
}
|
|
|
|
// @method toString(precision?: Number): String
|
|
// Returns a string representation of the point (for debugging purposes).
|
|
toString(precision) {
|
|
return `LatLng(${formatNum(this.lat, precision)}, ${formatNum(this.lng, precision)})`;
|
|
}
|
|
|
|
// @method distanceTo(otherLatLng: LatLng): Number
|
|
// Returns the distance (in meters) to the given `LatLng` calculated using the [Haversine formula](https://en.wikipedia.org/wiki/Haversine_formula).
|
|
distanceTo(other) {
|
|
return Earth.distance(this, new LatLng(other));
|
|
}
|
|
|
|
// @method wrap(): LatLng
|
|
// Returns a new `LatLng` object with the longitude wrapped so it's always between -180 and +180 degrees.
|
|
wrap() {
|
|
return Earth.wrapLatLng(this);
|
|
}
|
|
|
|
// @method toBounds(sizeInMeters: Number): LatLngBounds
|
|
// Returns a new `LatLngBounds` object in which each boundary is `sizeInMeters/2` meters apart from the `LatLng`.
|
|
toBounds(sizeInMeters) {
|
|
const latAccuracy = 180 * sizeInMeters / 40075017,
|
|
lngAccuracy = latAccuracy / Math.cos((Math.PI / 180) * this.lat);
|
|
|
|
return new LatLngBounds(
|
|
[this.lat - latAccuracy, this.lng - lngAccuracy],
|
|
[this.lat + latAccuracy, this.lng + lngAccuracy]);
|
|
}
|
|
|
|
// @method clone(): LatLng
|
|
// Returns a copy of the current LatLng.
|
|
clone() {
|
|
// to skip the validation in the constructor we need to initialize with 0 and then set the values later
|
|
const latlng = new LatLng(0, 0);
|
|
latlng.lat = this.lat;
|
|
latlng.lng = this.lng;
|
|
latlng.alt = this.alt;
|
|
return latlng;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @namespace CRS
|
|
* @crs CRS.Base
|
|
* Object that defines coordinate reference systems for projecting
|
|
* geographical points into pixel (screen) coordinates and back (and to
|
|
* coordinates in other units for [WMS](https://en.wikipedia.org/wiki/Web_Map_Service) services). See
|
|
* [spatial reference system](https://en.wikipedia.org/wiki/Spatial_reference_system).
|
|
*
|
|
* Leaflet defines the most usual CRSs by default. If you want to use a
|
|
* CRS not defined by default, take a look at the
|
|
* [Proj4Leaflet](https://github.com/kartena/Proj4Leaflet) plugin.
|
|
*
|
|
* Note that the CRS instances do not inherit from Leaflet's `Class` object,
|
|
* and can't be instantiated. Also, new classes can't inherit from them,
|
|
* and methods can't be added to them with the `include` function.
|
|
*/
|
|
|
|
class CRS {
|
|
static projection = undefined;
|
|
static transformation = undefined;
|
|
|
|
// @method latLngToPoint(latlng: LatLng, zoom: Number): Point
|
|
// Projects geographical coordinates into pixel coordinates for a given zoom.
|
|
static latLngToPoint(latlng, zoom) {
|
|
const projectedPoint = this.projection.project(latlng),
|
|
scale = this.scale(zoom);
|
|
|
|
return this.transformation._transform(projectedPoint, scale);
|
|
}
|
|
|
|
// @method pointToLatLng(point: Point, zoom: Number): LatLng
|
|
// The inverse of `latLngToPoint`. Projects pixel coordinates on a given
|
|
// zoom into geographical coordinates.
|
|
static pointToLatLng(point, zoom) {
|
|
const scale = this.scale(zoom),
|
|
untransformedPoint = this.transformation.untransform(point, scale);
|
|
|
|
return this.projection.unproject(untransformedPoint);
|
|
}
|
|
|
|
// @method project(latlng: LatLng): Point
|
|
// Projects geographical coordinates into coordinates in units accepted for
|
|
// this CRS (e.g. meters for EPSG:3857, for passing it to WMS services).
|
|
static project(latlng) {
|
|
return this.projection.project(latlng);
|
|
}
|
|
|
|
// @method unproject(point: Point): LatLng
|
|
// Given a projected coordinate returns the corresponding LatLng.
|
|
// The inverse of `project`.
|
|
static unproject(point) {
|
|
return this.projection.unproject(point);
|
|
}
|
|
|
|
// @method scale(zoom: Number): Number
|
|
// Returns the scale used when transforming projected coordinates into
|
|
// pixel coordinates for a particular zoom. For example, it returns
|
|
// `256 * 2^zoom` for Mercator-based CRS.
|
|
static scale(zoom) {
|
|
return 256 * 2 ** zoom;
|
|
}
|
|
|
|
// @method zoom(scale: Number): Number
|
|
// Inverse of `scale()`, returns the zoom level corresponding to a scale
|
|
// factor of `scale`.
|
|
static zoom(scale) {
|
|
return Math.log(scale / 256) / Math.LN2;
|
|
}
|
|
|
|
// @method getProjectedBounds(zoom: Number): Bounds
|
|
// Returns the projection's bounds scaled and transformed for the provided `zoom`.
|
|
static getProjectedBounds(zoom) {
|
|
if (this.infinite) { return null; }
|
|
|
|
const b = this.projection.bounds,
|
|
s = this.scale(zoom),
|
|
min = this.transformation.transform(b.min, s),
|
|
max = this.transformation.transform(b.max, s);
|
|
|
|
return new Bounds(min, max);
|
|
}
|
|
|
|
// @method distance(latlng1: LatLng, latlng2: LatLng): Number
|
|
// Returns the distance between two geographical coordinates.
|
|
|
|
// @property code: String
|
|
// Standard code name of the CRS passed into WMS services (e.g. `'EPSG:3857'`)
|
|
//
|
|
// @property wrapLng: Number[]
|
|
// An array of two numbers defining whether the longitude (horizontal) coordinate
|
|
// axis wraps around a given range and how. Defaults to `[-180, 180]` in most
|
|
// geographical CRSs. If `undefined`, the longitude axis does not wrap around.
|
|
//
|
|
// @property wrapLat: Number[]
|
|
// Like `wrapLng`, but for the latitude (vertical) axis.
|
|
|
|
// wrapLng: [min, max],
|
|
// wrapLat: [min, max],
|
|
|
|
// @property infinite: Boolean
|
|
// If true, the coordinate space will be unbounded (infinite in both axes)
|
|
static infinite = false;
|
|
|
|
// @method wrapLatLng(latlng: LatLng): LatLng
|
|
// Returns a `LatLng` where lat and lng has been wrapped according to the
|
|
// CRS's `wrapLat` and `wrapLng` properties, if they are outside the CRS's bounds.
|
|
static wrapLatLng(latlng) {
|
|
latlng = new LatLng(latlng);
|
|
const lng = this.wrapLng ? wrapNum(latlng.lng, this.wrapLng, true) : latlng.lng,
|
|
lat = this.wrapLat ? wrapNum(latlng.lat, this.wrapLat, true) : latlng.lat,
|
|
alt = latlng.alt;
|
|
|
|
return new LatLng(lat, lng, alt);
|
|
}
|
|
|
|
// @method wrapLatLngBounds(bounds: LatLngBounds): LatLngBounds
|
|
// Returns a `LatLngBounds` with the same size as the given one, ensuring
|
|
// that its center is within the CRS's bounds.
|
|
static wrapLatLngBounds(bounds) {
|
|
bounds = new LatLngBounds(bounds);
|
|
const center = bounds.getCenter(),
|
|
newCenter = this.wrapLatLng(center),
|
|
latShift = center.lat - newCenter.lat,
|
|
lngShift = center.lng - newCenter.lng;
|
|
|
|
if (latShift === 0 && lngShift === 0) {
|
|
return bounds;
|
|
}
|
|
|
|
const sw = bounds.getSouthWest(),
|
|
ne = bounds.getNorthEast(),
|
|
newSw = new LatLng(sw.lat - latShift, sw.lng - lngShift),
|
|
newNe = new LatLng(ne.lat - latShift, ne.lng - lngShift);
|
|
|
|
return new LatLngBounds(newSw, newNe);
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @namespace CRS
|
|
* @crs CRS.Earth
|
|
*
|
|
* Serves as the base for CRS that are global such that they cover the earth.
|
|
* Can only be used as the base for other CRS and cannot be used directly,
|
|
* since it does not have a `code`, `projection` or `transformation`. `distance()` returns
|
|
* meters.
|
|
*/
|
|
|
|
class Earth extends CRS {
|
|
static wrapLng = [-180, 180];
|
|
|
|
// Mean Earth Radius, as recommended for use by
|
|
// the International Union of Geodesy and Geophysics,
|
|
// see https://rosettacode.org/wiki/Haversine_formula
|
|
static R = 6371000;
|
|
|
|
// distance between two geographical points using Haversine approximation
|
|
static distance(latlng1, latlng2) {
|
|
const rad = Math.PI / 180,
|
|
lat1 = latlng1.lat * rad,
|
|
lat2 = latlng2.lat * rad,
|
|
sinDLat = Math.sin((latlng2.lat - latlng1.lat) * rad / 2),
|
|
sinDLon = Math.sin((latlng2.lng - latlng1.lng) * rad / 2),
|
|
a = sinDLat * sinDLat + Math.cos(lat1) * Math.cos(lat2) * sinDLon * sinDLon,
|
|
c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
|
|
return this.R * c;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @namespace Projection
|
|
* @projection Projection.SphericalMercator
|
|
*
|
|
* Spherical Mercator projection — the most common projection for online maps,
|
|
* used by almost all free and commercial tile providers. Assumes that Earth is
|
|
* a sphere. Used by the `EPSG:3857` CRS.
|
|
*/
|
|
|
|
const earthRadius$1 = 6378137;
|
|
|
|
const SphericalMercator = {
|
|
|
|
R: earthRadius$1,
|
|
MAX_LATITUDE: 85.0511287798,
|
|
|
|
project(latlng) {
|
|
latlng = new LatLng(latlng);
|
|
const d = Math.PI / 180,
|
|
max = this.MAX_LATITUDE,
|
|
lat = Math.max(Math.min(max, latlng.lat), -max),
|
|
sin = Math.sin(lat * d);
|
|
|
|
return new Point(
|
|
this.R * latlng.lng * d,
|
|
this.R * Math.log((1 + sin) / (1 - sin)) / 2);
|
|
},
|
|
|
|
unproject(point) {
|
|
point = new Point(point);
|
|
const d = 180 / Math.PI;
|
|
|
|
return new LatLng(
|
|
(2 * Math.atan(Math.exp(point.y / this.R)) - (Math.PI / 2)) * d,
|
|
point.x * d / this.R);
|
|
},
|
|
|
|
bounds: (() => {
|
|
const d = earthRadius$1 * Math.PI;
|
|
return new Bounds([-d, -d], [d, d]);
|
|
})()
|
|
};
|
|
|
|
/*
|
|
* @class Transformation
|
|
*
|
|
* Represents an affine transformation: a set of coefficients `a`, `b`, `c`, `d`
|
|
* for transforming a point of a form `(x, y)` into `(a*x + b, c*y + d)` and doing
|
|
* the reverse. Used by Leaflet in its projections code.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* const transformation = new Transformation(2, 5, -1, 10),
|
|
* p = new Point(1, 2),
|
|
* p2 = transformation.transform(p), // new Point(7, 8)
|
|
* p3 = transformation.untransform(p2); // new Point(1, 2)
|
|
* ```
|
|
*/
|
|
|
|
// @constructor Transformation(a: Number, b: Number, c: Number, d: Number)
|
|
// Instantiates a Transformation object with the given coefficients.
|
|
|
|
// @alternative
|
|
// @constructor Transformation(coefficients: Array): Transformation
|
|
// Expects an coefficients array of the form
|
|
// `[a: Number, b: Number, c: Number, d: Number]`.
|
|
class Transformation {
|
|
constructor(a, b, c, d) {
|
|
if (Array.isArray(a)) {
|
|
// use array properties
|
|
this._a = a[0];
|
|
this._b = a[1];
|
|
this._c = a[2];
|
|
this._d = a[3];
|
|
return;
|
|
}
|
|
this._a = a;
|
|
this._b = b;
|
|
this._c = c;
|
|
this._d = d;
|
|
}
|
|
|
|
// @method transform(point: Point, scale?: Number): Point
|
|
// Returns a transformed point, optionally multiplied by the given scale.
|
|
// Only accepts actual `Point` instances, not arrays.
|
|
transform(point, scale) { // (Point, Number) -> Point
|
|
return this._transform(point.clone(), scale);
|
|
}
|
|
|
|
// destructive transform (faster)
|
|
_transform(point, scale) {
|
|
scale ||= 1;
|
|
point.x = scale * (this._a * point.x + this._b);
|
|
point.y = scale * (this._c * point.y + this._d);
|
|
return point;
|
|
}
|
|
|
|
// @method untransform(point: Point, scale?: Number): Point
|
|
// Returns the reverse transformation of the given point, optionally divided
|
|
// by the given scale. Only accepts actual `Point` instances, not arrays.
|
|
untransform(point, scale) {
|
|
scale ||= 1;
|
|
return new Point(
|
|
(point.x / scale - this._b) / this._a,
|
|
(point.y / scale - this._d) / this._c);
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @namespace CRS
|
|
* @crs CRS.EPSG3857
|
|
*
|
|
* The most common CRS for online maps, used by almost all free and commercial
|
|
* tile providers. Uses Spherical Mercator projection. Set in by default in
|
|
* Map's `crs` option.
|
|
*/
|
|
|
|
class EPSG3857 extends Earth {
|
|
static code = 'EPSG:3857';
|
|
static projection = SphericalMercator;
|
|
|
|
static transformation = (() => {
|
|
const scale = 0.5 / (Math.PI * SphericalMercator.R);
|
|
return new Transformation(scale, 0.5, -scale, 0.5);
|
|
})();
|
|
}
|
|
|
|
class EPSG900913 extends EPSG3857 {
|
|
static code = 'EPSG:900913';
|
|
}
|
|
|
|
/*
|
|
* @namespace Browser
|
|
*
|
|
* A namespace with static properties for browser/feature detection used by Leaflet internally.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* if (Browser.chrome) {
|
|
* alert('You are running Chrome!');
|
|
* }
|
|
* ```
|
|
*/
|
|
|
|
// @property chrome: Boolean; `true` for the Chrome browser.
|
|
const chrome = userAgentContains('chrome');
|
|
|
|
// @property safari: Boolean; `true` for the Safari browser.
|
|
const safari = !chrome && userAgentContains('safari');
|
|
|
|
// @property mobile: Boolean; `true` for all browsers running in a mobile device.
|
|
const mobile = typeof orientation !== 'undefined' || userAgentContains('mobile');
|
|
|
|
// @property pointer: Boolean
|
|
// `true` for all browsers supporting [pointer events](https://msdn.microsoft.com/en-us/library/dn433244%28v=vs.85%29.aspx).
|
|
const pointer = typeof window === 'undefined' ? false : !!window.PointerEvent;
|
|
|
|
// @property touchNative: Boolean
|
|
// `true` for all browsers supporting [touch events](https://developer.mozilla.org/docs/Web/API/Touch_events).
|
|
// **This does not necessarily mean** that the browser is running in a computer with
|
|
// a touchscreen, it only means that the browser is capable of understanding
|
|
// touch events.
|
|
const touchNative = typeof window === 'undefined' ? false : 'ontouchstart' in window || !!(window.TouchEvent);
|
|
|
|
// @property touch: Boolean
|
|
// `true` for all browsers supporting either [touch](#browser-touch) or [pointer](#browser-pointer) events.
|
|
// Note: pointer events will be preferred (if available), and processed for all `touch*` listeners.
|
|
const touch = touchNative || pointer;
|
|
|
|
// @property retina: Boolean
|
|
// `true` for browsers on a high-resolution "retina" screen or on any screen when browser's display zoom is more than 100%.
|
|
const retina = typeof window === 'undefined' || typeof window.devicePixelRatio === 'undefined' ? false : window.devicePixelRatio > 1;
|
|
|
|
// @property mac: Boolean; `true` when the browser is running in a Mac platform
|
|
const mac = typeof navigator === 'undefined' || typeof navigator.platform === 'undefined' ? false : navigator.platform.startsWith('Mac');
|
|
|
|
// @property linux: Boolean; `true` when the browser is running in a Linux platform
|
|
const linux = typeof navigator === 'undefined' || typeof navigator.platform === 'undefined' ? false : navigator.platform.startsWith('Linux');
|
|
|
|
function userAgentContains(str) {
|
|
if (typeof navigator === 'undefined' || typeof navigator.userAgent === 'undefined') {
|
|
return false;
|
|
}
|
|
return navigator.userAgent.toLowerCase().includes(str);
|
|
}
|
|
|
|
var Browser = {
|
|
chrome,
|
|
safari,
|
|
mobile,
|
|
pointer,
|
|
touch,
|
|
touchNative,
|
|
retina,
|
|
mac,
|
|
linux
|
|
};
|
|
|
|
/*
|
|
* Extends the event handling code with double tap support for mobile browsers.
|
|
*
|
|
* Note: currently most browsers fire native dblclick, with only a few exceptions
|
|
* (see https://github.com/Leaflet/Leaflet/issues/7012#issuecomment-595087386)
|
|
*/
|
|
|
|
function makeDblclick(ev) {
|
|
let init = {
|
|
// EventInit
|
|
bubbles: ev.bubbles,
|
|
cancelable: ev.cancelable,
|
|
composed: ev.composed,
|
|
|
|
// UIEventInit
|
|
detail: 2,
|
|
view: ev.view,
|
|
|
|
// mouseEventInit
|
|
screenX: ev.screenX,
|
|
screenY: ev.screenY,
|
|
clientX: ev.clientX,
|
|
clientY: ev.clientY,
|
|
ctrlKey: ev.ctrlKey,
|
|
shiftKey: ev.shiftKey,
|
|
altKey: ev.altKey,
|
|
metaKey: ev.metaKey,
|
|
button: ev.button,
|
|
buttons: ev.buttons,
|
|
relatedTarget: ev.relatedTarget,
|
|
region: ev.region,
|
|
};
|
|
|
|
let newEvent;
|
|
// The `click` event received should be a PointerEvent - but some
|
|
// Firefox versions still use MouseEvent.
|
|
if (ev instanceof PointerEvent) {
|
|
init = {
|
|
...init,
|
|
pointerId: ev.pointerId,
|
|
width: ev.width,
|
|
height: ev.height,
|
|
pressure: ev.pressure,
|
|
tangentialPressure: ev.tangentialPressure,
|
|
tiltX: ev.tiltX,
|
|
tiltY: ev.tiltY,
|
|
twist: ev.twist,
|
|
pointerType: ev.pointerType,
|
|
isPrimary: ev.isPrimary,
|
|
};
|
|
newEvent = new PointerEvent('dblclick', init);
|
|
} else {
|
|
newEvent = new MouseEvent('dblclick', init);
|
|
}
|
|
return newEvent;
|
|
}
|
|
|
|
const delay = 200;
|
|
function addDoubleTapListener(obj, handler) {
|
|
// Most browsers handle double tap natively
|
|
obj.addEventListener('dblclick', handler);
|
|
|
|
// On some platforms the browser doesn't fire native dblclicks for touch events.
|
|
// It seems that in all such cases `detail` property of `click` event is always `1`.
|
|
// So here we rely on that fact to avoid excessive 'dblclick' simulation when not needed.
|
|
let last = 0,
|
|
detail;
|
|
function simDblclick(ev) {
|
|
if (ev.detail !== 1) {
|
|
detail = ev.detail; // keep in sync to avoid false dblclick in some cases
|
|
return;
|
|
}
|
|
|
|
if (ev.pointerType === 'mouse' ||
|
|
(ev.sourceCapabilities && !ev.sourceCapabilities.firesTouchEvents)) {
|
|
|
|
return;
|
|
}
|
|
|
|
// When clicking on an <input>, the browser generates a click on its
|
|
// <label> (and vice versa) triggering two clicks in quick succession.
|
|
// This ignores clicks on elements which are a label with a 'for'
|
|
// attribute (or children of such a label), but not children of
|
|
// a <input>.
|
|
const path = getPropagationPath(ev);
|
|
if (path.some(el => el instanceof HTMLLabelElement && el.attributes.for) &&
|
|
!path.some(el => (
|
|
el instanceof HTMLInputElement ||
|
|
el instanceof HTMLSelectElement
|
|
))
|
|
) {
|
|
return;
|
|
}
|
|
|
|
const now = Date.now();
|
|
if (now - last <= delay) {
|
|
detail++;
|
|
if (detail === 2) {
|
|
ev.target.dispatchEvent(makeDblclick(ev));
|
|
}
|
|
} else {
|
|
detail = 1;
|
|
}
|
|
last = now;
|
|
}
|
|
|
|
obj.addEventListener('click', simDblclick);
|
|
|
|
return {
|
|
dblclick: handler,
|
|
simDblclick
|
|
};
|
|
}
|
|
|
|
function removeDoubleTapListener(obj, handlers) {
|
|
obj.removeEventListener('dblclick', handlers.dblclick);
|
|
obj.removeEventListener('click', handlers.simDblclick);
|
|
}
|
|
|
|
/*
|
|
* @namespace DomUtil
|
|
*
|
|
* Utility functions to work with the [DOM](https://developer.mozilla.org/docs/Web/API/Document_Object_Model)
|
|
* tree, used by Leaflet internally.
|
|
*
|
|
* Most functions expecting or returning a `HTMLElement` also work for
|
|
* SVG elements. The only difference is that classes refer to CSS classes
|
|
* in HTML and SVG classes in SVG.
|
|
*/
|
|
|
|
// @function get(id: String|HTMLElement): HTMLElement
|
|
// Returns an element given its DOM id, or returns the element itself
|
|
// if it was passed directly.
|
|
function get(id) {
|
|
return typeof id === 'string' ? document.getElementById(id) : id;
|
|
}
|
|
|
|
// @function create(tagName: String, className?: String, container?: HTMLElement): HTMLElement
|
|
// Creates an HTML element with `tagName`, sets its class to `className`, and optionally appends it to `container` element.
|
|
function create$1(tagName, className, container) {
|
|
const el = document.createElement(tagName);
|
|
el.className = className ?? '';
|
|
|
|
container?.appendChild(el);
|
|
return el;
|
|
}
|
|
|
|
// @function toFront(el: HTMLElement)
|
|
// Makes `el` the last child of its parent, so it renders in front of the other children.
|
|
function toFront(el) {
|
|
const parent = el.parentNode;
|
|
if (parent && parent.lastChild !== el) {
|
|
parent.appendChild(el);
|
|
}
|
|
}
|
|
|
|
// @function toBack(el: HTMLElement)
|
|
// Makes `el` the first child of its parent, so it renders behind the other children.
|
|
function toBack(el) {
|
|
const parent = el.parentNode;
|
|
if (parent && parent.firstChild !== el) {
|
|
parent.insertBefore(el, parent.firstChild);
|
|
}
|
|
}
|
|
|
|
// @function setTransform(el: HTMLElement, offset: Point, scale?: Number)
|
|
// Resets the 3D CSS transform of `el` so it is translated by `offset` pixels
|
|
// and optionally scaled by `scale`. Does not have an effect if the
|
|
// browser doesn't support 3D CSS transforms.
|
|
function setTransform(el, offset, scale) {
|
|
const pos = offset ?? new Point(0, 0);
|
|
|
|
el.style.transform = `translate3d(${pos.x}px,${pos.y}px,0)${scale ? ` scale(${scale})` : ''}`;
|
|
}
|
|
|
|
const positions = new WeakMap();
|
|
|
|
// @function setPosition(el: HTMLElement, position: Point)
|
|
// Sets the position of `el` to coordinates specified by `position`,
|
|
// using CSS translate or top/left positioning depending on the browser
|
|
// (used by Leaflet internally to position its layers).
|
|
function setPosition(el, point) {
|
|
positions.set(el, point);
|
|
setTransform(el, point);
|
|
}
|
|
|
|
// @function getPosition(el: HTMLElement): Point
|
|
// Returns the coordinates of an element previously positioned with setPosition.
|
|
function getPosition(el) {
|
|
// this method is only used for elements previously positioned using setPosition,
|
|
// so it's safe to cache the position for performance
|
|
return positions.get(el) ?? new Point(0, 0);
|
|
}
|
|
|
|
const documentStyle = typeof document === 'undefined' ? {} : document.documentElement.style;
|
|
// Safari still needs a vendor prefix, we need to detect with property name is supported.
|
|
const userSelectProp = ['userSelect', 'WebkitUserSelect'].find(prop => prop in documentStyle);
|
|
let prevUserSelect;
|
|
|
|
// @function disableTextSelection()
|
|
// Prevents the user from selecting text in the document. Used internally
|
|
// by Leaflet to override the behaviour of any click-and-drag interaction on
|
|
// the map. Affects drag interactions on the whole document.
|
|
function disableTextSelection() {
|
|
const value = documentStyle[userSelectProp];
|
|
|
|
if (value === 'none') {
|
|
return;
|
|
}
|
|
|
|
prevUserSelect = value;
|
|
documentStyle[userSelectProp] = 'none';
|
|
}
|
|
|
|
// @function enableTextSelection()
|
|
// Cancels the effects of a previous [`DomUtil.disableTextSelection`](#domutil-disabletextselection).
|
|
function enableTextSelection() {
|
|
if (typeof prevUserSelect === 'undefined') {
|
|
return;
|
|
}
|
|
|
|
documentStyle[userSelectProp] = prevUserSelect;
|
|
prevUserSelect = undefined;
|
|
}
|
|
|
|
// @function disableImageDrag()
|
|
// Prevents the user from generating `dragstart` DOM events, usually generated when the user drags an image.
|
|
function disableImageDrag() {
|
|
on(window, 'dragstart', preventDefault);
|
|
}
|
|
|
|
// @function enableImageDrag()
|
|
// Cancels the effects of a previous [`DomUtil.disableImageDrag`](#domutil-disableimagedrag).
|
|
function enableImageDrag() {
|
|
off(window, 'dragstart', preventDefault);
|
|
}
|
|
|
|
let _outlineElement, _outlineStyle;
|
|
// @function preventOutline(el: HTMLElement)
|
|
// Makes the [outline](https://developer.mozilla.org/docs/Web/CSS/outline)
|
|
// of the element `el` invisible. Used internally by Leaflet to prevent
|
|
// focusable elements from displaying an outline when the user performs a
|
|
// drag interaction on them.
|
|
function preventOutline(element) {
|
|
while (element.tabIndex === -1) {
|
|
element = element.parentNode;
|
|
}
|
|
if (!element.style) { return; }
|
|
restoreOutline();
|
|
_outlineElement = element;
|
|
_outlineStyle = element.style.outlineStyle;
|
|
element.style.outlineStyle = 'none';
|
|
on(window, 'keydown', restoreOutline);
|
|
}
|
|
|
|
// @function restoreOutline()
|
|
// Cancels the effects of a previous [`DomUtil.preventOutline`](#domutil-preventoutline).
|
|
function restoreOutline() {
|
|
if (!_outlineElement) { return; }
|
|
_outlineElement.style.outlineStyle = _outlineStyle;
|
|
_outlineElement = undefined;
|
|
_outlineStyle = undefined;
|
|
off(window, 'keydown', restoreOutline);
|
|
}
|
|
|
|
// @function getSizedParentNode(el: HTMLElement): HTMLElement
|
|
// Finds the closest parent node which size (width and height) is not null.
|
|
function getSizedParentNode(element) {
|
|
do {
|
|
element = element.parentNode;
|
|
} while ((!element.offsetWidth || !element.offsetHeight) && element !== document.body);
|
|
return element;
|
|
}
|
|
|
|
// @function getScale(el: HTMLElement): Object
|
|
// Computes the CSS scale currently applied on the element.
|
|
// Returns an object with `x` and `y` members as horizontal and vertical scales respectively,
|
|
// and `boundingClientRect` as the result of [`getBoundingClientRect()`](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect).
|
|
function getScale(element) {
|
|
const rect = element.getBoundingClientRect(); // Read-only in old browsers.
|
|
|
|
return {
|
|
x: rect.width / element.offsetWidth || 1,
|
|
y: rect.height / element.offsetHeight || 1,
|
|
boundingClientRect: rect
|
|
};
|
|
}
|
|
|
|
var DomUtil = {
|
|
__proto__: null,
|
|
create: create$1,
|
|
disableImageDrag: disableImageDrag,
|
|
disableTextSelection: disableTextSelection,
|
|
enableImageDrag: enableImageDrag,
|
|
enableTextSelection: enableTextSelection,
|
|
get: get,
|
|
getPosition: getPosition,
|
|
getScale: getScale,
|
|
getSizedParentNode: getSizedParentNode,
|
|
preventOutline: preventOutline,
|
|
restoreOutline: restoreOutline,
|
|
setPosition: setPosition,
|
|
setTransform: setTransform,
|
|
toBack: toBack,
|
|
toFront: toFront
|
|
};
|
|
|
|
/*
|
|
/* @namespace DomEvent
|
|
* @section Pointer detection
|
|
* Detects the pointers that are currently active on the document.
|
|
*/
|
|
|
|
let activePointers = new Map();
|
|
let initialized = false;
|
|
|
|
// @function enablePointerDetection()
|
|
// Enables pointer detection for the document.
|
|
function enablePointerDetection() {
|
|
if (initialized) {
|
|
return;
|
|
}
|
|
initialized = true;
|
|
document.addEventListener('pointerdown', _onSet, {capture: true});
|
|
document.addEventListener('pointermove', _onUpdate, {capture: true});
|
|
document.addEventListener('pointerup', _onDelete, {capture: true});
|
|
document.addEventListener('pointercancel', _onDelete, {capture: true});
|
|
activePointers = new Map();
|
|
}
|
|
|
|
// @function disablePointerDetection()
|
|
// Disables pointer detection for the document.
|
|
function disablePointerDetection() {
|
|
document.removeEventListener('pointerdown', _onSet, {capture: true});
|
|
document.removeEventListener('pointermove', _onUpdate, {capture: true});
|
|
document.removeEventListener('pointerup', _onDelete, {capture: true});
|
|
document.removeEventListener('pointercancel', _onDelete, {capture: true});
|
|
initialized = false;
|
|
}
|
|
|
|
function _onSet(e) {
|
|
activePointers.set(e.pointerId, e);
|
|
}
|
|
|
|
function _onUpdate(e) {
|
|
if (activePointers.has(e.pointerId)) {
|
|
activePointers.set(e.pointerId, e);
|
|
}
|
|
}
|
|
|
|
function _onDelete(e) {
|
|
activePointers.delete(e.pointerId);
|
|
}
|
|
|
|
// @function getPointers(): PointerEvent[]
|
|
// Returns the active pointers on the document.
|
|
function getPointers() {
|
|
return [...activePointers.values()];
|
|
}
|
|
|
|
// @function cleanupPointers()
|
|
// Clears the detected pointers on the document.
|
|
// Note: This function should be not necessary to call, as the pointers are automatically cleared with `pointerup`, `pointercancel` and `pointerout` events.
|
|
function cleanupPointers() {
|
|
activePointers.clear();
|
|
}
|
|
|
|
var DomEvent_PointerEvents = {
|
|
__proto__: null,
|
|
cleanupPointers: cleanupPointers,
|
|
disablePointerDetection: disablePointerDetection,
|
|
enablePointerDetection: enablePointerDetection,
|
|
getPointers: getPointers
|
|
};
|
|
|
|
/*
|
|
* @namespace DomEvent
|
|
* Utility functions to work with the [DOM events](https://developer.mozilla.org/docs/Web/API/Event), used by Leaflet internally.
|
|
*/
|
|
|
|
// Inspired by John Resig, Dean Edwards and YUI addEvent implementations.
|
|
|
|
// @function on(el: HTMLElement, types: String, fn: Function, context?: Object): this
|
|
// Adds a listener function (`fn`) to a particular DOM event type of the
|
|
// element `el`. You can optionally specify the context of the listener
|
|
// (object the `this` keyword will point to). You can also pass several
|
|
// space-separated types (e.g. `'click dblclick'`).
|
|
|
|
// @alternative
|
|
// @function on(el: HTMLElement, eventMap: Object, context?: Object): this
|
|
// Adds a set of type/listener pairs, e.g. `{click: onClick, pointermove: onPointerMove}`
|
|
function on(obj, types, fn, context) {
|
|
|
|
if (types && typeof types === 'object') {
|
|
for (const [type, listener] of Object.entries(types)) {
|
|
addOne(obj, type, listener, fn);
|
|
}
|
|
} else {
|
|
for (const type of splitWords(types)) {
|
|
addOne(obj, type, fn, context);
|
|
}
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
const eventsKey = '_leaflet_events';
|
|
|
|
// @function off(el: HTMLElement, types: String, fn: Function, context?: Object): this
|
|
// Removes a previously added listener function.
|
|
// Note that if you passed a custom context to on, you must pass the same
|
|
// context to `off` in order to remove the listener.
|
|
|
|
// @alternative
|
|
// @function off(el: HTMLElement, eventMap: Object, context?: Object): this
|
|
// Removes a set of type/listener pairs, e.g. `{click: onClick, pointermove: onPointerMove}`
|
|
|
|
// @alternative
|
|
// @function off(el: HTMLElement, types: String): this
|
|
// Removes all previously added listeners of given types.
|
|
|
|
// @alternative
|
|
// @function off(el: HTMLElement): this
|
|
// Removes all previously added listeners from given HTMLElement
|
|
function off(obj, types, fn, context) {
|
|
|
|
if (arguments.length === 1) {
|
|
batchRemove(obj);
|
|
delete obj[eventsKey];
|
|
|
|
} else if (types && typeof types === 'object') {
|
|
for (const [type, listener] of Object.entries(types)) {
|
|
removeOne(obj, type, listener, fn);
|
|
}
|
|
|
|
} else {
|
|
types = splitWords(types);
|
|
|
|
if (arguments.length === 2) {
|
|
batchRemove(obj, type => types.includes(type));
|
|
} else {
|
|
for (const type of types) {
|
|
removeOne(obj, type, fn, context);
|
|
}
|
|
}
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
function batchRemove(obj, filterFn) {
|
|
for (const id of Object.keys(obj[eventsKey] ?? {})) {
|
|
const type = id.split(/\d/)[0];
|
|
if (!filterFn || filterFn(type)) {
|
|
removeOne(obj, type, null, null, id);
|
|
}
|
|
}
|
|
}
|
|
|
|
const pointerSubst = {
|
|
pointerenter: 'pointerover',
|
|
pointerleave: 'pointerout',
|
|
wheel: typeof window === 'undefined' ? false : !('onwheel' in window) && 'mousewheel'
|
|
};
|
|
|
|
function addOne(obj, type, fn, context) {
|
|
const id = type + stamp(fn) + (context ? `_${stamp(context)}` : '');
|
|
|
|
if (obj[eventsKey] && obj[eventsKey][id]) { return this; }
|
|
|
|
let handler = function (e) {
|
|
return fn.call(context || obj, e || window.event);
|
|
};
|
|
|
|
const originalHandler = handler;
|
|
|
|
if (Browser.touch && (type === 'dblclick')) {
|
|
handler = addDoubleTapListener(obj, handler);
|
|
|
|
} else if ('addEventListener' in obj) {
|
|
|
|
if (type === 'wheel' || type === 'mousewheel') {
|
|
obj.addEventListener(pointerSubst[type] || type, handler, {passive: false});
|
|
} else if (type === 'pointerenter' || type === 'pointerleave') {
|
|
handler = function (e) {
|
|
e ??= window.event;
|
|
if (isExternalTarget(obj, e)) {
|
|
originalHandler(e);
|
|
}
|
|
};
|
|
obj.addEventListener(pointerSubst[type], handler, false);
|
|
|
|
} else {
|
|
obj.addEventListener(type, originalHandler, false);
|
|
}
|
|
|
|
} else {
|
|
obj.attachEvent(`on${type}`, handler);
|
|
}
|
|
|
|
obj[eventsKey] ??= {};
|
|
obj[eventsKey][id] = handler;
|
|
}
|
|
|
|
function removeOne(obj, type, fn, context, id) {
|
|
id ??= type + stamp(fn) + (context ? `_${stamp(context)}` : '');
|
|
const handler = obj[eventsKey] && obj[eventsKey][id];
|
|
|
|
if (!handler) { return this; }
|
|
|
|
if (Browser.touch && (type === 'dblclick')) {
|
|
removeDoubleTapListener(obj, handler);
|
|
|
|
} else if ('removeEventListener' in obj) {
|
|
|
|
obj.removeEventListener(pointerSubst[type] || type, handler, false);
|
|
|
|
} else {
|
|
obj.detachEvent(`on${type}`, handler);
|
|
}
|
|
|
|
obj[eventsKey][id] = null;
|
|
}
|
|
|
|
// @function stopPropagation(ev: DOMEvent): this
|
|
// Stop the given event from propagation to parent elements. Used inside the listener functions:
|
|
// ```js
|
|
// DomEvent.on(div, 'click', DomEvent.stopPropagation);
|
|
// ```
|
|
function stopPropagation(e) {
|
|
|
|
if (e.stopPropagation) {
|
|
e.stopPropagation();
|
|
} else if (e.originalEvent) { // In case of Leaflet event.
|
|
e.originalEvent._stopped = true;
|
|
} else {
|
|
e.cancelBubble = true;
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
// @function disableScrollPropagation(el: HTMLElement): this
|
|
// Adds `stopPropagation` to the element's `'wheel'` events (plus browser variants).
|
|
function disableScrollPropagation(el) {
|
|
addOne(el, 'wheel', stopPropagation);
|
|
return this;
|
|
}
|
|
|
|
// @function disableClickPropagation(el: HTMLElement): this
|
|
// Adds `stopPropagation` to the element's `'click'`, `'dblclick'`, `'contextmenu'`
|
|
// and `'pointerdown'` events (plus browser variants).
|
|
function disableClickPropagation(el) {
|
|
on(el, 'pointerdown dblclick contextmenu', stopPropagation);
|
|
el['_leaflet_disable_click'] = true;
|
|
return this;
|
|
}
|
|
|
|
// @function preventDefault(ev: DOMEvent): this
|
|
// Prevents the default action of the DOM Event `ev` from happening (such as
|
|
// following a link in the href of the a element, or doing a POST request
|
|
// with page reload when a `<form>` is submitted).
|
|
// Use it inside listener functions.
|
|
function preventDefault(e) {
|
|
if (e.preventDefault) {
|
|
e.preventDefault();
|
|
} else {
|
|
e.returnValue = false;
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @function stop(ev: DOMEvent): this
|
|
// Does `stopPropagation` and `preventDefault` at the same time.
|
|
function stop(e) {
|
|
preventDefault(e);
|
|
stopPropagation(e);
|
|
return this;
|
|
}
|
|
|
|
// @function getPropagationPath(ev: DOMEvent): Array
|
|
// Returns an array containing the `HTMLElement`s that the given DOM event
|
|
// should propagate to (if not stopped).
|
|
function getPropagationPath(ev) {
|
|
return ev.composedPath();
|
|
}
|
|
|
|
|
|
// @function getPointerPosition(ev: DOMEvent, container?: HTMLElement): Point
|
|
// Gets normalized pointer position from a DOM event relative to the
|
|
// `container` (border excluded) or to the whole page if not specified.
|
|
function getPointerPosition(e, container) {
|
|
if (!container) {
|
|
return new Point(e.clientX, e.clientY);
|
|
}
|
|
|
|
const scale = getScale(container),
|
|
offset = scale.boundingClientRect; // left and top values are in page scale (like the event clientX/Y)
|
|
|
|
return new Point(
|
|
// offset.left/top values are in page scale (like clientX/Y),
|
|
// whereas clientLeft/Top (border width) values are the original values (before CSS scale applies).
|
|
(e.clientX - offset.left) / scale.x - container.clientLeft,
|
|
(e.clientY - offset.top) / scale.y - container.clientTop
|
|
);
|
|
}
|
|
|
|
// @function getWheelPxFactor(): Number
|
|
// Gets the wheel pixel factor based on the devicePixelRatio
|
|
function getWheelPxFactor() {
|
|
// We need double the scroll pixels (see #7403 and #4538) for all Browsers
|
|
// except OSX (Mac) -> 3x, Chrome running on Linux 1x
|
|
const ratio = window.devicePixelRatio;
|
|
return Browser.linux && Browser.chrome ? ratio :
|
|
Browser.mac ? ratio * 3 :
|
|
ratio > 0 ? 2 * ratio : 1;
|
|
}
|
|
|
|
// @function getWheelDelta(ev: DOMEvent): Number
|
|
// Gets normalized wheel delta from a wheel DOM event, in vertical
|
|
// pixels scrolled (negative if scrolling down).
|
|
// Events from pointing devices without precise scrolling are mapped to
|
|
// a best guess of 60 pixels.
|
|
function getWheelDelta(e) {
|
|
return (e.deltaY && e.deltaMode === 0) ? -e.deltaY / getWheelPxFactor() : // Pixels
|
|
(e.deltaY && e.deltaMode === 1) ? -e.deltaY * 20 : // Lines
|
|
(e.deltaY && e.deltaMode === 2) ? -e.deltaY * 60 : // Pages
|
|
(e.deltaX || e.deltaZ) ? 0 : // Skip horizontal/depth wheel events
|
|
0;
|
|
}
|
|
|
|
// check if element really left/entered the event target (for pointerenter/pointerleave)
|
|
function isExternalTarget(el, e) {
|
|
|
|
let related = e.relatedTarget;
|
|
|
|
if (!related) { return true; }
|
|
|
|
try {
|
|
while (related && (related !== el)) {
|
|
related = related.parentNode;
|
|
}
|
|
} catch (err) {
|
|
return false;
|
|
}
|
|
return (related !== el);
|
|
}
|
|
|
|
var DomEvent = {
|
|
__proto__: null,
|
|
PointerEvents: DomEvent_PointerEvents,
|
|
disableClickPropagation: disableClickPropagation,
|
|
disableScrollPropagation: disableScrollPropagation,
|
|
getPointerPosition: getPointerPosition,
|
|
getPropagationPath: getPropagationPath,
|
|
getWheelDelta: getWheelDelta,
|
|
getWheelPxFactor: getWheelPxFactor,
|
|
isExternalTarget: isExternalTarget,
|
|
off: off,
|
|
on: on,
|
|
preventDefault: preventDefault,
|
|
stop: stop,
|
|
stopPropagation: stopPropagation
|
|
};
|
|
|
|
/*
|
|
* @class PosAnimation
|
|
* @inherits Evented
|
|
* Used internally for panning animations and utilizing CSS Transitions for modern browsers.
|
|
*
|
|
* @example
|
|
* ```js
|
|
* const myPositionMarker = new Marker([48.864716, 2.294694]).addTo(map);
|
|
*
|
|
* myPositionMarker.on("click", function() {
|
|
* const pos = map.latLngToLayerPoint(myPositionMarker.getLatLng());
|
|
* pos.y -= 25;
|
|
* const fx = new PosAnimation();
|
|
*
|
|
* fx.once('end',function() {
|
|
* pos.y += 25;
|
|
* fx.run(myPositionMarker._icon, pos, 0.8);
|
|
* });
|
|
*
|
|
* fx.run(myPositionMarker._icon, pos, 0.3);
|
|
* });
|
|
*
|
|
* ```
|
|
*
|
|
* @constructor PosAnimation()
|
|
* Creates a `PosAnimation` object.
|
|
*
|
|
*/
|
|
|
|
class PosAnimation extends Evented {
|
|
|
|
// @method run(el: HTMLElement, newPos: Point, duration?: Number, easeLinearity?: Number)
|
|
// Run an animation of a given element to a new position, optionally setting
|
|
// duration in seconds (`0.25` by default) and easing linearity factor (3rd
|
|
// argument of the [cubic bezier curve](https://cubic-bezier.com/#0,0,.5,1),
|
|
// `0.5` by default).
|
|
run(el, newPos, duration, easeLinearity) {
|
|
this.stop();
|
|
|
|
this._el = el;
|
|
this._inProgress = true;
|
|
this._duration = duration ?? 0.25;
|
|
this._easeOutPower = 1 / Math.max(easeLinearity ?? 0.5, 0.2);
|
|
|
|
this._startPos = getPosition(el);
|
|
this._offset = newPos.subtract(this._startPos);
|
|
this._startTime = +new Date();
|
|
|
|
// @event start: Event
|
|
// Fired when the animation starts
|
|
this.fire('start');
|
|
|
|
this._animate();
|
|
}
|
|
|
|
// @method stop()
|
|
// Stops the animation (if currently running).
|
|
stop() {
|
|
if (!this._inProgress) { return; }
|
|
|
|
this._step(true);
|
|
this._complete();
|
|
}
|
|
|
|
_animate() {
|
|
// animation loop
|
|
this._animId = requestAnimationFrame(this._animate.bind(this));
|
|
this._step();
|
|
}
|
|
|
|
_step(round) {
|
|
const elapsed = (+new Date()) - this._startTime,
|
|
duration = this._duration * 1000;
|
|
|
|
if (elapsed < duration) {
|
|
this._runFrame(this._easeOut(elapsed / duration), round);
|
|
} else {
|
|
this._runFrame(1);
|
|
this._complete();
|
|
}
|
|
}
|
|
|
|
_runFrame(progress, round) {
|
|
const pos = this._startPos.add(this._offset.multiplyBy(progress));
|
|
if (round) {
|
|
pos._round();
|
|
}
|
|
setPosition(this._el, pos);
|
|
|
|
// @event step: Event
|
|
// Fired continuously during the animation.
|
|
this.fire('step');
|
|
}
|
|
|
|
_complete() {
|
|
cancelAnimationFrame(this._animId);
|
|
|
|
this._inProgress = false;
|
|
// @event end: Event
|
|
// Fired when the animation ends.
|
|
this.fire('end');
|
|
}
|
|
|
|
_easeOut(t) {
|
|
return 1 - (1 - t) ** this._easeOutPower;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class Map
|
|
* @inherits Evented
|
|
*
|
|
* The central class of the API — it is used to create a map on a page and manipulate it.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* // initialize the map on the "map" div with a given center and zoom
|
|
* const map = new Map('map', {
|
|
* center: [51.505, -0.09],
|
|
* zoom: 13
|
|
* });
|
|
* ```
|
|
*
|
|
*/
|
|
|
|
// @section
|
|
// @constructor Map(id: String, options?: Map options)
|
|
// Instantiates a map object given the DOM ID of a `<div>` element
|
|
// and optionally an object literal with `Map options`.
|
|
//
|
|
// @alternative
|
|
// @constructor Map(el: HTMLElement, options?: Map options)
|
|
// Instantiates a map object given an instance of a `<div>` HTML element
|
|
// and optionally an object literal with `Map options`.
|
|
//
|
|
// @alternative
|
|
// @constructor LeafletMap(id: String, options?: LeafletMap options)
|
|
// Instantiates a map object given the DOM ID of a `<div>` element
|
|
// and optionally an object literal with `LeafletMap options`.
|
|
//
|
|
// @alternative
|
|
// @constructor LeafletMap(el: HTMLElement, options?: LeafletMap options)
|
|
// Instantiates a map object given an instance of a `<div>` HTML element
|
|
// and optionally an object literal with `LeafletMap options`.
|
|
let Map$1 = class Map extends Evented {
|
|
|
|
static {
|
|
this.setDefaultOptions({
|
|
// @section Map State Options
|
|
// @option crs: CRS = CRS.EPSG3857
|
|
// The [Coordinate Reference System](#crs) to use. Don't change this if you're not
|
|
// sure what it means.
|
|
crs: EPSG3857,
|
|
|
|
// @option center: LatLng = undefined
|
|
// Initial geographic center of the map
|
|
center: undefined,
|
|
|
|
// @option zoom: Number = undefined
|
|
// Initial map zoom level
|
|
zoom: undefined,
|
|
|
|
// @option minZoom: Number = *
|
|
// Minimum zoom level of the map.
|
|
// If not specified and at least one `GridLayer` or `TileLayer` is in the map,
|
|
// the lowest of their `minZoom` options will be used instead.
|
|
minZoom: undefined,
|
|
|
|
// @option maxZoom: Number = *
|
|
// Maximum zoom level of the map.
|
|
// If not specified and at least one `GridLayer` or `TileLayer` is in the map,
|
|
// the highest of their `maxZoom` options will be used instead.
|
|
maxZoom: undefined,
|
|
|
|
// @option layers: Layer[] = []
|
|
// Array of layers that will be added to the map initially
|
|
layers: [],
|
|
|
|
// @option maxBounds: LatLngBounds = null
|
|
// When this option is set, the map restricts the view to the given
|
|
// geographical bounds, bouncing the user back if the user tries to pan
|
|
// outside the view. To set the restriction dynamically, use
|
|
// [`setMaxBounds`](#map-setmaxbounds) method.
|
|
maxBounds: undefined,
|
|
|
|
// @option renderer: Renderer = *
|
|
// The default method for drawing vector layers on the map. `SVG`
|
|
// or `Canvas` by default depending on browser support.
|
|
renderer: undefined,
|
|
|
|
|
|
// @section Animation Options
|
|
// @option zoomAnimation: Boolean = true
|
|
// Whether the map zoom animation is enabled. By default it's enabled
|
|
// in all browsers that support CSS Transitions except Android.
|
|
zoomAnimation: true,
|
|
|
|
// @option zoomAnimationThreshold: Number = 4
|
|
// Won't animate zoom if the zoom difference exceeds this value.
|
|
zoomAnimationThreshold: 4,
|
|
|
|
// @option fadeAnimation: Boolean = true
|
|
// Whether the tile fade animation is enabled. By default it's enabled
|
|
// in all browsers that support CSS Transitions except Android.
|
|
fadeAnimation: true,
|
|
|
|
// @option markerZoomAnimation: Boolean = true
|
|
// Whether markers animate their zoom with the zoom animation, if disabled
|
|
// they will disappear for the length of the animation. By default it's
|
|
// enabled in all browsers that support CSS Transitions except Android.
|
|
markerZoomAnimation: true,
|
|
|
|
// @option transform3DLimit: Number = 2^23
|
|
// Defines the maximum size of a CSS translation transform. The default
|
|
// value should not be changed unless a web browser positions layers in
|
|
// the wrong place after doing a large `panBy`.
|
|
transform3DLimit: 8388608, // Precision limit of a 32-bit float
|
|
|
|
// @section Interaction Options
|
|
// @option zoomSnap: Number = 1
|
|
// Forces the map's zoom level to always be a multiple of this, particularly
|
|
// right after a [`fitBounds()`](#map-fitbounds) or a pinch-zoom.
|
|
// By default, the zoom level snaps to the nearest integer; lower values
|
|
// (e.g. `0.5` or `0.1`) allow for greater granularity. A value of `0`
|
|
// means the zoom level will not be snapped after `fitBounds` or a pinch-zoom.
|
|
zoomSnap: 1,
|
|
|
|
// @option zoomDelta: Number = 1
|
|
// Controls how much the map's zoom level will change after a
|
|
// [`zoomIn()`](#map-zoomin), [`zoomOut()`](#map-zoomout), pressing `+`
|
|
// or `-` on the keyboard, or using the [zoom controls](#control-zoom).
|
|
// Values smaller than `1` (e.g. `0.5`) allow for greater granularity.
|
|
zoomDelta: 1,
|
|
|
|
// @option trackResize: Boolean = true
|
|
// Whether the map automatically handles browser window resize to update itself.
|
|
trackResize: true
|
|
});
|
|
}
|
|
|
|
initialize(id, options) { // (HTMLElement or String, Object)
|
|
options = setOptions(this, options);
|
|
|
|
// Make sure to assign internal flags at the beginning,
|
|
// to avoid inconsistent state in some edge cases.
|
|
this._handlers = [];
|
|
this._layers = {};
|
|
this._zoomBoundLayers = {};
|
|
this._sizeChanged = true;
|
|
|
|
this._initContainer(id);
|
|
this._initLayout();
|
|
|
|
this._initEvents();
|
|
|
|
if (options.maxBounds) {
|
|
this.setMaxBounds(options.maxBounds);
|
|
}
|
|
|
|
if (options.zoom !== undefined) {
|
|
this._zoom = this._limitZoom(options.zoom);
|
|
}
|
|
|
|
if (options.center && options.zoom !== undefined) {
|
|
this.setView(new LatLng(options.center), options.zoom, {reset: true});
|
|
}
|
|
|
|
this.callInitHooks();
|
|
|
|
// don't animate on browsers without hardware-accelerated transitions or old Android
|
|
this._zoomAnimated = this.options.zoomAnimation;
|
|
|
|
// zoom transitions run with the same duration for all layers, so if one of transitionend events
|
|
// happens after starting zoom animation (propagating to the map pane), we know that it ended globally
|
|
if (this._zoomAnimated) {
|
|
this._createAnimProxy();
|
|
}
|
|
|
|
this._addLayers(this.options.layers);
|
|
}
|
|
|
|
// @section Methods for modifying map state
|
|
|
|
// @method setView(center: LatLng, zoom?: Number, options?: Zoom/pan options): this
|
|
// Sets the view of the map (geographical center and zoom) with the given
|
|
// animation options.
|
|
setView(center, zoom, options) {
|
|
|
|
zoom = zoom === undefined ? this._zoom : this._limitZoom(zoom);
|
|
center = this._limitCenter(new LatLng(center), zoom, this.options.maxBounds);
|
|
options ??= {};
|
|
|
|
this._stop();
|
|
|
|
if (this._loaded && !options.reset && options !== true) {
|
|
|
|
if (options.animate !== undefined) {
|
|
options.zoom = {animate: options.animate, ...options.zoom};
|
|
options.pan = {animate: options.animate, duration: options.duration, ...options.pan};
|
|
}
|
|
|
|
// try animating pan or zoom
|
|
const moved = (this._zoom !== zoom) ?
|
|
this._tryAnimatedZoom && this._tryAnimatedZoom(center, zoom, options.zoom) :
|
|
this._tryAnimatedPan(center, options.pan);
|
|
|
|
if (moved) {
|
|
// prevent resize handler call, the view will refresh after animation anyway
|
|
clearTimeout(this._sizeTimer);
|
|
return this;
|
|
}
|
|
}
|
|
|
|
// animation didn't start, just reset the map view
|
|
this._resetView(center, zoom, options.pan?.noMoveStart);
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method setZoom(zoom: Number, options?: Zoom/pan options): this
|
|
// Sets the zoom of the map.
|
|
setZoom(zoom, options) {
|
|
if (!this._loaded) {
|
|
this._zoom = zoom;
|
|
return this;
|
|
}
|
|
return this.setView(this.getCenter(), zoom, {zoom: options});
|
|
}
|
|
|
|
// @method zoomIn(delta?: Number, options?: Zoom options): this
|
|
// Increases the zoom of the map by `delta` ([`zoomDelta`](#map-zoomdelta) by default).
|
|
zoomIn(delta, options) {
|
|
delta ??= this.options.zoomDelta;
|
|
return this.setZoom(this._zoom + delta, options);
|
|
}
|
|
|
|
// @method zoomOut(delta?: Number, options?: Zoom options): this
|
|
// Decreases the zoom of the map by `delta` ([`zoomDelta`](#map-zoomdelta) by default).
|
|
zoomOut(delta, options) {
|
|
delta ??= this.options.zoomDelta;
|
|
return this.setZoom(this._zoom - delta, options);
|
|
}
|
|
|
|
// @method setZoomAround(latlng: LatLng, zoom: Number, options: Zoom options): this
|
|
// Zooms the map while keeping a specified geographical point on the map
|
|
// stationary (e.g. used internally for scroll zoom and double-click zoom).
|
|
// @alternative
|
|
// @method setZoomAround(offset: Point, zoom: Number, options: Zoom options): this
|
|
// Zooms the map while keeping a specified pixel on the map (relative to the top-left corner) stationary.
|
|
setZoomAround(latlng, zoom, options) {
|
|
const scale = this.getZoomScale(zoom),
|
|
viewHalf = this.getSize().divideBy(2),
|
|
containerPoint = latlng instanceof Point ? latlng : this.latLngToContainerPoint(latlng),
|
|
|
|
centerOffset = containerPoint.subtract(viewHalf).multiplyBy(1 - 1 / scale),
|
|
newCenter = this.containerPointToLatLng(viewHalf.add(centerOffset));
|
|
|
|
return this.setView(newCenter, zoom, {zoom: options});
|
|
}
|
|
|
|
_getBoundsCenterZoom(bounds, options) {
|
|
|
|
options ??= {};
|
|
bounds = bounds.getBounds ? bounds.getBounds() : new LatLngBounds(bounds);
|
|
|
|
const paddingTL = new Point(options.paddingTopLeft || options.padding || [0, 0]),
|
|
paddingBR = new Point(options.paddingBottomRight || options.padding || [0, 0]);
|
|
|
|
let zoom = this.getBoundsZoom(bounds, false, paddingTL.add(paddingBR));
|
|
|
|
zoom = (typeof options.maxZoom === 'number') ? Math.min(options.maxZoom, zoom) : zoom;
|
|
|
|
if (zoom === Infinity) {
|
|
return {
|
|
center: bounds.getCenter(),
|
|
zoom
|
|
};
|
|
}
|
|
|
|
const paddingOffset = paddingBR.subtract(paddingTL).divideBy(2),
|
|
|
|
swPoint = this.project(bounds.getSouthWest(), zoom),
|
|
nePoint = this.project(bounds.getNorthEast(), zoom),
|
|
center = this.unproject(swPoint.add(nePoint).divideBy(2).add(paddingOffset), zoom);
|
|
|
|
return {
|
|
center,
|
|
zoom
|
|
};
|
|
}
|
|
|
|
// @method fitBounds(bounds: LatLngBounds, options?: fitBounds options): this
|
|
// Sets a map view that contains the given geographical bounds with the
|
|
// maximum zoom level possible.
|
|
fitBounds(bounds, options) {
|
|
|
|
bounds = new LatLngBounds(bounds);
|
|
|
|
if (!bounds.isValid()) {
|
|
throw new Error('Bounds are not valid.');
|
|
}
|
|
|
|
const target = this._getBoundsCenterZoom(bounds, options);
|
|
return this.setView(target.center, target.zoom, options);
|
|
}
|
|
|
|
// @method fitWorld(options?: fitBounds options): this
|
|
// Sets a map view that mostly contains the whole world with the maximum
|
|
// zoom level possible.
|
|
fitWorld(options) {
|
|
return this.fitBounds([[-90, -180], [90, 180]], options);
|
|
}
|
|
|
|
// @method panTo(latlng: LatLng, options?: Pan options): this
|
|
// Pans the map to a given center.
|
|
panTo(center, options) {
|
|
return this.setView(center, this._zoom, {pan: options});
|
|
}
|
|
|
|
// @method panBy(offset: Point, options?: Pan options): this
|
|
// Pans the map by a given number of pixels (animated).
|
|
panBy(offset, options) {
|
|
offset = new Point(offset).round();
|
|
options ??= {};
|
|
|
|
if (!offset.x && !offset.y) {
|
|
return this.fire('moveend');
|
|
}
|
|
// If we pan too far, Chrome gets issues with tiles
|
|
// and makes them disappear or appear in the wrong place (slightly offset) #2602
|
|
if (options.animate !== true && !this.getSize().contains(offset)) {
|
|
this._resetView(this.unproject(this.project(this.getCenter()).add(offset)), this.getZoom());
|
|
return this;
|
|
}
|
|
|
|
if (!this._panAnim) {
|
|
this._panAnim = new PosAnimation();
|
|
|
|
this._panAnim.on({
|
|
'step': this._onPanTransitionStep,
|
|
'end': this._onPanTransitionEnd
|
|
}, this);
|
|
}
|
|
|
|
// don't fire movestart if animating inertia
|
|
if (!options.noMoveStart) {
|
|
this.fire('movestart');
|
|
}
|
|
|
|
// animate pan unless animate: false specified
|
|
if (options.animate !== false) {
|
|
this._mapPane.classList.add('leaflet-pan-anim');
|
|
|
|
const newPos = this._getMapPanePos().subtract(offset).round();
|
|
this._panAnim.run(this._mapPane, newPos, options.duration || 0.25, options.easeLinearity);
|
|
} else {
|
|
this._rawPanBy(offset);
|
|
this.fire('move').fire('moveend');
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method flyTo(latlng: LatLng, zoom?: Number, options?: Zoom/pan options): this
|
|
// Sets the view of the map (geographical center and zoom) performing a smooth
|
|
// pan-zoom animation.
|
|
flyTo(targetCenter, targetZoom, options) {
|
|
|
|
options ??= {};
|
|
if (options.animate === false) {
|
|
return this.setView(targetCenter, targetZoom, options);
|
|
}
|
|
|
|
this._stop();
|
|
|
|
const from = this.project(this.getCenter()),
|
|
to = this.project(targetCenter),
|
|
size = this.getSize(),
|
|
startZoom = this._zoom;
|
|
|
|
targetCenter = new LatLng(targetCenter);
|
|
targetZoom = targetZoom === undefined ? startZoom : this._limitZoom(targetZoom);
|
|
|
|
const w0 = Math.max(size.x, size.y),
|
|
w1 = w0 * this.getZoomScale(startZoom, targetZoom),
|
|
u1 = (to.distanceTo(from)) || 1,
|
|
rho = 1.42,
|
|
rho2 = rho * rho;
|
|
|
|
function r(i) {
|
|
const s1 = i ? -1 : 1,
|
|
s2 = i ? w1 : w0,
|
|
t1 = w1 * w1 - w0 * w0 + s1 * rho2 * rho2 * u1 * u1,
|
|
b1 = 2 * s2 * rho2 * u1,
|
|
b = t1 / b1,
|
|
sq = Math.sqrt(b * b + 1) - b;
|
|
|
|
// workaround for floating point precision bug when sq = 0, log = -Infinite,
|
|
// thus triggering an infinite loop in flyTo
|
|
const log = sq < 0.000000001 ? -18 : Math.log(sq);
|
|
|
|
return log;
|
|
}
|
|
|
|
function sinh(n) { return (Math.exp(n) - Math.exp(-n)) / 2; }
|
|
function cosh(n) { return (Math.exp(n) + Math.exp(-n)) / 2; }
|
|
function tanh(n) { return sinh(n) / cosh(n); }
|
|
|
|
const r0 = r(0);
|
|
|
|
function w(s) { return w0 * (cosh(r0) / cosh(r0 + rho * s)); }
|
|
function u(s) { return w0 * (cosh(r0) * tanh(r0 + rho * s) - sinh(r0)) / rho2; }
|
|
|
|
function easeOut(t) { return 1 - (1 - t) ** 1.5; }
|
|
|
|
const start = Date.now(),
|
|
S = (r(1) - r0) / rho,
|
|
duration = options.duration ? 1000 * options.duration : 1000 * S * 0.8;
|
|
|
|
const frame = () => {
|
|
const t = (Date.now() - start) / duration,
|
|
s = easeOut(t) * S;
|
|
|
|
if (t <= 1) {
|
|
this._flyToFrame = requestAnimationFrame(frame);
|
|
|
|
this._move(
|
|
this.unproject(from.add(to.subtract(from).multiplyBy(u(s) / u1)), startZoom),
|
|
this.getScaleZoom(w0 / w(s), startZoom),
|
|
{flyTo: true});
|
|
|
|
} else {
|
|
this
|
|
._move(targetCenter, targetZoom)
|
|
._moveEnd(true);
|
|
}
|
|
};
|
|
|
|
this._moveStart(true, options.noMoveStart);
|
|
|
|
frame();
|
|
return this;
|
|
}
|
|
|
|
// @method flyToBounds(bounds: LatLngBounds, options?: fitBounds options): this
|
|
// Sets the view of the map with a smooth animation like [`flyTo`](#map-flyto),
|
|
// but takes a bounds parameter like [`fitBounds`](#map-fitbounds).
|
|
flyToBounds(bounds, options) {
|
|
const target = this._getBoundsCenterZoom(bounds, options);
|
|
return this.flyTo(target.center, target.zoom, options);
|
|
}
|
|
|
|
// @method setMaxBounds(bounds: LatLngBounds): this
|
|
// Restricts the map view to the given bounds (see the [maxBounds](#map-maxbounds) option).
|
|
setMaxBounds(bounds) {
|
|
bounds = new LatLngBounds(bounds);
|
|
|
|
if (this.listens('moveend', this._panInsideMaxBounds)) {
|
|
this.off('moveend', this._panInsideMaxBounds);
|
|
}
|
|
|
|
if (!bounds.isValid()) {
|
|
this.options.maxBounds = null;
|
|
return this;
|
|
}
|
|
|
|
this.options.maxBounds = bounds;
|
|
|
|
if (this._loaded) {
|
|
this._panInsideMaxBounds();
|
|
}
|
|
|
|
return this.on('moveend', this._panInsideMaxBounds);
|
|
}
|
|
|
|
// @method setMinZoom(zoom: Number): this
|
|
// Sets the lower limit for the available zoom levels (see the [minZoom](#map-minzoom) option).
|
|
setMinZoom(zoom) {
|
|
const oldZoom = this.options.minZoom;
|
|
this.options.minZoom = zoom;
|
|
|
|
if (this._loaded && oldZoom !== zoom) {
|
|
this.fire('zoomlevelschange');
|
|
|
|
if (this.getZoom() < this.options.minZoom) {
|
|
return this.setZoom(zoom);
|
|
}
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method setMaxZoom(zoom: Number): this
|
|
// Sets the upper limit for the available zoom levels (see the [maxZoom](#map-maxzoom) option).
|
|
setMaxZoom(zoom) {
|
|
const oldZoom = this.options.maxZoom;
|
|
this.options.maxZoom = zoom;
|
|
|
|
if (this._loaded && oldZoom !== zoom) {
|
|
this.fire('zoomlevelschange');
|
|
|
|
if (this.getZoom() > this.options.maxZoom) {
|
|
return this.setZoom(zoom);
|
|
}
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method panInsideBounds(bounds: LatLngBounds, options?: Pan options): this
|
|
// Pans the map to the closest view that would lie inside the given bounds (if it's not already), controlling the animation using the options specific, if any.
|
|
panInsideBounds(bounds, options) {
|
|
this._enforcingBounds = true;
|
|
const center = this.getCenter(),
|
|
newCenter = this._limitCenter(center, this._zoom, new LatLngBounds(bounds));
|
|
|
|
if (!center.equals(newCenter)) {
|
|
this.panTo(newCenter, options);
|
|
}
|
|
|
|
this._enforcingBounds = false;
|
|
return this;
|
|
}
|
|
|
|
// @method panInside(latlng: LatLng, options?: padding options): this
|
|
// Pans the map the minimum amount to make the `latlng` visible. Use
|
|
// padding options to fit the display to more restricted bounds.
|
|
// If `latlng` is already within the (optionally padded) display bounds,
|
|
// the map will not be panned.
|
|
panInside(latlng, options) {
|
|
options ??= {};
|
|
|
|
const paddingTL = new Point(options.paddingTopLeft || options.padding || [0, 0]),
|
|
paddingBR = new Point(options.paddingBottomRight || options.padding || [0, 0]),
|
|
pixelCenter = this.project(this.getCenter()),
|
|
pixelPoint = this.project(latlng),
|
|
pixelBounds = this.getPixelBounds(),
|
|
paddedBounds = new Bounds([pixelBounds.min.add(paddingTL), pixelBounds.max.subtract(paddingBR)]),
|
|
paddedSize = paddedBounds.getSize();
|
|
|
|
if (!paddedBounds.contains(pixelPoint)) {
|
|
this._enforcingBounds = true;
|
|
const centerOffset = pixelPoint.subtract(paddedBounds.getCenter());
|
|
const offset = paddedBounds.extend(pixelPoint).getSize().subtract(paddedSize);
|
|
pixelCenter.x += centerOffset.x < 0 ? -offset.x : offset.x;
|
|
pixelCenter.y += centerOffset.y < 0 ? -offset.y : offset.y;
|
|
this.panTo(this.unproject(pixelCenter), options);
|
|
this._enforcingBounds = false;
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method invalidateSize(options: invalidateSize options): this
|
|
// Checks if the map container size changed and updates the map if so —
|
|
// call it after you've changed the map size dynamically, also animating
|
|
// pan by default. If `options.pan` is `false`, panning will not occur.
|
|
// If `options.debounceMoveend` is `true`, it will delay `moveend` event so
|
|
// that it doesn't happen often even if the method is called many
|
|
// times in a row.
|
|
|
|
// @alternative
|
|
// @method invalidateSize(animate: Boolean): this
|
|
// Checks if the map container size changed and updates the map if so —
|
|
// call it after you've changed the map size dynamically, also animating
|
|
// pan by default.
|
|
invalidateSize(options) {
|
|
if (!this._loaded) { return this; }
|
|
|
|
options = {
|
|
animate: false,
|
|
pan: true,
|
|
...(options === true ? {animate: true} : options)
|
|
};
|
|
|
|
const oldSize = this.getSize();
|
|
this._sizeChanged = true;
|
|
this._lastCenter = null;
|
|
|
|
const newSize = this.getSize(),
|
|
oldCenter = oldSize.divideBy(2).round(),
|
|
newCenter = newSize.divideBy(2).round(),
|
|
offset = oldCenter.subtract(newCenter);
|
|
|
|
if (!offset.x && !offset.y) { return this; }
|
|
|
|
if (options.animate && options.pan) {
|
|
this.panBy(offset);
|
|
|
|
} else {
|
|
if (options.pan) {
|
|
this._rawPanBy(offset);
|
|
}
|
|
|
|
this.fire('move');
|
|
|
|
if (options.debounceMoveend) {
|
|
clearTimeout(this._sizeTimer);
|
|
this._sizeTimer = setTimeout(this.fire.bind(this, 'moveend'), 200);
|
|
} else {
|
|
this.fire('moveend');
|
|
}
|
|
}
|
|
|
|
// @section Map state change events
|
|
// @event resize: ResizeEvent
|
|
// Fired when the map is resized.
|
|
return this.fire('resize', {
|
|
oldSize,
|
|
newSize
|
|
});
|
|
}
|
|
|
|
// @section Methods for modifying map state
|
|
// @method stop(): this
|
|
// Stops the currently running `panTo` or `flyTo` animation, if any.
|
|
stop() {
|
|
this.setZoom(this._limitZoom(this._zoom));
|
|
if (!this.options.zoomSnap) {
|
|
this.fire('viewreset');
|
|
}
|
|
return this._stop();
|
|
}
|
|
|
|
// @section Geolocation methods
|
|
// @method locate(options?: Locate options): this
|
|
// Tries to locate the user using the Geolocation API, firing a [`locationfound`](#map-locationfound)
|
|
// event with location data on success or a [`locationerror`](#map-locationerror) event on failure,
|
|
// and optionally sets the map view to the user's location with respect to
|
|
// detection accuracy (or to the world view if geolocation failed).
|
|
// Note that, if your page doesn't use HTTPS, this method will fail in
|
|
// modern browsers ([Chrome 50 and newer](https://sites.google.com/a/chromium.org/dev/Home/chromium-security/deprecating-powerful-features-on-insecure-origins))
|
|
// See `Locate options` for more details.
|
|
locate(options) {
|
|
|
|
options = this._locateOptions = {
|
|
timeout: 10000,
|
|
watch: false,
|
|
// setView: false
|
|
// maxZoom: <Number>
|
|
// maximumAge: 0
|
|
// enableHighAccuracy: false
|
|
...options
|
|
};
|
|
|
|
if (!('geolocation' in navigator)) {
|
|
this._handleGeolocationError({
|
|
code: 0,
|
|
message: 'Geolocation not supported.'
|
|
});
|
|
return this;
|
|
}
|
|
|
|
const onResponse = this._handleGeolocationResponse.bind(this),
|
|
onError = this._handleGeolocationError.bind(this);
|
|
|
|
if (options.watch) {
|
|
if (this._locationWatchId !== undefined) {
|
|
navigator.geolocation.clearWatch(this._locationWatchId);
|
|
}
|
|
this._locationWatchId =
|
|
navigator.geolocation.watchPosition(onResponse, onError, options);
|
|
} else {
|
|
navigator.geolocation.getCurrentPosition(onResponse, onError, options);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method stopLocate(): this
|
|
// Stops watching location previously initiated by `map.locate({watch: true})`
|
|
// and aborts resetting the map view if map.locate was called with
|
|
// `{setView: true}`.
|
|
stopLocate() {
|
|
navigator.geolocation?.clearWatch?.(this._locationWatchId);
|
|
if (this._locateOptions) {
|
|
this._locateOptions.setView = false;
|
|
}
|
|
return this;
|
|
}
|
|
|
|
_handleGeolocationError(error) {
|
|
if (!this._container._leaflet_id) { return; }
|
|
|
|
const c = error.code,
|
|
message = error.message ||
|
|
(c === 1 ? 'permission denied' :
|
|
(c === 2 ? 'position unavailable' : 'timeout'));
|
|
|
|
if (this._locateOptions.setView && !this._loaded) {
|
|
this.fitWorld();
|
|
}
|
|
|
|
// @section Location events
|
|
// @event locationerror: ErrorEvent
|
|
// Fired when geolocation (using the [`locate`](#map-locate) method) failed.
|
|
this.fire('locationerror', {
|
|
code: c,
|
|
message: `Geolocation error: ${message}.`
|
|
});
|
|
}
|
|
|
|
_handleGeolocationResponse(pos) {
|
|
if (!this._container._leaflet_id) { return; }
|
|
|
|
const lat = pos.coords.latitude,
|
|
lng = pos.coords.longitude,
|
|
latlng = new LatLng(lat, lng),
|
|
bounds = latlng.toBounds(pos.coords.accuracy * 2),
|
|
options = this._locateOptions;
|
|
|
|
if (options.setView) {
|
|
const zoom = this.getBoundsZoom(bounds);
|
|
this.setView(latlng, options.maxZoom ? Math.min(zoom, options.maxZoom) : zoom);
|
|
}
|
|
|
|
const data = {
|
|
latlng,
|
|
bounds,
|
|
timestamp: pos.timestamp
|
|
};
|
|
|
|
for (const i in pos.coords) { // do not use Object.keys here to access getters of GeolocationCoordinates
|
|
if (typeof pos.coords[i] === 'number') {
|
|
data[i] = pos.coords[i];
|
|
}
|
|
}
|
|
|
|
// @event locationfound: LocationEvent
|
|
// Fired when geolocation (using the [`locate`](#map-locate) method)
|
|
// went successfully.
|
|
this.fire('locationfound', data);
|
|
}
|
|
|
|
// TODO Appropriate docs section?
|
|
// @section Other Methods
|
|
// @method addHandler(name: String, HandlerClass: Function): this
|
|
// Adds a new `Handler` to the map, given its name and constructor function.
|
|
addHandler(name, HandlerClass) {
|
|
if (!HandlerClass) { return this; }
|
|
|
|
const handler = this[name] = new HandlerClass(this);
|
|
|
|
this._handlers.push(handler);
|
|
|
|
if (this.options[name]) {
|
|
handler.enable();
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method remove(): this
|
|
// Destroys the map and clears all related event listeners.
|
|
remove() {
|
|
|
|
this._initEvents(true);
|
|
if (this.options.maxBounds) { this.off('moveend', this._panInsideMaxBounds); }
|
|
|
|
if (this._containerId !== this._container._leaflet_id) {
|
|
throw new Error('Map container is being reused by another instance');
|
|
}
|
|
|
|
delete this._container._leaflet_id;
|
|
delete this._containerId;
|
|
|
|
if (this._locationWatchId !== undefined) {
|
|
this.stopLocate();
|
|
}
|
|
|
|
this._stop();
|
|
|
|
this._mapPane.remove();
|
|
|
|
if (this._clearControlPos) {
|
|
this._clearControlPos();
|
|
}
|
|
if (this._resizeRequest) {
|
|
cancelAnimationFrame(this._resizeRequest);
|
|
this._resizeRequest = null;
|
|
}
|
|
|
|
this._clearHandlers();
|
|
|
|
clearTimeout(this._transitionEndTimer);
|
|
clearTimeout(this._sizeTimer);
|
|
|
|
if (this._loaded) {
|
|
// @section Map state change events
|
|
// @event unload: Event
|
|
// Fired when the map is destroyed with [remove](#map-remove) method.
|
|
this.fire('unload');
|
|
}
|
|
|
|
this._destroyAnimProxy();
|
|
|
|
for (const layer of Object.values(this._layers)) {
|
|
layer.remove();
|
|
}
|
|
for (const pane of Object.values(this._panes)) {
|
|
pane.remove();
|
|
}
|
|
|
|
this._layers = {};
|
|
this._panes = {};
|
|
delete this._mapPane;
|
|
delete this._renderer;
|
|
|
|
return this;
|
|
}
|
|
|
|
// @section Other Methods
|
|
// @method createPane(name: String, container?: HTMLElement): HTMLElement
|
|
// Creates a new [map pane](#map-pane) with the given name if it doesn't exist already,
|
|
// then returns it. The pane is created as a child of `container`, or
|
|
// as a child of the main map pane if not set.
|
|
createPane(name, container) {
|
|
const className = `leaflet-pane${name ? ` leaflet-${name.replace('Pane', '')}-pane` : ''}`,
|
|
pane = create$1('div', className, container || this._mapPane);
|
|
|
|
if (name) {
|
|
this._panes[name] = pane;
|
|
}
|
|
return pane;
|
|
}
|
|
|
|
// @section Methods for Getting Map State
|
|
|
|
// @method getCenter(): LatLng
|
|
// Returns the geographical center of the map view
|
|
getCenter() {
|
|
this._checkIfLoaded();
|
|
|
|
if (this._lastCenter && !this._moved()) {
|
|
return this._lastCenter.clone();
|
|
}
|
|
return this.layerPointToLatLng(this._getCenterLayerPoint());
|
|
}
|
|
|
|
// @method getZoom(): Number
|
|
// Returns the current zoom level of the map view
|
|
getZoom() {
|
|
return this._zoom;
|
|
}
|
|
|
|
// @method getBounds(): LatLngBounds
|
|
// Returns the geographical bounds visible in the current map view
|
|
getBounds() {
|
|
const bounds = this.getPixelBounds(),
|
|
sw = this.unproject(bounds.getBottomLeft()),
|
|
ne = this.unproject(bounds.getTopRight());
|
|
|
|
return new LatLngBounds(sw, ne);
|
|
}
|
|
|
|
// @method getMinZoom(): Number
|
|
// Returns the minimum zoom level of the map (if set in the `minZoom` option of the map or of any layers), or `0` by default.
|
|
getMinZoom() {
|
|
return this.options.minZoom ?? this._layersMinZoom ?? 0;
|
|
}
|
|
|
|
// @method getMaxZoom(): Number
|
|
// Returns the maximum zoom level of the map (if set in the `maxZoom` option of the map or of any layers).
|
|
getMaxZoom() {
|
|
return this.options.maxZoom ?? this._layersMaxZoom ?? Infinity;
|
|
}
|
|
|
|
// @method getBoundsZoom(bounds: LatLngBounds, inside?: Boolean, padding?: Point): Number
|
|
// Returns the maximum zoom level on which the given bounds fit to the map
|
|
// view in its entirety. If `inside` (optional) is set to `true`, the method
|
|
// instead returns the minimum zoom level on which the map view fits into
|
|
// the given bounds in its entirety.
|
|
getBoundsZoom(bounds, inside, padding) { // (LatLngBounds[, Boolean, Point]) -> Number
|
|
bounds = new LatLngBounds(bounds);
|
|
padding = new Point(padding ?? [0, 0]);
|
|
|
|
let zoom = this.getZoom() ?? 0;
|
|
const min = this.getMinZoom(),
|
|
max = this.getMaxZoom(),
|
|
nw = bounds.getNorthWest(),
|
|
se = bounds.getSouthEast(),
|
|
size = this.getSize().subtract(padding),
|
|
boundsSize = new Bounds(this.project(se, zoom), this.project(nw, zoom)).getSize(),
|
|
snap = this.options.zoomSnap,
|
|
scalex = size.x / boundsSize.x,
|
|
scaley = size.y / boundsSize.y,
|
|
scale = inside ? Math.max(scalex, scaley) : Math.min(scalex, scaley);
|
|
|
|
zoom = this.getScaleZoom(scale, zoom);
|
|
|
|
if (snap) {
|
|
zoom = Math.round(zoom / (snap / 100)) * (snap / 100); // don't jump if within 1% of a snap level
|
|
zoom = inside ? Math.ceil(zoom / snap) * snap : Math.floor(zoom / snap) * snap;
|
|
}
|
|
|
|
return Math.max(min, Math.min(max, zoom));
|
|
}
|
|
|
|
// @method getSize(): Point
|
|
// Returns the current size of the map container (in pixels).
|
|
getSize() {
|
|
if (!this._size || this._sizeChanged) {
|
|
this._size = new Point(
|
|
this._container.clientWidth || 0,
|
|
this._container.clientHeight || 0);
|
|
|
|
this._sizeChanged = false;
|
|
}
|
|
return this._size.clone();
|
|
}
|
|
|
|
// @method getPixelBounds(center?: LatLng, zoom?: Number): Bounds
|
|
// Returns the bounds of the current map view in projected pixel
|
|
// coordinates (sometimes useful in layer and overlay implementations).
|
|
// If `center` and `zoom` is omitted, the map's current zoom level and center is used.
|
|
getPixelBounds(center, zoom) {
|
|
const topLeftPoint = this._getTopLeftPoint(center, zoom);
|
|
return new Bounds(topLeftPoint, topLeftPoint.add(this.getSize()));
|
|
}
|
|
|
|
// TODO: Check semantics - isn't the pixel origin the 0,0 coord relative to
|
|
// the map pane? "left point of the map layer" can be confusing, specially
|
|
// since there can be negative offsets.
|
|
// @method getPixelOrigin(): Point
|
|
// Returns the projected pixel coordinates of the top left point of
|
|
// the map layer (useful in custom layer and overlay implementations).
|
|
getPixelOrigin() {
|
|
this._checkIfLoaded();
|
|
return this._pixelOrigin;
|
|
}
|
|
|
|
// @method getPixelWorldBounds(zoom?: Number): Bounds
|
|
// Returns the world's bounds in pixel coordinates for zoom level `zoom`.
|
|
// If `zoom` is omitted, the map's current zoom level is used.
|
|
getPixelWorldBounds(zoom) {
|
|
return this.options.crs.getProjectedBounds(zoom ?? this.getZoom());
|
|
}
|
|
|
|
// @section Other Methods
|
|
|
|
// @method getPane(pane: String|HTMLElement): HTMLElement
|
|
// Returns a [map pane](#map-pane), given its name or its HTML element (its identity).
|
|
getPane(pane) {
|
|
return typeof pane === 'string' ? this._panes[pane] : pane;
|
|
}
|
|
|
|
// @method getPanes(): Object
|
|
// Returns a plain object containing the names of all [panes](#map-pane) as keys and
|
|
// the panes as values.
|
|
getPanes() {
|
|
return this._panes;
|
|
}
|
|
|
|
// @method getContainer: HTMLElement
|
|
// Returns the HTML element that contains the map.
|
|
getContainer() {
|
|
return this._container;
|
|
}
|
|
|
|
|
|
// @section Conversion Methods
|
|
|
|
// @method getZoomScale(toZoom: Number, fromZoom?: Number): Number
|
|
// Returns the scale factor to be applied to a map transition from zoom level
|
|
// `fromZoom` to `toZoom`. Used internally to help with zoom animations.
|
|
getZoomScale(toZoom, fromZoom) {
|
|
// TODO replace with universal implementation after refactoring projections
|
|
const crs = this.options.crs;
|
|
fromZoom ??= this._zoom;
|
|
return crs.scale(toZoom) / crs.scale(fromZoom);
|
|
}
|
|
|
|
// @method getScaleZoom(scale: Number, fromZoom?: Number): Number
|
|
// Returns the zoom level that the map would end up at, if it is at `fromZoom`
|
|
// level and everything is scaled by a factor of `scale`. Inverse of
|
|
// [`getZoomScale`](#map-getZoomScale).
|
|
getScaleZoom(scale, fromZoom) {
|
|
const crs = this.options.crs;
|
|
fromZoom ??= this._zoom;
|
|
const zoom = crs.zoom(scale * crs.scale(fromZoom));
|
|
return isNaN(zoom) ? Infinity : zoom;
|
|
}
|
|
|
|
// @method project(latlng: LatLng, zoom?: Number): Point
|
|
// Projects a geographical coordinate `LatLng` according to the projection
|
|
// of the map's CRS, then scales it according to `zoom` and the CRS's
|
|
// `Transformation`. The result is pixel coordinate relative to
|
|
// the CRS origin.
|
|
project(latlng, zoom) {
|
|
zoom ??= this._zoom;
|
|
return this.options.crs.latLngToPoint(new LatLng(latlng), zoom);
|
|
}
|
|
|
|
// @method unproject(point: Point, zoom?: Number): LatLng
|
|
// Inverse of [`project`](#map-project).
|
|
unproject(point, zoom) {
|
|
zoom ??= this._zoom;
|
|
return this.options.crs.pointToLatLng(new Point(point), zoom);
|
|
}
|
|
|
|
// @method layerPointToLatLng(point: Point): LatLng
|
|
// Given a pixel coordinate relative to the [origin pixel](#map-getpixelorigin),
|
|
// returns the corresponding geographical coordinate (for the current zoom level).
|
|
layerPointToLatLng(point) {
|
|
const projectedPoint = new Point(point).add(this.getPixelOrigin());
|
|
return this.unproject(projectedPoint);
|
|
}
|
|
|
|
// @method latLngToLayerPoint(latlng: LatLng): Point
|
|
// Given a geographical coordinate, returns the corresponding pixel coordinate
|
|
// relative to the [origin pixel](#map-getpixelorigin).
|
|
latLngToLayerPoint(latlng) {
|
|
const projectedPoint = this.project(new LatLng(latlng))._round();
|
|
return projectedPoint._subtract(this.getPixelOrigin());
|
|
}
|
|
|
|
// @method wrapLatLng(latlng: LatLng): LatLng
|
|
// Returns a `LatLng` where `lat` and `lng` has been wrapped according to the
|
|
// map's CRS's `wrapLat` and `wrapLng` properties, if they are outside the
|
|
// CRS's bounds.
|
|
// By default this means longitude is wrapped around the dateline so its
|
|
// value is between -180 and +180 degrees.
|
|
wrapLatLng(latlng) {
|
|
return this.options.crs.wrapLatLng(new LatLng(latlng));
|
|
}
|
|
|
|
// @method wrapLatLngBounds(bounds: LatLngBounds): LatLngBounds
|
|
// Returns a `LatLngBounds` with the same size as the given one, ensuring that
|
|
// its center is within the CRS's bounds.
|
|
// By default this means the center longitude is wrapped around the dateline so its
|
|
// value is between -180 and +180 degrees, and the majority of the bounds
|
|
// overlaps the CRS's bounds.
|
|
wrapLatLngBounds(bounds) {
|
|
return this.options.crs.wrapLatLngBounds(new LatLngBounds(bounds));
|
|
}
|
|
|
|
// @method distance(latlng1: LatLng, latlng2: LatLng): Number
|
|
// Returns the distance between two geographical coordinates according to
|
|
// the map's CRS. By default this measures distance in meters.
|
|
distance(latlng1, latlng2) {
|
|
return this.options.crs.distance(new LatLng(latlng1), new LatLng(latlng2));
|
|
}
|
|
|
|
// @method containerPointToLayerPoint(point: Point): Point
|
|
// Given a pixel coordinate relative to the map container, returns the corresponding
|
|
// pixel coordinate relative to the [origin pixel](#map-getpixelorigin).
|
|
containerPointToLayerPoint(point) { // (Point)
|
|
return new Point(point).subtract(this._getMapPanePos());
|
|
}
|
|
|
|
// @method layerPointToContainerPoint(point: Point): Point
|
|
// Given a pixel coordinate relative to the [origin pixel](#map-getpixelorigin),
|
|
// returns the corresponding pixel coordinate relative to the map container.
|
|
layerPointToContainerPoint(point) { // (Point)
|
|
return new Point(point).add(this._getMapPanePos());
|
|
}
|
|
|
|
// @method containerPointToLatLng(point: Point): LatLng
|
|
// Given a pixel coordinate relative to the map container, returns
|
|
// the corresponding geographical coordinate (for the current zoom level).
|
|
containerPointToLatLng(point) {
|
|
const layerPoint = this.containerPointToLayerPoint(new Point(point));
|
|
return this.layerPointToLatLng(layerPoint);
|
|
}
|
|
|
|
// @method latLngToContainerPoint(latlng: LatLng): Point
|
|
// Given a geographical coordinate, returns the corresponding pixel coordinate
|
|
// relative to the map container.
|
|
latLngToContainerPoint(latlng) {
|
|
return this.layerPointToContainerPoint(this.latLngToLayerPoint(new LatLng(latlng)));
|
|
}
|
|
|
|
// @method pointerEventToContainerPoint(ev: PointerEvent): Point
|
|
// Given a PointerEvent object, returns the pixel coordinate relative to the
|
|
// map container where the event took place.
|
|
pointerEventToContainerPoint(e) {
|
|
return getPointerPosition(e, this._container);
|
|
}
|
|
|
|
// @method pointerEventToLayerPoint(ev: PointerEvent): Point
|
|
// Given a PointerEvent object, returns the pixel coordinate relative to
|
|
// the [origin pixel](#map-getpixelorigin) where the event took place.
|
|
pointerEventToLayerPoint(e) {
|
|
return this.containerPointToLayerPoint(this.pointerEventToContainerPoint(e));
|
|
}
|
|
|
|
// @method pointerEventToLayerPoint(ev: PointerEvent): LatLng
|
|
// Given a PointerEvent object, returns geographical coordinate where the
|
|
// event took place.
|
|
pointerEventToLatLng(e) { // (PointerEvent)
|
|
return this.layerPointToLatLng(this.pointerEventToLayerPoint(e));
|
|
}
|
|
|
|
|
|
// map initialization methods
|
|
|
|
_initContainer(id) {
|
|
const container = this._container = get(id);
|
|
|
|
if (!container) {
|
|
throw new Error('Map container not found.');
|
|
} else if (container._leaflet_id) {
|
|
throw new Error('Map container is already initialized.');
|
|
}
|
|
|
|
on(container, 'scroll', this._onScroll, this);
|
|
this._containerId = stamp(container);
|
|
|
|
enablePointerDetection();
|
|
}
|
|
|
|
_initLayout() {
|
|
const container = this._container;
|
|
|
|
this._fadeAnimated = this.options.fadeAnimation;
|
|
|
|
const classes = ['leaflet-container', 'leaflet-touch'];
|
|
|
|
if (Browser.retina) { classes.push('leaflet-retina'); }
|
|
if (Browser.safari) { classes.push('leaflet-safari'); }
|
|
if (this._fadeAnimated) { classes.push('leaflet-fade-anim'); }
|
|
|
|
container.classList.add(...classes);
|
|
|
|
const {position} = getComputedStyle(container);
|
|
|
|
if (position !== 'absolute' && position !== 'relative' && position !== 'fixed' && position !== 'sticky') {
|
|
container.style.position = 'relative';
|
|
}
|
|
|
|
this._initPanes();
|
|
|
|
if (this._initControlPos) {
|
|
this._initControlPos();
|
|
}
|
|
}
|
|
|
|
_initPanes() {
|
|
const panes = this._panes = {};
|
|
this._paneRenderers = {};
|
|
|
|
// @section
|
|
//
|
|
// Panes are DOM elements used to control the ordering of layers on the map. You
|
|
// can access panes with [`map.getPane`](#map-getpane) or
|
|
// [`map.getPanes`](#map-getpanes) methods. New panes can be created with the
|
|
// [`map.createPane`](#map-createpane) method.
|
|
//
|
|
// Every map has the following default panes that differ only in zIndex.
|
|
//
|
|
// @pane mapPane: HTMLElement = 'auto'
|
|
// Pane that contains all other map panes
|
|
|
|
this._mapPane = this.createPane('mapPane', this._container);
|
|
setPosition(this._mapPane, new Point(0, 0));
|
|
|
|
// @pane tilePane: HTMLElement = 200
|
|
// Pane for `GridLayer`s and `TileLayer`s
|
|
this.createPane('tilePane');
|
|
// @pane overlayPane: HTMLElement = 400
|
|
// Pane for vectors (`Path`s, like `Polyline`s and `Polygon`s), `ImageOverlay`s and `VideoOverlay`s
|
|
this.createPane('overlayPane');
|
|
// @pane shadowPane: HTMLElement = 500
|
|
// Pane for overlay shadows (e.g. `Marker` shadows)
|
|
this.createPane('shadowPane');
|
|
// @pane markerPane: HTMLElement = 600
|
|
// Pane for `Icon`s of `Marker`s
|
|
this.createPane('markerPane');
|
|
// @pane tooltipPane: HTMLElement = 650
|
|
// Pane for `Tooltip`s.
|
|
this.createPane('tooltipPane');
|
|
// @pane popupPane: HTMLElement = 700
|
|
// Pane for `Popup`s.
|
|
this.createPane('popupPane');
|
|
|
|
if (!this.options.markerZoomAnimation) {
|
|
panes.markerPane.classList.add('leaflet-zoom-hide');
|
|
panes.shadowPane.classList.add('leaflet-zoom-hide');
|
|
}
|
|
}
|
|
|
|
|
|
// private methods that modify map state
|
|
|
|
// @section Map state change events
|
|
_resetView(center, zoom, noMoveStart) {
|
|
setPosition(this._mapPane, new Point(0, 0));
|
|
|
|
const loading = !this._loaded;
|
|
this._loaded = true;
|
|
zoom = this._limitZoom(zoom);
|
|
|
|
this.fire('viewprereset');
|
|
|
|
const zoomChanged = this._zoom !== zoom;
|
|
this
|
|
._moveStart(zoomChanged, noMoveStart)
|
|
._move(center, zoom)
|
|
._moveEnd(zoomChanged);
|
|
|
|
// @event viewreset: Event
|
|
// Fired when the map needs to redraw its content (this usually happens
|
|
// on map zoom or load). Very useful for creating custom overlays.
|
|
this.fire('viewreset');
|
|
|
|
// @event load: Event
|
|
// Fired when the map is initialized (when its center and zoom are set
|
|
// for the first time).
|
|
if (loading) {
|
|
this.fire('load');
|
|
}
|
|
}
|
|
|
|
_moveStart(zoomChanged, noMoveStart) {
|
|
// @event zoomstart: Event
|
|
// Fired when the map zoom is about to change (e.g. before zoom animation).
|
|
// @event movestart: Event
|
|
// Fired when the view of the map starts changing (e.g. user starts dragging the map).
|
|
if (zoomChanged) {
|
|
this.fire('zoomstart');
|
|
}
|
|
if (!noMoveStart) {
|
|
this.fire('movestart');
|
|
}
|
|
return this;
|
|
}
|
|
|
|
_move(center, zoom, data, supressEvent) {
|
|
if (zoom === undefined) {
|
|
zoom = this._zoom;
|
|
}
|
|
const zoomChanged = this._zoom !== zoom;
|
|
|
|
this._zoom = zoom;
|
|
this._lastCenter = center;
|
|
this._pixelOrigin = this._getNewPixelOrigin(center);
|
|
|
|
if (!supressEvent) {
|
|
// @event zoom: Event
|
|
// Fired repeatedly during any change in zoom level,
|
|
// including zoom and fly animations.
|
|
if (zoomChanged || (data?.pinch)) { // Always fire 'zoom' if pinching because #3530
|
|
this.fire('zoom', data);
|
|
}
|
|
|
|
// @event move: Event
|
|
// Fired repeatedly during any movement of the map,
|
|
// including pan and fly animations.
|
|
this.fire('move', data);
|
|
} else if (data?.pinch) { // Always fire 'zoom' if pinching because #3530
|
|
this.fire('zoom', data);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
_moveEnd(zoomChanged) {
|
|
// @event zoomend: Event
|
|
// Fired when the map zoom changed, after any animations.
|
|
if (zoomChanged) {
|
|
this.fire('zoomend');
|
|
}
|
|
|
|
// @event moveend: Event
|
|
// Fired when the center of the map stops changing
|
|
// (e.g. user stopped dragging the map or after non-centered zoom).
|
|
return this.fire('moveend');
|
|
}
|
|
|
|
_stop() {
|
|
cancelAnimationFrame(this._flyToFrame);
|
|
this._panAnim?.stop();
|
|
return this;
|
|
}
|
|
|
|
_rawPanBy(offset) {
|
|
setPosition(this._mapPane, this._getMapPanePos().subtract(offset));
|
|
}
|
|
|
|
_getZoomSpan() {
|
|
return this.getMaxZoom() - this.getMinZoom();
|
|
}
|
|
|
|
_panInsideMaxBounds() {
|
|
if (!this._enforcingBounds) {
|
|
this.panInsideBounds(this.options.maxBounds);
|
|
}
|
|
}
|
|
|
|
_checkIfLoaded() {
|
|
if (!this._loaded) {
|
|
throw new Error('Set map center and zoom first.');
|
|
}
|
|
}
|
|
|
|
// DOM event handling
|
|
|
|
// @section Interaction events
|
|
_initEvents(remove) {
|
|
this._targets = {};
|
|
this._targets[stamp(this._container)] = this;
|
|
|
|
const onOff = remove ? off : on;
|
|
|
|
// @event click: PointerEvent
|
|
// Fired when the user clicks (or taps) the map.
|
|
// @event dblclick: PointerEvent
|
|
// Fired when the user double-clicks (or double-taps) the map.
|
|
// @event pointerdown: PointerEvent
|
|
// Fired when the user pushes the pointer on the map.
|
|
// @event pointerup: PointerEvent
|
|
// Fired when the user releases the pointer on the map.
|
|
// @event pointerover: PointerEvent
|
|
// Fired when the pointer enters the map.
|
|
// @event pointerout: PointerEvent
|
|
// Fired when the pointer leaves the map.
|
|
// @event pointermove: PointerEvent
|
|
// Fired while the pointer moves over the map.
|
|
// @event contextmenu: PointerEvent
|
|
// Fired when the user pushes the right mouse button on the map, prevents
|
|
// default browser context menu from showing if there are listeners on
|
|
// this event. Also fired on mobile when the user holds a single touch
|
|
// for a second (also called long press).
|
|
// @event keypress: KeyboardEvent
|
|
// Fired when the user presses a key from the keyboard that produces a character value while the map is focused.
|
|
// @event keydown: KeyboardEvent
|
|
// Fired when the user presses a key from the keyboard while the map is focused. Unlike the `keypress` event,
|
|
// the `keydown` event is fired for keys that produce a character value and for keys
|
|
// that do not produce a character value.
|
|
// @event keyup: KeyboardEvent
|
|
// Fired when the user releases a key from the keyboard while the map is focused.
|
|
onOff(this._container, 'click dblclick pointerdown pointerup ' +
|
|
'pointerover pointerout pointermove contextmenu keypress keydown keyup', this._handleDOMEvent, this);
|
|
|
|
if (this.options.trackResize) {
|
|
if (!remove) {
|
|
if (!this._resizeObserver) {
|
|
this._resizeObserver = new ResizeObserver(this._onResize.bind(this));
|
|
}
|
|
this._resizeObserver.observe(this._container);
|
|
} else {
|
|
this._resizeObserver.disconnect();
|
|
}
|
|
}
|
|
|
|
if (this.options.transform3DLimit) {
|
|
(remove ? this.off : this.on).call(this, 'moveend', this._onMoveEnd);
|
|
}
|
|
}
|
|
|
|
_onResize() {
|
|
cancelAnimationFrame(this._resizeRequest);
|
|
this._resizeRequest = requestAnimationFrame(() => { this.invalidateSize({debounceMoveend: true}); });
|
|
}
|
|
|
|
_onScroll() {
|
|
this._container.scrollTop = 0;
|
|
this._container.scrollLeft = 0;
|
|
}
|
|
|
|
_onMoveEnd() {
|
|
const pos = this._getMapPanePos();
|
|
if (Math.max(Math.abs(pos.x), Math.abs(pos.y)) >= this.options.transform3DLimit) {
|
|
// https://bugzilla.mozilla.org/show_bug.cgi?id=1203873 but Webkit also have
|
|
// a pixel offset on very high values, see: https://jsfiddle.net/dg6r5hhb/
|
|
this._resetView(this.getCenter(), this.getZoom());
|
|
}
|
|
}
|
|
|
|
_findEventTargets(e, type) {
|
|
let targets = [],
|
|
target,
|
|
src = e.target || e.srcElement,
|
|
dragging = false;
|
|
const isHover = type === 'pointerout' || type === 'pointerover';
|
|
|
|
while (src) {
|
|
target = this._targets[stamp(src)];
|
|
if (target && (type === 'click' || type === 'preclick') && this._draggableMoved(target)) {
|
|
// Prevent firing click after you just dragged an object.
|
|
dragging = true;
|
|
break;
|
|
}
|
|
if (target && target.listens(type, true)) {
|
|
if (isHover && !isExternalTarget(src, e)) { break; }
|
|
targets.push(target);
|
|
if (isHover) { break; }
|
|
}
|
|
if (src === this._container) { break; }
|
|
src = src.parentNode;
|
|
}
|
|
if (!targets.length && !dragging && !isHover && this.listens(type, true)) {
|
|
targets = [this];
|
|
}
|
|
return targets;
|
|
}
|
|
|
|
_isClickDisabled(el) {
|
|
while (el && el !== this._container) {
|
|
if (el['_leaflet_disable_click'] || !el.parentNode) { return true; }
|
|
el = el.parentNode;
|
|
}
|
|
}
|
|
|
|
_handleDOMEvent(e) {
|
|
const el = e.target ?? e.srcElement;
|
|
if (!this._loaded || el['_leaflet_disable_events'] || e.type === 'click' && this._isClickDisabled(el)) {
|
|
return;
|
|
}
|
|
|
|
const type = e.type;
|
|
|
|
if (type === 'pointerdown') {
|
|
// prevents outline when clicking on keyboard-focusable element
|
|
preventOutline(el);
|
|
}
|
|
|
|
this._fireDOMEvent(e, type);
|
|
};
|
|
|
|
static _pointerEvents = ['click', 'dblclick', 'pointerover', 'pointerout', 'contextmenu'];
|
|
|
|
_fireDOMEvent(e, type, canvasTargets) {
|
|
|
|
if (type === 'click') {
|
|
// Fire a synthetic 'preclick' event which propagates up (mainly for closing popups).
|
|
// @event preclick: PointerEvent
|
|
// Fired before pointer click on the map (sometimes useful when you
|
|
// want something to happen on click before any existing click
|
|
// handlers start running).
|
|
this._fireDOMEvent(e, 'preclick', canvasTargets);
|
|
}
|
|
|
|
// Find the layer the event is propagating from and its parents.
|
|
let targets = this._findEventTargets(e, type);
|
|
|
|
if (canvasTargets) {
|
|
// pick only targets with listeners
|
|
const filtered = canvasTargets.filter(t => t.listens(type, true));
|
|
targets = filtered.concat(targets);
|
|
}
|
|
|
|
if (!targets.length) { return; }
|
|
|
|
if (type === 'contextmenu') {
|
|
preventDefault(e);
|
|
}
|
|
|
|
const target = targets[0];
|
|
const data = {
|
|
originalEvent: e
|
|
};
|
|
|
|
if (e.type !== 'keypress' && e.type !== 'keydown' && e.type !== 'keyup') {
|
|
const isMarker = target.getLatLng && (!target._radius || target._radius <= 10);
|
|
data.containerPoint = isMarker ?
|
|
this.latLngToContainerPoint(target.getLatLng()) : this.pointerEventToContainerPoint(e);
|
|
data.layerPoint = this.containerPointToLayerPoint(data.containerPoint);
|
|
data.latlng = isMarker ? target.getLatLng() : this.layerPointToLatLng(data.layerPoint);
|
|
}
|
|
|
|
for (const t of targets) {
|
|
t.fire(type, data, true);
|
|
if (data.originalEvent._stopped ||
|
|
(t.options.bubblingPointerEvents === false && Map._pointerEvents.includes(type))) { return; }
|
|
}
|
|
}
|
|
|
|
_draggableMoved(obj) {
|
|
obj = obj.dragging?.enabled() ? obj : this;
|
|
return obj.dragging?.moved() || this.boxZoom?.moved();
|
|
}
|
|
|
|
_clearHandlers() {
|
|
for (const handler of this._handlers) {
|
|
handler.disable();
|
|
}
|
|
}
|
|
|
|
// @section Other Methods
|
|
|
|
// @method whenReady(fn: Function, context?: Object): this
|
|
// Runs the given function `fn` when the map gets initialized with
|
|
// a view (center and zoom) and at least one layer, or immediately
|
|
// if it's already initialized, optionally passing a function context.
|
|
whenReady(callback, context) {
|
|
if (this._loaded) {
|
|
callback.call(context || this, {target: this});
|
|
} else {
|
|
this.on('load', callback, context);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
|
|
// private methods for getting map state
|
|
|
|
_getMapPanePos() {
|
|
return getPosition(this._mapPane);
|
|
}
|
|
|
|
_moved() {
|
|
const pos = this._getMapPanePos();
|
|
return pos && !pos.equals([0, 0]);
|
|
}
|
|
|
|
_getTopLeftPoint(center, zoom) {
|
|
const pixelOrigin = center && zoom !== undefined ?
|
|
this._getNewPixelOrigin(center, zoom) :
|
|
this.getPixelOrigin();
|
|
return pixelOrigin.subtract(this._getMapPanePos());
|
|
}
|
|
|
|
_getNewPixelOrigin(center, zoom) {
|
|
const viewHalf = this.getSize()._divideBy(2);
|
|
return this.project(center, zoom)._subtract(viewHalf)._add(this._getMapPanePos())._round();
|
|
}
|
|
|
|
_latLngToNewLayerPoint(latlng, zoom, center) {
|
|
const topLeft = this._getNewPixelOrigin(center, zoom);
|
|
return this.project(latlng, zoom)._subtract(topLeft);
|
|
}
|
|
|
|
_latLngBoundsToNewLayerBounds(latLngBounds, zoom, center) {
|
|
const topLeft = this._getNewPixelOrigin(center, zoom);
|
|
return new Bounds([
|
|
this.project(latLngBounds.getSouthWest(), zoom)._subtract(topLeft),
|
|
this.project(latLngBounds.getNorthWest(), zoom)._subtract(topLeft),
|
|
this.project(latLngBounds.getSouthEast(), zoom)._subtract(topLeft),
|
|
this.project(latLngBounds.getNorthEast(), zoom)._subtract(topLeft)
|
|
]);
|
|
}
|
|
|
|
// layer point of the current center
|
|
_getCenterLayerPoint() {
|
|
return this.containerPointToLayerPoint(this.getSize()._divideBy(2));
|
|
}
|
|
|
|
// offset of the specified place to the current center in pixels
|
|
_getCenterOffset(latlng) {
|
|
return this.latLngToLayerPoint(latlng).subtract(this._getCenterLayerPoint());
|
|
}
|
|
|
|
// adjust center for view to get inside bounds
|
|
_limitCenter(center, zoom, bounds) {
|
|
|
|
if (!bounds) { return center; }
|
|
|
|
const centerPoint = this.project(center, zoom),
|
|
viewHalf = this.getSize().divideBy(2),
|
|
viewBounds = new Bounds(centerPoint.subtract(viewHalf), centerPoint.add(viewHalf)),
|
|
offset = this._getBoundsOffset(viewBounds, bounds, zoom);
|
|
|
|
// If offset is less than a pixel, ignore.
|
|
// This prevents unstable projections from getting into
|
|
// an infinite loop of tiny offsets.
|
|
if (Math.abs(offset.x) <= 1 && Math.abs(offset.y) <= 1) {
|
|
return center;
|
|
}
|
|
|
|
return this.unproject(centerPoint.add(offset), zoom);
|
|
}
|
|
|
|
// adjust offset for view to get inside bounds
|
|
_limitOffset(offset, bounds) {
|
|
if (!bounds) { return offset; }
|
|
|
|
const viewBounds = this.getPixelBounds(),
|
|
newBounds = new Bounds(viewBounds.min.add(offset), viewBounds.max.add(offset));
|
|
|
|
return offset.add(this._getBoundsOffset(newBounds, bounds));
|
|
}
|
|
|
|
// returns offset needed for pxBounds to get inside maxBounds at a specified zoom
|
|
_getBoundsOffset(pxBounds, maxBounds, zoom) {
|
|
const projectedMaxBounds = new Bounds(
|
|
this.project(maxBounds.getNorthEast(), zoom),
|
|
this.project(maxBounds.getSouthWest(), zoom)
|
|
),
|
|
minOffset = projectedMaxBounds.min.subtract(pxBounds.min),
|
|
maxOffset = projectedMaxBounds.max.subtract(pxBounds.max),
|
|
|
|
dx = this._rebound(minOffset.x, -maxOffset.x),
|
|
dy = this._rebound(minOffset.y, -maxOffset.y);
|
|
|
|
return new Point(dx, dy);
|
|
}
|
|
|
|
_rebound(left, right) {
|
|
return left + right > 0 ?
|
|
Math.round(left - right) / 2 :
|
|
Math.max(0, Math.ceil(left)) - Math.max(0, Math.floor(right));
|
|
}
|
|
|
|
_limitZoom(zoom) {
|
|
const min = this.getMinZoom(),
|
|
max = this.getMaxZoom(),
|
|
snap = this.options.zoomSnap;
|
|
if (snap) {
|
|
zoom = Math.round(zoom / snap) * snap;
|
|
}
|
|
return Math.max(min, Math.min(max, zoom));
|
|
}
|
|
|
|
_onPanTransitionStep() {
|
|
this.fire('move');
|
|
}
|
|
|
|
_onPanTransitionEnd() {
|
|
this._mapPane.classList.remove('leaflet-pan-anim');
|
|
this.fire('moveend');
|
|
}
|
|
|
|
_tryAnimatedPan(center, options) {
|
|
// difference between the new and current centers in pixels
|
|
const offset = this._getCenterOffset(center)._trunc();
|
|
|
|
// don't animate too far unless animate: true specified in options
|
|
if (options?.animate !== true && !this.getSize().contains(offset)) { return false; }
|
|
|
|
this.panBy(offset, options);
|
|
|
|
return true;
|
|
}
|
|
|
|
_createAnimProxy() {
|
|
this._proxy = create$1('div', 'leaflet-proxy leaflet-zoom-animated');
|
|
this._panes.mapPane.appendChild(this._proxy);
|
|
|
|
this.on('zoomanim', this._animateProxyZoom, this);
|
|
this.on('load moveend', this._animMoveEnd, this);
|
|
|
|
on(this._proxy, 'transitionend', this._catchTransitionEnd, this);
|
|
}
|
|
|
|
_animateProxyZoom(e) {
|
|
const transform = this._proxy.style.transform;
|
|
|
|
setTransform(
|
|
this._proxy,
|
|
this.project(e.center, e.zoom),
|
|
this.getZoomScale(e.zoom, 1),
|
|
);
|
|
|
|
// workaround for case when transform is the same and so transitionend event is not fired
|
|
if (transform === this._proxy.style.transform && this._animatingZoom) {
|
|
this._onZoomTransitionEnd();
|
|
}
|
|
}
|
|
|
|
_animMoveEnd() {
|
|
const c = this.getCenter();
|
|
const z = this.getZoom();
|
|
|
|
|
|
|
|
setTransform(
|
|
this._proxy,
|
|
this.project(c, z),
|
|
this.getZoomScale(z, 1),
|
|
);
|
|
}
|
|
|
|
_destroyAnimProxy() {
|
|
// Just make sure this method is safe to call from anywhere, without knowledge
|
|
// of whether the animation proxy was created in the first place.
|
|
if (this._proxy) {
|
|
off(this._proxy, 'transitionend', this._catchTransitionEnd, this);
|
|
|
|
this._proxy.remove();
|
|
this.off('zoomanim', this._animateProxyZoom, this);
|
|
this.off('load moveend', this._animMoveEnd, this);
|
|
|
|
delete this._proxy;
|
|
}
|
|
}
|
|
|
|
_catchTransitionEnd(e) {
|
|
if (this._animatingZoom && e.propertyName.includes('transform')) {
|
|
this._onZoomTransitionEnd();
|
|
}
|
|
}
|
|
|
|
_nothingToAnimate() {
|
|
return !this._container.getElementsByClassName('leaflet-zoom-animated').length;
|
|
}
|
|
|
|
_tryAnimatedZoom(center, zoom, options) {
|
|
|
|
if (this._animatingZoom) { return true; }
|
|
|
|
options ??= {};
|
|
|
|
// don't animate if disabled, not supported or zoom difference is too large
|
|
if (!this._zoomAnimated || options.animate === false || this._nothingToAnimate() ||
|
|
Math.abs(zoom - this._zoom) > this.options.zoomAnimationThreshold) { return false; }
|
|
|
|
// offset is the pixel coords of the zoom origin relative to the current center
|
|
const scale = this.getZoomScale(zoom),
|
|
offset = this._getCenterOffset(center)._divideBy(1 - 1 / scale);
|
|
|
|
// don't animate if the zoom origin isn't within one screen from the current center, unless forced
|
|
if (options.animate !== true && !this.getSize().contains(offset)) { return false; }
|
|
|
|
requestAnimationFrame(() => {
|
|
this
|
|
._moveStart(true, options.noMoveStart ?? false)
|
|
._animateZoom(center, zoom, true);
|
|
});
|
|
|
|
return true;
|
|
}
|
|
|
|
_animateZoom(center, zoom, startAnim, noUpdate) {
|
|
if (!this._mapPane) { return; }
|
|
|
|
if (startAnim) {
|
|
this._animatingZoom = true;
|
|
|
|
// remember what center/zoom to set after animation
|
|
this._animateToCenter = center;
|
|
this._animateToZoom = zoom;
|
|
|
|
this._mapPane.classList.add('leaflet-zoom-anim');
|
|
}
|
|
|
|
// @section Other Events
|
|
// @event zoomanim: ZoomAnimEvent
|
|
// Fired at least once per zoom animation. For continuous zoom, like pinch zooming, fired once per frame during zoom.
|
|
this.fire('zoomanim', {
|
|
center,
|
|
zoom,
|
|
noUpdate
|
|
});
|
|
|
|
if (!this._tempFireZoomEvent) {
|
|
this._tempFireZoomEvent = this._zoom !== this._animateToZoom;
|
|
}
|
|
|
|
this._move(this._animateToCenter, this._animateToZoom, undefined, true);
|
|
|
|
// Work around webkit not firing 'transitionend', see https://github.com/Leaflet/Leaflet/issues/3689, 2693
|
|
this._transitionEndTimer = setTimeout(this._onZoomTransitionEnd.bind(this), 250);
|
|
}
|
|
|
|
_onZoomTransitionEnd() {
|
|
if (!this._animatingZoom) { return; }
|
|
|
|
this._mapPane?.classList.remove('leaflet-zoom-anim');
|
|
|
|
this._animatingZoom = false;
|
|
|
|
this._move(this._animateToCenter, this._animateToZoom, undefined, true);
|
|
|
|
if (this._tempFireZoomEvent) {
|
|
this.fire('zoom');
|
|
}
|
|
delete this._tempFireZoomEvent;
|
|
|
|
this.fire('move');
|
|
|
|
this._moveEnd(true);
|
|
}
|
|
};
|
|
|
|
const LeafletMap = Map$1;
|
|
|
|
/*
|
|
* @class Control
|
|
* @inherits Class
|
|
*
|
|
* Control is a base class for implementing map controls. Handles positioning.
|
|
* All other controls extend from this class.
|
|
*/
|
|
|
|
class Control extends Class {
|
|
|
|
static {
|
|
// @section
|
|
// @aka Control Options
|
|
this.setDefaultOptions({
|
|
// @option position: String = 'topright'
|
|
// The position of the control (one of the map corners). Possible values are `'topleft'`,
|
|
// `'topright'`, `'bottomleft'` or `'bottomright'`
|
|
position: 'topright'
|
|
});
|
|
}
|
|
|
|
|
|
initialize(options) {
|
|
setOptions(this, options);
|
|
}
|
|
|
|
/* @section
|
|
* Classes extending Control will inherit the following methods:
|
|
*
|
|
* @method getPosition: string
|
|
* Returns the position of the control.
|
|
*/
|
|
getPosition() {
|
|
return this.options.position;
|
|
}
|
|
|
|
// @method setPosition(position: string): this
|
|
// Sets the position of the control.
|
|
setPosition(position) {
|
|
const map = this._map;
|
|
|
|
map?.removeControl(this);
|
|
|
|
this.options.position = position;
|
|
|
|
map?.addControl(this);
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method getContainer: HTMLElement
|
|
// Returns the HTMLElement that contains the control.
|
|
getContainer() {
|
|
return this._container;
|
|
}
|
|
|
|
// @method addTo(map: Map): this
|
|
// Adds the control to the given map.
|
|
addTo(map) {
|
|
this.remove();
|
|
this._map = map;
|
|
|
|
const container = this._container = this.onAdd(map),
|
|
pos = this.getPosition(),
|
|
corner = map._controlCorners[pos];
|
|
|
|
container.classList.add('leaflet-control');
|
|
|
|
if (pos.includes('bottom')) {
|
|
corner.insertBefore(container, corner.firstChild);
|
|
} else {
|
|
corner.appendChild(container);
|
|
}
|
|
|
|
this._map.on('unload', this.remove, this);
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method remove: this
|
|
// Removes the control from the map it is currently active on.
|
|
remove() {
|
|
if (!this._map) {
|
|
return this;
|
|
}
|
|
|
|
this._container.remove();
|
|
|
|
if (this.onRemove) {
|
|
this.onRemove(this._map);
|
|
}
|
|
|
|
this._map.off('unload', this.remove, this);
|
|
this._map = null;
|
|
|
|
return this;
|
|
}
|
|
|
|
_refocusOnMap(e) {
|
|
// We exclude keyboard-click event to keep the focus on the control for accessibility.
|
|
// The position of keyboard-click events are x=0 and y=0.
|
|
if (this._map && e && !(e.screenX === 0 && e.screenY === 0)) {
|
|
this._map.getContainer().focus();
|
|
}
|
|
}
|
|
}
|
|
|
|
/* @section Extension methods
|
|
* @uninheritable
|
|
*
|
|
* Every control should extend from `Control` and (re-)implement the following methods.
|
|
*
|
|
* @method onAdd(map: Map): HTMLElement
|
|
* Should return the container DOM element for the control and add listeners on relevant map events. Called on [`control.addTo(map)`](#control-addTo).
|
|
*
|
|
* @method onRemove(map: Map)
|
|
* Optional method. Should contain all clean up code that removes the listeners previously added in [`onAdd`](#control-onadd). Called on [`control.remove()`](#control-remove).
|
|
*/
|
|
|
|
/* @namespace Map
|
|
* @section Methods for Layers and Controls
|
|
*/
|
|
Map$1.include({
|
|
// @method addControl(control: Control): this
|
|
// Adds the given control to the map
|
|
addControl(control) {
|
|
control.addTo(this);
|
|
return this;
|
|
},
|
|
|
|
// @method removeControl(control: Control): this
|
|
// Removes the given control from the map
|
|
removeControl(control) {
|
|
control.remove();
|
|
return this;
|
|
},
|
|
|
|
_initControlPos() {
|
|
const corners = this._controlCorners = {},
|
|
l = 'leaflet-',
|
|
container = this._controlContainer =
|
|
create$1('div', `${l}control-container`, this._container);
|
|
|
|
function createCorner(vSide, hSide) {
|
|
const className = `${l + vSide} ${l}${hSide}`;
|
|
|
|
corners[vSide + hSide] = create$1('div', className, container);
|
|
}
|
|
|
|
createCorner('top', 'left');
|
|
createCorner('top', 'right');
|
|
createCorner('bottom', 'left');
|
|
createCorner('bottom', 'right');
|
|
},
|
|
|
|
_clearControlPos() {
|
|
for (const c of Object.values(this._controlCorners)) {
|
|
c.remove();
|
|
}
|
|
this._controlContainer.remove();
|
|
delete this._controlCorners;
|
|
delete this._controlContainer;
|
|
}
|
|
});
|
|
|
|
/*
|
|
* @class Control.Layers
|
|
* @inherits Control
|
|
*
|
|
* The layers control gives users the ability to switch between different base layers and switch overlays on/off (check out the [detailed example](https://leafletjs.com/examples/layers-control/)). Extends `Control`.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* const baseLayers = {
|
|
* "Mapbox": mapbox,
|
|
* "OpenStreetMap": osm
|
|
* };
|
|
*
|
|
* const overlays = {
|
|
* "Marker": marker,
|
|
* "Roads": roadsLayer
|
|
* };
|
|
*
|
|
* new Control.Layers(baseLayers, overlays).addTo(map);
|
|
* ```
|
|
*
|
|
* The `baseLayers` and `overlays` parameters are object literals with layer names as keys and `Layer` objects as values:
|
|
*
|
|
* ```js
|
|
* {
|
|
* "<someName1>": layer1,
|
|
* "<someName2>": layer2
|
|
* }
|
|
* ```
|
|
*
|
|
* The layer names can contain HTML, which allows you to add additional styling to the items:
|
|
*
|
|
* ```js
|
|
* {"<img src='my-layer-icon' /> <span class='my-layer-item'>My Layer</span>": myLayer}
|
|
* ```
|
|
*/
|
|
|
|
// @constructor Control.Layers(baselayers?: Object, overlays?: Object, options?: Control.Layers options)
|
|
// Creates a layers control with the given layers. Base layers will be switched with radio buttons, while overlays will be switched with checkboxes. Note that all base layers should be passed in the base layers object, but only one should be added to the map during map instantiation.
|
|
class Layers extends Control {
|
|
|
|
static {
|
|
// @section
|
|
// @aka Control.Layers options
|
|
this.setDefaultOptions({
|
|
// @option collapsed: Boolean = true
|
|
// If `true`, the control will be collapsed into an icon and expanded on pointer hover, touch, or keyboard activation.
|
|
collapsed: true,
|
|
|
|
// @option collapseDelay: Number = 0
|
|
// Collapse delay in milliseconds. If greater than 0, the control will remain open longer, making it easier to scroll through long layer lists.
|
|
collapseDelay: 0,
|
|
|
|
position: 'topright',
|
|
|
|
// @option autoZIndex: Boolean = true
|
|
// If `true`, the control will assign zIndexes in increasing order to all of its layers so that the order is preserved when switching them on/off.
|
|
autoZIndex: true,
|
|
|
|
// @option hideSingleBase: Boolean = false
|
|
// If `true`, the base layers in the control will be hidden when there is only one.
|
|
hideSingleBase: false,
|
|
|
|
// @option sortLayers: Boolean = false
|
|
// Whether to sort the layers. When `false`, layers will keep the order
|
|
// in which they were added to the control.
|
|
sortLayers: false,
|
|
|
|
// @option sortFunction: Function = *
|
|
// A [compare function](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/sort)
|
|
// that will be used for sorting the layers, when `sortLayers` is `true`.
|
|
// The function receives both the `Layer` instances and their names, as in
|
|
// `sortFunction(layerA, layerB, nameA, nameB)`.
|
|
// By default, it sorts layers alphabetically by their name.
|
|
sortFunction(layerA, layerB, nameA, nameB) {
|
|
return nameA < nameB ? -1 : (nameB < nameA ? 1 : 0);
|
|
}
|
|
});
|
|
}
|
|
|
|
initialize(baseLayers, overlays, options) {
|
|
setOptions(this, options);
|
|
|
|
this._layerControlInputs = [];
|
|
this._layers = [];
|
|
this._lastZIndex = 0;
|
|
this._handlingClick = false;
|
|
this._preventClick = false;
|
|
|
|
for (const [name, layer] of Object.entries(baseLayers ?? {})) {
|
|
this._addLayer(layer, name);
|
|
}
|
|
|
|
for (const [name, layer] of Object.entries(overlays ?? {})) {
|
|
this._addLayer(layer, name, true);
|
|
}
|
|
}
|
|
|
|
onAdd(map) {
|
|
this._initLayout();
|
|
this._update();
|
|
|
|
this._map = map;
|
|
map.on('zoomend', this._checkDisabledLayers, this);
|
|
|
|
for (const layer of this._layers) {
|
|
layer.layer.on('add remove', this._onLayerChange, this);
|
|
}
|
|
|
|
if (!this.options.collapsed) {
|
|
// update the height of the container after resizing the window
|
|
map.on('resize', this._expandIfNotCollapsed, this);
|
|
}
|
|
|
|
return this._container;
|
|
}
|
|
|
|
addTo(map) {
|
|
Control.prototype.addTo.call(this, map);
|
|
// Trigger expand after Layers Control has been inserted into DOM so that is now has an actual height.
|
|
return this._expandIfNotCollapsed();
|
|
}
|
|
|
|
onRemove() {
|
|
this._map.off('zoomend', this._checkDisabledLayers, this);
|
|
|
|
for (const layer of this._layers) {
|
|
layer.layer.off('add remove', this._onLayerChange, this);
|
|
}
|
|
|
|
this._map.off('resize', this._expandIfNotCollapsed, this);
|
|
}
|
|
|
|
// @method addBaseLayer(layer: Layer, name: String): this
|
|
// Adds a base layer (radio button entry) with the given name to the control.
|
|
addBaseLayer(layer, name) {
|
|
this._addLayer(layer, name);
|
|
return (this._map) ? this._update() : this;
|
|
}
|
|
|
|
// @method addOverlay(layer: Layer, name: String): this
|
|
// Adds an overlay (checkbox entry) with the given name to the control.
|
|
addOverlay(layer, name) {
|
|
this._addLayer(layer, name, true);
|
|
return (this._map) ? this._update() : this;
|
|
}
|
|
|
|
// @method removeLayer(layer: Layer): this
|
|
// Remove the given layer from the control.
|
|
removeLayer(layer) {
|
|
layer.off('add remove', this._onLayerChange, this);
|
|
|
|
const obj = this._getLayer(stamp(layer));
|
|
if (obj) {
|
|
this._layers.splice(this._layers.indexOf(obj), 1);
|
|
}
|
|
return (this._map) ? this._update() : this;
|
|
}
|
|
|
|
// @method expand(): this
|
|
// Expand the control container if collapsed.
|
|
expand() {
|
|
clearTimeout(this._collapseDelayTimeout);
|
|
|
|
this._container.classList.add('leaflet-control-layers-expanded');
|
|
this._section.style.height = null;
|
|
const acceptableHeight = this._map.getSize().y - (this._container.offsetTop + 50);
|
|
if (acceptableHeight < this._section.clientHeight) {
|
|
this._section.classList.add('leaflet-control-layers-scrollbar');
|
|
this._section.style.height = `${acceptableHeight}px`;
|
|
} else {
|
|
this._section.classList.remove('leaflet-control-layers-scrollbar');
|
|
}
|
|
this._checkDisabledLayers();
|
|
return this;
|
|
}
|
|
|
|
// @method collapse(): this
|
|
// Collapse the control container if expanded.
|
|
collapse(ev) {
|
|
// On touch devices `pointerleave` & `pointerout` is fired while clicking on a checkbox.
|
|
// The control was collapsed instead of adding the layer to the map.
|
|
// So we allow collapse only if it is not touch.
|
|
if (!ev || !((ev.type === 'pointerleave' || ev.type === 'pointerout') && ev.pointerType === 'touch')) {
|
|
if (this.options.collapseDelay > 0) {
|
|
// Collapse delayed
|
|
this._collapseDelayTimeout = setTimeout(() => {
|
|
this._container.classList.remove('leaflet-control-layers-expanded');
|
|
}, this.options.collapseDelay);
|
|
return this;
|
|
}
|
|
|
|
// Collapse immediatelly
|
|
this._container.classList.remove('leaflet-control-layers-expanded');
|
|
}
|
|
return this;
|
|
}
|
|
|
|
_initLayout() {
|
|
const className = 'leaflet-control-layers',
|
|
container = this._container = create$1('div', className),
|
|
collapsed = this.options.collapsed;
|
|
|
|
disableClickPropagation(container);
|
|
disableScrollPropagation(container);
|
|
|
|
const section = this._section = create$1('fieldset', `${className}-list`);
|
|
|
|
if (collapsed) {
|
|
this._map.on('click', this.collapse, this);
|
|
|
|
on(container, {
|
|
pointerenter: this._expandSafely,
|
|
pointerleave: this.collapse
|
|
}, this);
|
|
}
|
|
|
|
const link = this._layersLink = create$1('a', `${className}-toggle`, container);
|
|
link.href = '#';
|
|
link.title = 'Layers';
|
|
link.setAttribute('role', 'button');
|
|
|
|
on(link, {
|
|
keydown(e) {
|
|
if (e.code === 'Enter') {
|
|
this._expandSafely();
|
|
}
|
|
},
|
|
// Certain screen readers intercept the key event and instead send a click event
|
|
click(e) {
|
|
preventDefault(e);
|
|
this._expandSafely();
|
|
}
|
|
}, this);
|
|
|
|
if (!collapsed) {
|
|
this.expand();
|
|
}
|
|
|
|
this._baseLayersList = create$1('div', `${className}-base`, section);
|
|
this._separator = create$1('div', `${className}-separator`, section);
|
|
this._overlaysList = create$1('div', `${className}-overlays`, section);
|
|
|
|
container.appendChild(section);
|
|
}
|
|
|
|
_getLayer(id) {
|
|
for (const layer of this._layers) {
|
|
if (layer && stamp(layer.layer) === id) {
|
|
return layer;
|
|
}
|
|
}
|
|
}
|
|
|
|
_addLayer(layer, name, overlay) {
|
|
if (this._map) {
|
|
layer.on('add remove', this._onLayerChange, this);
|
|
}
|
|
|
|
this._layers.push({
|
|
layer,
|
|
name,
|
|
overlay
|
|
});
|
|
|
|
if (this.options.sortLayers) {
|
|
this._layers.sort(((a, b) => this.options.sortFunction(a.layer, b.layer, a.name, b.name)));
|
|
}
|
|
|
|
if (this.options.autoZIndex && layer.setZIndex) {
|
|
this._lastZIndex++;
|
|
layer.setZIndex(this._lastZIndex);
|
|
}
|
|
|
|
this._expandIfNotCollapsed();
|
|
}
|
|
|
|
_update() {
|
|
if (!this._container) { return this; }
|
|
|
|
this._baseLayersList.replaceChildren();
|
|
this._overlaysList.replaceChildren();
|
|
|
|
this._layerControlInputs = [];
|
|
let baseLayersPresent, overlaysPresent, baseLayersCount = 0;
|
|
|
|
for (const obj of this._layers) {
|
|
this._addItem(obj);
|
|
overlaysPresent ||= obj.overlay;
|
|
baseLayersPresent ||= !obj.overlay;
|
|
baseLayersCount += !obj.overlay ? 1 : 0;
|
|
}
|
|
|
|
// Hide base layers section if there's only one layer.
|
|
if (this.options.hideSingleBase) {
|
|
baseLayersPresent = baseLayersPresent && baseLayersCount > 1;
|
|
this._baseLayersList.style.display = baseLayersPresent ? '' : 'none';
|
|
}
|
|
|
|
this._separator.style.display = overlaysPresent && baseLayersPresent ? '' : 'none';
|
|
|
|
return this;
|
|
}
|
|
|
|
_onLayerChange(e) {
|
|
if (!this._handlingClick) {
|
|
this._update();
|
|
}
|
|
|
|
const obj = this._getLayer(stamp(e.target));
|
|
|
|
// @namespace Map
|
|
// @section Layer events
|
|
// @event baselayerchange: LayersControlEvent
|
|
// Fired when the base layer is changed through the [layers control](#control-layers).
|
|
// @event overlayadd: LayersControlEvent
|
|
// Fired when an overlay is selected through the [layers control](#control-layers).
|
|
// @event overlayremove: LayersControlEvent
|
|
// Fired when an overlay is deselected through the [layers control](#control-layers).
|
|
// @namespace Control.Layers
|
|
const type = obj.overlay ?
|
|
(e.type === 'add' ? 'overlayadd' : 'overlayremove') :
|
|
(e.type === 'add' ? 'baselayerchange' : null);
|
|
|
|
if (type) {
|
|
this._map.fire(type, obj);
|
|
}
|
|
}
|
|
|
|
_addItem(obj) {
|
|
const label = document.createElement('label'),
|
|
checked = this._map.hasLayer(obj.layer);
|
|
|
|
const input = document.createElement('input');
|
|
input.type = obj.overlay ? 'checkbox' : 'radio';
|
|
input.className = 'leaflet-control-layers-selector';
|
|
input.defaultChecked = checked;
|
|
if (!obj.overlay) {
|
|
input.name = `leaflet-base-layers_${stamp(this)}`;
|
|
}
|
|
|
|
this._layerControlInputs.push(input);
|
|
input.layerId = stamp(obj.layer);
|
|
|
|
on(input, 'click', this._onInputClick, this);
|
|
|
|
const name = document.createElement('span');
|
|
name.innerHTML = ` ${obj.name}`;
|
|
|
|
// Helps from preventing layer control flicker when checkboxes are disabled
|
|
// https://github.com/Leaflet/Leaflet/issues/2771
|
|
const holder = document.createElement('span');
|
|
|
|
label.appendChild(holder);
|
|
holder.appendChild(input);
|
|
holder.appendChild(name);
|
|
|
|
const container = obj.overlay ? this._overlaysList : this._baseLayersList;
|
|
container.appendChild(label);
|
|
|
|
this._checkDisabledLayers();
|
|
return label;
|
|
}
|
|
|
|
_onInputClick(e) {
|
|
// expanding the control on mobile with a click can cause adding a layer - we don't want this
|
|
if (this._preventClick) {
|
|
return;
|
|
}
|
|
|
|
const inputs = this._layerControlInputs,
|
|
addedLayers = [],
|
|
removedLayers = [];
|
|
|
|
this._handlingClick = true;
|
|
|
|
for (const input of inputs) {
|
|
const layer = this._getLayer(input.layerId).layer;
|
|
|
|
if (input.checked) {
|
|
addedLayers.push(layer);
|
|
} else if (!input.checked) {
|
|
removedLayers.push(layer);
|
|
}
|
|
}
|
|
|
|
// Bugfix issue 2318: Should remove all old layers before readding new ones
|
|
for (const layer of removedLayers) {
|
|
if (this._map.hasLayer(layer)) {
|
|
this._map.removeLayer(layer);
|
|
}
|
|
}
|
|
for (const layer of addedLayers) {
|
|
if (!this._map.hasLayer(layer)) {
|
|
this._map.addLayer(layer);
|
|
}
|
|
}
|
|
|
|
this._handlingClick = false;
|
|
|
|
this._refocusOnMap(e);
|
|
}
|
|
|
|
_checkDisabledLayers() {
|
|
const inputs = this._layerControlInputs,
|
|
zoom = this._map.getZoom();
|
|
|
|
for (const input of inputs) {
|
|
const layer = this._getLayer(input.layerId).layer;
|
|
input.disabled = (layer.options.minZoom !== undefined && zoom < layer.options.minZoom) ||
|
|
(layer.options.maxZoom !== undefined && zoom > layer.options.maxZoom);
|
|
|
|
}
|
|
}
|
|
|
|
_expandIfNotCollapsed() {
|
|
if (this._map && !this.options.collapsed) {
|
|
this.expand();
|
|
}
|
|
return this;
|
|
}
|
|
|
|
_expandSafely() {
|
|
const section = this._section;
|
|
this._preventClick = true;
|
|
on(section, 'click', preventDefault);
|
|
this.expand();
|
|
setTimeout(() => {
|
|
off(section, 'click', preventDefault);
|
|
this._preventClick = false;
|
|
});
|
|
}
|
|
|
|
}
|
|
|
|
/*
|
|
* @class Control.Zoom
|
|
* @inherits Control
|
|
*
|
|
* A basic zoom control with two buttons (zoom in and zoom out). It is put on the map by default unless you set its [`zoomControl` option](#map-zoomcontrol) to `false`. Extends `Control`.
|
|
*/
|
|
|
|
// @namespace Control.Zoom
|
|
// @constructor Control.Zoom(options: Control.Zoom options)
|
|
// Creates a zoom control
|
|
class Zoom extends Control {
|
|
|
|
static {
|
|
// @section
|
|
// @aka Control.Zoom options
|
|
this.setDefaultOptions({
|
|
// @option position: String = 'topleft'
|
|
// The position of the control (one of the map corners). Possible values are `'topleft'`,
|
|
// `'topright'`, `'bottomleft'` or `'bottomright'`
|
|
position: 'topleft',
|
|
|
|
// @option zoomInText: String = '<span aria-hidden="true">+</span>'
|
|
// The text set on the 'zoom in' button.
|
|
zoomInText: '<span aria-hidden="true">+</span>',
|
|
|
|
// @option zoomInTitle: String = 'Zoom in'
|
|
// The title set on the 'zoom in' button.
|
|
zoomInTitle: 'Zoom in',
|
|
|
|
// @option zoomOutText: String = '<span aria-hidden="true">−</span>'
|
|
// The text set on the 'zoom out' button.
|
|
zoomOutText: '<span aria-hidden="true">−</span>',
|
|
|
|
// @option zoomOutTitle: String = 'Zoom out'
|
|
// The title set on the 'zoom out' button.
|
|
zoomOutTitle: 'Zoom out'
|
|
});
|
|
}
|
|
|
|
onAdd(map) {
|
|
const zoomName = 'leaflet-control-zoom',
|
|
container = create$1('div', `${zoomName} leaflet-bar`),
|
|
options = this.options;
|
|
|
|
this._zoomInButton = this._createButton(options.zoomInText, options.zoomInTitle,
|
|
`${zoomName}-in`, container, this._zoomIn);
|
|
this._zoomOutButton = this._createButton(options.zoomOutText, options.zoomOutTitle,
|
|
`${zoomName}-out`, container, this._zoomOut);
|
|
|
|
this._updateDisabled();
|
|
map.on('zoomend zoomlevelschange', this._updateDisabled, this);
|
|
|
|
return container;
|
|
}
|
|
|
|
onRemove(map) {
|
|
map.off('zoomend zoomlevelschange', this._updateDisabled, this);
|
|
}
|
|
|
|
disable() {
|
|
this._disabled = true;
|
|
this._updateDisabled();
|
|
return this;
|
|
}
|
|
|
|
enable() {
|
|
this._disabled = false;
|
|
this._updateDisabled();
|
|
return this;
|
|
}
|
|
|
|
_zoomIn(e) {
|
|
if (!this._disabled && this._map._zoom < this._map.getMaxZoom()) {
|
|
this._map.zoomIn(this._map.options.zoomDelta * (e.shiftKey ? 3 : 1));
|
|
}
|
|
}
|
|
|
|
_zoomOut(e) {
|
|
if (!this._disabled && this._map._zoom > this._map.getMinZoom()) {
|
|
this._map.zoomOut(this._map.options.zoomDelta * (e.shiftKey ? 3 : 1));
|
|
}
|
|
}
|
|
|
|
_createButton(html, title, className, container, fn) {
|
|
const link = create$1('a', className, container);
|
|
link.innerHTML = html;
|
|
link.href = '#';
|
|
link.title = title;
|
|
|
|
/*
|
|
* Will force screen readers like VoiceOver to read this as "Zoom in - button"
|
|
*/
|
|
link.setAttribute('role', 'button');
|
|
link.setAttribute('aria-label', title);
|
|
|
|
disableClickPropagation(link);
|
|
on(link, 'click', stop);
|
|
on(link, 'click', fn, this);
|
|
on(link, 'click', this._refocusOnMap, this);
|
|
|
|
return link;
|
|
}
|
|
|
|
_updateDisabled() {
|
|
const map = this._map,
|
|
className = 'leaflet-disabled';
|
|
|
|
this._zoomInButton.classList.remove(className);
|
|
this._zoomOutButton.classList.remove(className);
|
|
this._zoomInButton.setAttribute('aria-disabled', 'false');
|
|
this._zoomOutButton.setAttribute('aria-disabled', 'false');
|
|
|
|
if (this._disabled || map._zoom === map.getMinZoom()) {
|
|
this._zoomOutButton.classList.add(className);
|
|
this._zoomOutButton.setAttribute('aria-disabled', 'true');
|
|
}
|
|
if (this._disabled || map._zoom === map.getMaxZoom()) {
|
|
this._zoomInButton.classList.add(className);
|
|
this._zoomInButton.setAttribute('aria-disabled', 'true');
|
|
}
|
|
}
|
|
}
|
|
|
|
// @namespace Map
|
|
// @section Control options
|
|
// @option zoomControl: Boolean = true
|
|
// Whether a [zoom control](#control-zoom) is added to the map by default.
|
|
Map$1.mergeOptions({
|
|
zoomControl: true
|
|
});
|
|
|
|
Map$1.addInitHook(function () {
|
|
if (this.options.zoomControl) {
|
|
// @section Controls
|
|
// @property zoomControl: Control.Zoom
|
|
// The default zoom control (only available if the
|
|
// [`zoomControl` option](#map-zoomcontrol) was `true` when creating the map).
|
|
this.zoomControl = new Zoom();
|
|
this.addControl(this.zoomControl);
|
|
}
|
|
});
|
|
|
|
/*
|
|
* @class Control.Scale
|
|
* @inherits Control
|
|
*
|
|
* A simple scale control that shows the scale of the current center of screen in metric (m/km) and imperial (mi/ft) systems. Extends `Control`.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* new Control.Scale().addTo(map);
|
|
* ```
|
|
*/
|
|
|
|
// @constructor Control.Scale(options?: Control.Scale options)
|
|
// Creates an scale control with the given options.
|
|
class Scale extends Control {
|
|
|
|
static {
|
|
// @section
|
|
// @aka Control.Scale options
|
|
this.setDefaultOptions({
|
|
// @option position: String = 'bottomleft'
|
|
// The position of the control (one of the map corners). Possible values are `'topleft'`,
|
|
// `'topright'`, `'bottomleft'` or `'bottomright'`
|
|
position: 'bottomleft',
|
|
|
|
// @option maxWidth: Number = 100
|
|
// Maximum width of the control in pixels. The width is set dynamically to show round values (e.g. 100, 200, 500).
|
|
maxWidth: 100,
|
|
|
|
// @option metric: Boolean = True
|
|
// Whether to show the metric scale line (m/km).
|
|
metric: true,
|
|
|
|
// @option imperial: Boolean = True
|
|
// Whether to show the imperial scale line (mi/ft).
|
|
imperial: true,
|
|
|
|
// @option updateWhenIdle: Boolean = false
|
|
// If `true`, the control is updated on [`moveend`](#map-moveend), otherwise it's always up-to-date (updated on [`move`](#map-move)).
|
|
updateWhenIdle: false
|
|
});
|
|
}
|
|
|
|
onAdd(map) {
|
|
const className = 'leaflet-control-scale',
|
|
container = create$1('div', className),
|
|
options = this.options;
|
|
|
|
this._addScales(options, `${className}-line`, container);
|
|
|
|
map.on(options.updateWhenIdle ? 'moveend' : 'move', this._update, this);
|
|
map.whenReady(this._update, this);
|
|
|
|
return container;
|
|
}
|
|
|
|
onRemove(map) {
|
|
map.off(this.options.updateWhenIdle ? 'moveend' : 'move', this._update, this);
|
|
}
|
|
|
|
_addScales(options, className, container) {
|
|
if (options.metric) {
|
|
this._mScale = create$1('div', className, container);
|
|
}
|
|
if (options.imperial) {
|
|
this._iScale = create$1('div', className, container);
|
|
}
|
|
}
|
|
|
|
_update() {
|
|
const map = this._map,
|
|
y = map.getSize().y / 2;
|
|
|
|
const maxMeters = map.distance(
|
|
map.containerPointToLatLng([0, y]),
|
|
map.containerPointToLatLng([this.options.maxWidth, y]));
|
|
|
|
this._updateScales(maxMeters);
|
|
}
|
|
|
|
_updateScales(maxMeters) {
|
|
if (this.options.metric && maxMeters) {
|
|
this._updateMetric(maxMeters);
|
|
}
|
|
if (this.options.imperial && maxMeters) {
|
|
this._updateImperial(maxMeters);
|
|
}
|
|
}
|
|
|
|
_updateMetric(maxMeters) {
|
|
const meters = this._getRoundNum(maxMeters),
|
|
label = meters < 1000 ? `${meters} m` : `${meters / 1000} km`;
|
|
|
|
this._updateScale(this._mScale, label, meters / maxMeters);
|
|
}
|
|
|
|
_updateImperial(maxMeters) {
|
|
const maxFeet = maxMeters * 3.2808399;
|
|
let maxMiles, miles, feet;
|
|
|
|
if (maxFeet > 5280) {
|
|
maxMiles = maxFeet / 5280;
|
|
miles = this._getRoundNum(maxMiles);
|
|
this._updateScale(this._iScale, `${miles} mi`, miles / maxMiles);
|
|
|
|
} else {
|
|
feet = this._getRoundNum(maxFeet);
|
|
this._updateScale(this._iScale, `${feet} ft`, feet / maxFeet);
|
|
}
|
|
}
|
|
|
|
_updateScale(scale, text, ratio) {
|
|
scale.style.width = `${Math.round(this.options.maxWidth * ratio)}px`;
|
|
scale.innerHTML = text;
|
|
}
|
|
|
|
_getRoundNum(num) {
|
|
const pow10 = 10 ** ((`${Math.floor(num)}`).length - 1);
|
|
let d = num / pow10;
|
|
|
|
d = d >= 10 ? 10 :
|
|
d >= 5 ? 5 :
|
|
d >= 3 ? 3 :
|
|
d >= 2 ? 2 : 1;
|
|
|
|
return pow10 * d;
|
|
}
|
|
}
|
|
|
|
const ukrainianFlag = '<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="12" height="8" viewBox="0 0 12 8" class="leaflet-attribution-flag"><path fill="#4C7BE1" d="M0 0h12v4H0z"/><path fill="#FFD500" d="M0 4h12v3H0z"/><path fill="#E0BC00" d="M0 7h12v1H0z"/></svg>';
|
|
|
|
|
|
/*
|
|
* @class Control.Attribution
|
|
* @inherits Control
|
|
*
|
|
* The attribution control allows you to display attribution data in a small text box on a map. It is put on the map by default unless you set its [`attributionControl` option](#map-attributioncontrol) to `false`, and it fetches attribution texts from layers with the [`getAttribution` method](#layer-getattribution) automatically. Extends Control.
|
|
*/
|
|
|
|
// @namespace Control.Attribution
|
|
// @constructor Control.Attribution(options: Control.Attribution options)
|
|
// Creates an attribution control.
|
|
class Attribution extends Control {
|
|
|
|
static {
|
|
// @section
|
|
// @aka Control.Attribution options
|
|
this.setDefaultOptions({
|
|
// @option position: String = 'bottomright'
|
|
// The position of the control (one of the map corners). Possible values are `'topleft'`,
|
|
// `'topright'`, `'bottomleft'` or `'bottomright'`
|
|
position: 'bottomright',
|
|
|
|
// @option prefix: String|false = 'Leaflet'
|
|
// The HTML text shown before the attributions. Pass `false` to disable.
|
|
prefix: `<a target="_blank" href="https://leafletjs.com" title="A JavaScript library for interactive maps">${ukrainianFlag}Leaflet</a>`
|
|
});
|
|
}
|
|
|
|
initialize(options) {
|
|
setOptions(this, options);
|
|
|
|
this._attributions = {};
|
|
}
|
|
|
|
onAdd(map) {
|
|
map.attributionControl = this;
|
|
this._container = create$1('div', 'leaflet-control-attribution');
|
|
disableClickPropagation(this._container);
|
|
|
|
// TODO ugly, refactor
|
|
for (const layer of Object.values(map._layers)) {
|
|
if (layer.getAttribution) {
|
|
this.addAttribution(layer.getAttribution());
|
|
}
|
|
}
|
|
|
|
this._update();
|
|
|
|
map.on('layeradd', this._addAttribution, this);
|
|
|
|
return this._container;
|
|
}
|
|
|
|
onRemove(map) {
|
|
map.off('layeradd', this._addAttribution, this);
|
|
}
|
|
|
|
_addAttribution(ev) {
|
|
if (ev.layer.getAttribution) {
|
|
this.addAttribution(ev.layer.getAttribution());
|
|
ev.layer.once('remove', () => this.removeAttribution(ev.layer.getAttribution()));
|
|
}
|
|
}
|
|
|
|
// @method setPrefix(prefix: String|false): this
|
|
// The HTML text shown before the attributions. Pass `false` to disable.
|
|
setPrefix(prefix) {
|
|
this.options.prefix = prefix;
|
|
this._update();
|
|
return this;
|
|
}
|
|
|
|
// @method addAttribution(text: String): this
|
|
// Adds an attribution text (e.g. `'© OpenStreetMap contributors'`).
|
|
addAttribution(text) {
|
|
if (!text) { return this; }
|
|
|
|
if (!this._attributions[text]) {
|
|
this._attributions[text] = 0;
|
|
}
|
|
this._attributions[text]++;
|
|
|
|
this._update();
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method removeAttribution(text: String): this
|
|
// Removes an attribution text.
|
|
removeAttribution(text) {
|
|
if (!text) { return this; }
|
|
|
|
if (this._attributions[text]) {
|
|
this._attributions[text]--;
|
|
this._update();
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
_update() {
|
|
if (!this._map) { return; }
|
|
|
|
const attribs = Object.keys(this._attributions).filter(i => this._attributions[i]);
|
|
|
|
const prefixAndAttribs = [];
|
|
|
|
if (this.options.prefix) {
|
|
prefixAndAttribs.push(this.options.prefix);
|
|
}
|
|
if (attribs.length) {
|
|
prefixAndAttribs.push(attribs.join(', '));
|
|
}
|
|
|
|
this._container.innerHTML = prefixAndAttribs.join(' <span aria-hidden="true">|</span> ');
|
|
}
|
|
}
|
|
|
|
// @namespace Map
|
|
// @section Control options
|
|
// @option attributionControl: Boolean = true
|
|
// Whether a [attribution control](#control-attribution) is added to the map by default.
|
|
Map$1.mergeOptions({
|
|
attributionControl: true
|
|
});
|
|
|
|
Map$1.addInitHook(function () {
|
|
if (this.options.attributionControl) {
|
|
new Attribution().addTo(this);
|
|
}
|
|
});
|
|
|
|
Control.Layers = Layers;
|
|
Control.Zoom = Zoom;
|
|
Control.Scale = Scale;
|
|
Control.Attribution = Attribution;
|
|
|
|
/*
|
|
Handler is a base class for handler classes that are used internally to inject
|
|
interaction features like dragging to classes like Map and Marker.
|
|
*/
|
|
|
|
// @class Handler
|
|
// Abstract class for map interaction handlers
|
|
|
|
class Handler extends Class {
|
|
initialize(map) {
|
|
this._map = map;
|
|
}
|
|
|
|
// @method enable(): this
|
|
// Enables the handler
|
|
enable() {
|
|
if (this._enabled) { return this; }
|
|
|
|
this._enabled = true;
|
|
this.addHooks();
|
|
return this;
|
|
}
|
|
|
|
// @method disable(): this
|
|
// Disables the handler
|
|
disable() {
|
|
if (!this._enabled) { return this; }
|
|
|
|
this._enabled = false;
|
|
this.removeHooks();
|
|
return this;
|
|
}
|
|
|
|
// @method enabled(): Boolean
|
|
// Returns `true` if the handler is enabled
|
|
enabled() {
|
|
return !!this._enabled;
|
|
}
|
|
|
|
// @section Extension methods
|
|
// Classes inheriting from `Handler` must implement the two following methods:
|
|
// @method addHooks()
|
|
// Called when the handler is enabled, should add event hooks.
|
|
// @method removeHooks()
|
|
// Called when the handler is disabled, should remove the event hooks added previously.
|
|
}
|
|
|
|
// @section There is static function which can be called without instantiating Handler:
|
|
// @function addTo(map: Map, name: String): this
|
|
// Adds a new Handler to the given map with the given name.
|
|
Handler.addTo = function (map, name) {
|
|
map.addHandler(name, this);
|
|
return this;
|
|
};
|
|
|
|
/*
|
|
* @class Draggable
|
|
* @inherits Evented
|
|
*
|
|
* A class for making DOM elements draggable.
|
|
* Used internally for map and marker dragging. Works on any DOM element
|
|
*
|
|
* @example
|
|
* ```js
|
|
* const draggable = new Draggable(elementToDrag);
|
|
* draggable.enable();
|
|
* ```
|
|
*/
|
|
|
|
class Draggable extends Evented {
|
|
|
|
static {
|
|
this.setDefaultOptions({
|
|
// @section
|
|
// @aka Draggable options
|
|
// @option clickTolerance: Number = 3
|
|
// The max number of pixels a user can shift the pointer during a click
|
|
// for it to be considered a valid click (as opposed to a pointer drag).
|
|
clickTolerance: 3
|
|
});
|
|
}
|
|
|
|
// @constructor Draggable(el: HTMLElement, dragHandle?: HTMLElement, preventOutline?: Boolean, options?: Draggable options)
|
|
// Creates a `Draggable` object for moving `el` when you start dragging the `dragHandle` element (equals `el` itself by default).
|
|
initialize(element, dragStartTarget, preventOutline, options) {
|
|
setOptions(this, options);
|
|
|
|
this._element = element;
|
|
this._dragStartTarget = dragStartTarget ?? element;
|
|
this._preventOutline = preventOutline;
|
|
}
|
|
|
|
// @method enable()
|
|
// Enables the dragging ability
|
|
enable() {
|
|
if (this._enabled) { return; }
|
|
|
|
on(this._dragStartTarget, 'pointerdown', this._onDown, this);
|
|
|
|
this._enabled = true;
|
|
}
|
|
|
|
// @method disable()
|
|
// Disables the dragging ability
|
|
disable() {
|
|
if (!this._enabled) { return; }
|
|
|
|
// If we're currently dragging this draggable,
|
|
// disabling it counts as first ending the drag.
|
|
if (Draggable._dragging === this) {
|
|
this.finishDrag(true);
|
|
}
|
|
|
|
off(this._dragStartTarget, 'pointerdown', this._onDown, this);
|
|
|
|
this._enabled = false;
|
|
this._moved = false;
|
|
}
|
|
|
|
_onDown(e) {
|
|
this._moved = false;
|
|
|
|
if (this._element.classList.contains('leaflet-zoom-anim')) { return; }
|
|
|
|
if (getPointers().length !== 1) {
|
|
// Finish dragging to avoid conflict with touchZoom
|
|
if (Draggable._dragging === this) {
|
|
this.finishDrag();
|
|
}
|
|
return;
|
|
}
|
|
|
|
if (Draggable._dragging || e.shiftKey || (e.button !== 0 && e.pointerType !== 'touch')) { return; }
|
|
Draggable._dragging = this; // Prevent dragging multiple objects at once.
|
|
|
|
if (this._preventOutline) {
|
|
preventOutline(this._element);
|
|
}
|
|
|
|
disableImageDrag();
|
|
disableTextSelection();
|
|
|
|
if (this._moving) { return; }
|
|
|
|
// @event down: Event
|
|
// Fired when a drag is about to start.
|
|
this.fire('down');
|
|
|
|
const sizedParent = getSizedParentNode(this._element);
|
|
|
|
this._startPoint = new Point(e.clientX, e.clientY);
|
|
this._startPos = getPosition(this._element);
|
|
|
|
// Cache the scale, so that we can continuously compensate for it during drag (_onMove).
|
|
this._parentScale = getScale(sizedParent);
|
|
|
|
on(document, 'pointermove', this._onMove, this);
|
|
on(document, 'pointerup pointercancel', this._onUp, this);
|
|
}
|
|
|
|
_onMove(e) {
|
|
if (getPointers().length > 1) {
|
|
this._moved = true;
|
|
return;
|
|
}
|
|
|
|
const offset = new Point(e.clientX, e.clientY)._subtract(this._startPoint);
|
|
|
|
if (!offset.x && !offset.y) { return; }
|
|
if (Math.abs(offset.x) + Math.abs(offset.y) < this.options.clickTolerance) { return; }
|
|
|
|
// We assume that the parent container's position, border and scale do not change for the duration of the drag.
|
|
// Therefore there is no need to account for the position and border (they are eliminated by the subtraction)
|
|
// and we can use the cached value for the scale.
|
|
offset.x /= this._parentScale.x;
|
|
offset.y /= this._parentScale.y;
|
|
|
|
if (e.cancelable) {
|
|
preventDefault(e);
|
|
}
|
|
|
|
if (!this._moved) {
|
|
// @event dragstart: Event
|
|
// Fired when a drag starts
|
|
this.fire('dragstart');
|
|
|
|
this._moved = true;
|
|
|
|
document.body.classList.add('leaflet-dragging');
|
|
|
|
this._lastTarget = e.target ?? e.srcElement;
|
|
this._lastTarget.classList.add('leaflet-drag-target');
|
|
}
|
|
|
|
this._newPos = this._startPos.add(offset);
|
|
this._moving = true;
|
|
|
|
this._lastEvent = e;
|
|
this._updatePosition();
|
|
}
|
|
|
|
_updatePosition() {
|
|
const e = {originalEvent: this._lastEvent};
|
|
|
|
// @event predrag: Event
|
|
// Fired continuously during dragging *before* each corresponding
|
|
// update of the element's position.
|
|
this.fire('predrag', e);
|
|
setPosition(this._element, this._newPos);
|
|
|
|
// @event drag: Event
|
|
// Fired continuously during dragging.
|
|
this.fire('drag', e);
|
|
}
|
|
|
|
_onUp() {
|
|
this.finishDrag();
|
|
}
|
|
|
|
finishDrag(noInertia) {
|
|
document.body.classList.remove('leaflet-dragging');
|
|
|
|
if (this._lastTarget) {
|
|
this._lastTarget.classList.remove('leaflet-drag-target');
|
|
this._lastTarget = null;
|
|
}
|
|
|
|
off(document, 'pointermove', this._onMove, this);
|
|
off(document, 'pointerup pointercancel', this._onUp, this);
|
|
|
|
enableImageDrag();
|
|
enableTextSelection();
|
|
|
|
const fireDragend = this._moved && this._moving;
|
|
|
|
this._moving = false;
|
|
Draggable._dragging = false;
|
|
|
|
if (fireDragend) {
|
|
// @event dragend: DragEndEvent
|
|
// Fired when the drag ends.
|
|
this.fire('dragend', {
|
|
noInertia,
|
|
distance: this._newPos.distanceTo(this._startPos)
|
|
});
|
|
}
|
|
}
|
|
|
|
}
|
|
|
|
/*
|
|
* @namespace PolyUtil
|
|
* Various utility functions for polygon geometries.
|
|
*/
|
|
|
|
/* @function clipPolygon(points: Point[], bounds: Bounds, round?: Boolean): Point[]
|
|
* Clips the polygon geometry defined by the given `points` by the given bounds (using the [Sutherland-Hodgman algorithm](https://en.wikipedia.org/wiki/Sutherland%E2%80%93Hodgman_algorithm)).
|
|
* Used by Leaflet to only show polygon points that are on the screen or near, increasing
|
|
* performance. Note that polygon points needs different algorithm for clipping
|
|
* than polyline, so there's a separate method for it.
|
|
*/
|
|
function clipPolygon(points, bounds, round) {
|
|
let clippedPoints,
|
|
i, j, k,
|
|
a, b,
|
|
len, edge, p;
|
|
const edges = [1, 4, 2, 8];
|
|
|
|
for (i = 0, len = points.length; i < len; i++) {
|
|
points[i]._code = _getBitCode(points[i], bounds);
|
|
}
|
|
|
|
// for each edge (left, bottom, right, top)
|
|
for (k = 0; k < 4; k++) {
|
|
edge = edges[k];
|
|
clippedPoints = [];
|
|
|
|
for (i = 0, len = points.length, j = len - 1; i < len; j = i++) {
|
|
a = points[i];
|
|
b = points[j];
|
|
|
|
// if a is inside the clip window
|
|
if (!(a._code & edge)) {
|
|
// if b is outside the clip window (a->b goes out of screen)
|
|
if (b._code & edge) {
|
|
p = _getEdgeIntersection(b, a, edge, bounds, round);
|
|
p._code = _getBitCode(p, bounds);
|
|
clippedPoints.push(p);
|
|
}
|
|
clippedPoints.push(a);
|
|
|
|
// else if b is inside the clip window (a->b enters the screen)
|
|
} else if (!(b._code & edge)) {
|
|
p = _getEdgeIntersection(b, a, edge, bounds, round);
|
|
p._code = _getBitCode(p, bounds);
|
|
clippedPoints.push(p);
|
|
}
|
|
}
|
|
points = clippedPoints;
|
|
}
|
|
|
|
return points;
|
|
}
|
|
|
|
/* @function polygonCenter(latlngs: LatLng[], crs: CRS): LatLng
|
|
* Returns the center ([centroid](http://en.wikipedia.org/wiki/Centroid)) of the passed LatLngs (first ring) from a polygon.
|
|
*/
|
|
function polygonCenter(latlngs, crs) {
|
|
let i, j, p1, p2, f, area, x, y, center;
|
|
|
|
if (!latlngs || latlngs.length === 0) {
|
|
throw new Error('latlngs not passed');
|
|
}
|
|
|
|
if (!isFlat(latlngs)) {
|
|
console.warn('latlngs are not flat! Only the first ring will be used');
|
|
latlngs = latlngs[0];
|
|
}
|
|
|
|
let centroidLatLng = new LatLng([0, 0]);
|
|
|
|
const bounds = new LatLngBounds(latlngs);
|
|
const areaBounds = bounds.getNorthWest().distanceTo(bounds.getSouthWest()) * bounds.getNorthEast().distanceTo(bounds.getNorthWest());
|
|
// tests showed that below 1700 rounding errors are happening
|
|
if (areaBounds < 1700) {
|
|
// getting a inexact center, to move the latlngs near to [0, 0] to prevent rounding errors
|
|
centroidLatLng = centroid(latlngs);
|
|
}
|
|
|
|
const len = latlngs.length;
|
|
const points = [];
|
|
for (i = 0; i < len; i++) {
|
|
const latlng = new LatLng(latlngs[i]);
|
|
points.push(crs.project(new LatLng([latlng.lat - centroidLatLng.lat, latlng.lng - centroidLatLng.lng])));
|
|
}
|
|
|
|
area = x = y = 0;
|
|
|
|
// polygon centroid algorithm;
|
|
for (i = 0, j = len - 1; i < len; j = i++) {
|
|
p1 = points[i];
|
|
p2 = points[j];
|
|
|
|
f = p1.y * p2.x - p2.y * p1.x;
|
|
x += (p1.x + p2.x) * f;
|
|
y += (p1.y + p2.y) * f;
|
|
area += f * 3;
|
|
}
|
|
|
|
if (area === 0) {
|
|
// Polygon is so small that all points are on same pixel.
|
|
center = points[0];
|
|
} else {
|
|
center = [x / area, y / area];
|
|
}
|
|
|
|
const latlngCenter = crs.unproject(new Point(center));
|
|
return new LatLng([latlngCenter.lat + centroidLatLng.lat, latlngCenter.lng + centroidLatLng.lng]);
|
|
}
|
|
|
|
/* @function centroid(latlngs: LatLng[]): LatLng
|
|
* Returns the 'center of mass' of the passed LatLngs.
|
|
*/
|
|
function centroid(coords) {
|
|
let latSum = 0;
|
|
let lngSum = 0;
|
|
let len = 0;
|
|
for (const coord of coords) {
|
|
const latlng = new LatLng(coord);
|
|
latSum += latlng.lat;
|
|
lngSum += latlng.lng;
|
|
len++;
|
|
}
|
|
return new LatLng([latSum / len, lngSum / len]);
|
|
}
|
|
|
|
var PolyUtil = {
|
|
__proto__: null,
|
|
centroid: centroid,
|
|
clipPolygon: clipPolygon,
|
|
polygonCenter: polygonCenter
|
|
};
|
|
|
|
/*
|
|
* @namespace LineUtil
|
|
*
|
|
* Various utility functions for polyline points processing, used by Leaflet internally to make polylines lightning-fast.
|
|
*/
|
|
|
|
// Simplify polyline with vertex reduction and Douglas-Peucker simplification.
|
|
// Improves rendering performance dramatically by lessening the number of points to draw.
|
|
|
|
// @function simplify(points: Point[], tolerance: Number): Point[]
|
|
// Dramatically reduces the number of points in a polyline while retaining
|
|
// its shape and returns a new array of simplified points, using the
|
|
// [Ramer-Douglas-Peucker algorithm](https://en.wikipedia.org/wiki/Ramer-Douglas-Peucker_algorithm).
|
|
// Used for a huge performance boost when processing/displaying Leaflet polylines for
|
|
// each zoom level and also reducing visual noise. tolerance affects the amount of
|
|
// simplification (lesser value means higher quality but slower and with more points).
|
|
// Also released as a separated micro-library [Simplify.js](https://mourner.github.io/simplify-js/).
|
|
function simplify(points, tolerance) {
|
|
if (!tolerance || !points.length) {
|
|
return points.slice();
|
|
}
|
|
|
|
const sqTolerance = tolerance * tolerance;
|
|
|
|
// stage 1: vertex reduction
|
|
points = _reducePoints(points, sqTolerance);
|
|
|
|
// stage 2: Douglas-Peucker simplification
|
|
points = _simplifyDP(points, sqTolerance);
|
|
|
|
return points;
|
|
}
|
|
|
|
// @function pointToSegmentDistance(p: Point, p1: Point, p2: Point): Number
|
|
// Returns the distance between point `p` and segment `p1` to `p2`.
|
|
function pointToSegmentDistance(p, p1, p2) {
|
|
return Math.sqrt(_sqClosestPointOnSegment(p, p1, p2, true));
|
|
}
|
|
|
|
// @function closestPointOnSegment(p: Point, p1: Point, p2: Point): Number
|
|
// Returns the closest point from a point `p` on a segment `p1` to `p2`.
|
|
function closestPointOnSegment(p, p1, p2) {
|
|
return _sqClosestPointOnSegment(p, p1, p2);
|
|
}
|
|
|
|
// Ramer-Douglas-Peucker simplification, see https://en.wikipedia.org/wiki/Ramer-Douglas-Peucker_algorithm
|
|
function _simplifyDP(points, sqTolerance) {
|
|
|
|
const len = points.length,
|
|
markers = new Uint8Array(len);
|
|
markers[0] = markers[len - 1] = 1;
|
|
|
|
_simplifyDPStep(points, markers, sqTolerance, 0, len - 1);
|
|
|
|
let i;
|
|
const newPoints = [];
|
|
|
|
for (i = 0; i < len; i++) {
|
|
if (markers[i]) {
|
|
newPoints.push(points[i]);
|
|
}
|
|
}
|
|
|
|
return newPoints;
|
|
}
|
|
|
|
function _simplifyDPStep(points, markers, sqTolerance, first, last) {
|
|
|
|
let maxSqDist = 0,
|
|
index, i, sqDist;
|
|
|
|
for (i = first + 1; i <= last - 1; i++) {
|
|
sqDist = _sqClosestPointOnSegment(points[i], points[first], points[last], true);
|
|
|
|
if (sqDist > maxSqDist) {
|
|
index = i;
|
|
maxSqDist = sqDist;
|
|
}
|
|
}
|
|
|
|
if (maxSqDist > sqTolerance) {
|
|
markers[index] = 1;
|
|
|
|
_simplifyDPStep(points, markers, sqTolerance, first, index);
|
|
_simplifyDPStep(points, markers, sqTolerance, index, last);
|
|
}
|
|
}
|
|
|
|
// reduce points that are too close to each other to a single point
|
|
function _reducePoints(points, sqTolerance) {
|
|
const reducedPoints = [points[0]];
|
|
let prev = 0;
|
|
|
|
for (let i = 1; i < points.length; i++) {
|
|
if (_sqDist(points[i], points[prev]) > sqTolerance) {
|
|
reducedPoints.push(points[i]);
|
|
prev = i;
|
|
}
|
|
}
|
|
if (prev < points.length - 1) {
|
|
reducedPoints.push(points[points.length - 1]);
|
|
}
|
|
return reducedPoints;
|
|
}
|
|
|
|
let _lastCode;
|
|
|
|
// @function clipSegment(a: Point, b: Point, bounds: Bounds, useLastCode?: Boolean, round?: Boolean): Point[]|Boolean
|
|
// Clips the segment a to b by rectangular bounds with the
|
|
// [Cohen-Sutherland algorithm](https://en.wikipedia.org/wiki/Cohen%E2%80%93Sutherland_algorithm)
|
|
// (modifying the segment points directly!). Used by Leaflet to only show polyline
|
|
// points that are on the screen or near, increasing performance.
|
|
function clipSegment(a, b, bounds, useLastCode, round) {
|
|
let codeA = useLastCode ? _lastCode : _getBitCode(a, bounds),
|
|
codeB = _getBitCode(b, bounds),
|
|
|
|
codeOut, p, newCode;
|
|
|
|
// save 2nd code to avoid calculating it on the next segment
|
|
_lastCode = codeB;
|
|
|
|
while (true) {
|
|
// if a,b is inside the clip window (trivial accept)
|
|
if (!(codeA | codeB)) {
|
|
return [a, b];
|
|
}
|
|
|
|
// if a,b is outside the clip window (trivial reject)
|
|
if (codeA & codeB) {
|
|
return false;
|
|
}
|
|
|
|
// other cases
|
|
codeOut = codeA || codeB;
|
|
p = _getEdgeIntersection(a, b, codeOut, bounds, round);
|
|
newCode = _getBitCode(p, bounds);
|
|
|
|
if (codeOut === codeA) {
|
|
a = p;
|
|
codeA = newCode;
|
|
} else {
|
|
b = p;
|
|
codeB = newCode;
|
|
}
|
|
}
|
|
}
|
|
|
|
function _getEdgeIntersection(a, b, code, bounds, round) {
|
|
const dx = b.x - a.x,
|
|
dy = b.y - a.y,
|
|
min = bounds.min,
|
|
max = bounds.max;
|
|
let x, y;
|
|
|
|
if (code & 8) { // top
|
|
x = a.x + dx * (max.y - a.y) / dy;
|
|
y = max.y;
|
|
|
|
} else if (code & 4) { // bottom
|
|
x = a.x + dx * (min.y - a.y) / dy;
|
|
y = min.y;
|
|
|
|
} else if (code & 2) { // right
|
|
x = max.x;
|
|
y = a.y + dy * (max.x - a.x) / dx;
|
|
|
|
} else if (code & 1) { // left
|
|
x = min.x;
|
|
y = a.y + dy * (min.x - a.x) / dx;
|
|
}
|
|
|
|
return new Point(x, y, round);
|
|
}
|
|
|
|
function _getBitCode(p, bounds) {
|
|
let code = 0;
|
|
|
|
if (p.x < bounds.min.x) { // left
|
|
code |= 1;
|
|
} else if (p.x > bounds.max.x) { // right
|
|
code |= 2;
|
|
}
|
|
|
|
if (p.y < bounds.min.y) { // bottom
|
|
code |= 4;
|
|
} else if (p.y > bounds.max.y) { // top
|
|
code |= 8;
|
|
}
|
|
|
|
return code;
|
|
}
|
|
|
|
// square distance (to avoid unnecessary Math.sqrt calls)
|
|
function _sqDist(p1, p2) {
|
|
const dx = p2.x - p1.x,
|
|
dy = p2.y - p1.y;
|
|
return dx * dx + dy * dy;
|
|
}
|
|
|
|
// return closest point on segment or distance to that point
|
|
function _sqClosestPointOnSegment(p, p1, p2, sqDist) {
|
|
let x = p1.x,
|
|
y = p1.y,
|
|
dx = p2.x - x,
|
|
dy = p2.y - y,
|
|
t;
|
|
const dot = dx * dx + dy * dy;
|
|
|
|
if (dot > 0) {
|
|
t = ((p.x - x) * dx + (p.y - y) * dy) / dot;
|
|
|
|
if (t > 1) {
|
|
x = p2.x;
|
|
y = p2.y;
|
|
} else if (t > 0) {
|
|
x += dx * t;
|
|
y += dy * t;
|
|
}
|
|
}
|
|
|
|
dx = p.x - x;
|
|
dy = p.y - y;
|
|
|
|
return sqDist ? dx * dx + dy * dy : new Point(x, y);
|
|
}
|
|
|
|
|
|
// @function isFlat(latlngs: LatLng[]): Boolean
|
|
// Returns true if `latlngs` is a flat array, false is nested.
|
|
function isFlat(latlngs) {
|
|
return !Array.isArray(latlngs[0]) || (typeof latlngs[0][0] !== 'object' && typeof latlngs[0][0] !== 'undefined');
|
|
}
|
|
|
|
/* @function polylineCenter(latlngs: LatLng[], crs: CRS): LatLng
|
|
* Returns the center ([centroid](http://en.wikipedia.org/wiki/Centroid)) of the passed LatLngs (first ring) from a polyline.
|
|
*/
|
|
function polylineCenter(latlngs, crs) {
|
|
let i, halfDist, segDist, dist, p1, p2, ratio, center;
|
|
|
|
if (!latlngs || latlngs.length === 0) {
|
|
throw new Error('latlngs not passed');
|
|
}
|
|
|
|
if (!isFlat(latlngs)) {
|
|
console.warn('latlngs are not flat! Only the first ring will be used');
|
|
latlngs = latlngs[0];
|
|
}
|
|
|
|
let centroidLatLng = new LatLng([0, 0]);
|
|
|
|
const bounds = new LatLngBounds(latlngs);
|
|
const areaBounds = bounds.getNorthWest().distanceTo(bounds.getSouthWest()) * bounds.getNorthEast().distanceTo(bounds.getNorthWest());
|
|
// tests showed that below 1700 rounding errors are happening
|
|
if (areaBounds < 1700) {
|
|
// getting a inexact center, to move the latlngs near to [0, 0] to prevent rounding errors
|
|
centroidLatLng = centroid(latlngs);
|
|
}
|
|
|
|
const len = latlngs.length;
|
|
const points = [];
|
|
for (i = 0; i < len; i++) {
|
|
const latlng = new LatLng(latlngs[i]);
|
|
points.push(crs.project(new LatLng([latlng.lat - centroidLatLng.lat, latlng.lng - centroidLatLng.lng])));
|
|
}
|
|
|
|
for (i = 0, halfDist = 0; i < len - 1; i++) {
|
|
halfDist += points[i].distanceTo(points[i + 1]) / 2;
|
|
}
|
|
|
|
// The line is so small in the current view that all points are on the same pixel.
|
|
if (halfDist === 0) {
|
|
center = points[0];
|
|
} else {
|
|
for (i = 0, dist = 0; i < len - 1; i++) {
|
|
p1 = points[i];
|
|
p2 = points[i + 1];
|
|
segDist = p1.distanceTo(p2);
|
|
dist += segDist;
|
|
|
|
if (dist > halfDist) {
|
|
ratio = (dist - halfDist) / segDist;
|
|
center = [
|
|
p2.x - ratio * (p2.x - p1.x),
|
|
p2.y - ratio * (p2.y - p1.y)
|
|
];
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
const latlngCenter = crs.unproject(new Point(center));
|
|
return new LatLng([latlngCenter.lat + centroidLatLng.lat, latlngCenter.lng + centroidLatLng.lng]);
|
|
}
|
|
|
|
var LineUtil = {
|
|
__proto__: null,
|
|
_getBitCode: _getBitCode,
|
|
_getEdgeIntersection: _getEdgeIntersection,
|
|
_sqClosestPointOnSegment: _sqClosestPointOnSegment,
|
|
clipSegment: clipSegment,
|
|
closestPointOnSegment: closestPointOnSegment,
|
|
isFlat: isFlat,
|
|
pointToSegmentDistance: pointToSegmentDistance,
|
|
polylineCenter: polylineCenter,
|
|
simplify: simplify
|
|
};
|
|
|
|
/*
|
|
* @namespace Projection
|
|
* @section
|
|
* Leaflet comes with a set of already defined Projections out of the box:
|
|
*
|
|
* @projection Projection.LonLat
|
|
*
|
|
* Equirectangular, or Plate Carree projection — the most simple projection,
|
|
* mostly used by GIS enthusiasts. Directly maps `x` as longitude, and `y` as
|
|
* latitude. Also suitable for flat worlds, e.g. game maps. Used by the
|
|
* `EPSG:4326` and `Simple` CRS.
|
|
*/
|
|
|
|
const LonLat = {
|
|
project(latlng) {
|
|
latlng = new LatLng(latlng);
|
|
return new Point(latlng.lng, latlng.lat);
|
|
},
|
|
|
|
unproject(point) {
|
|
point = new Point(point);
|
|
return new LatLng(point.y, point.x);
|
|
},
|
|
|
|
bounds: new Bounds([-180, -90], [180, 90])
|
|
};
|
|
|
|
/*
|
|
* @namespace Projection
|
|
* @projection Projection.Mercator
|
|
*
|
|
* Elliptical Mercator projection — more complex than Spherical Mercator. Assumes that Earth is an ellipsoid. Used by the EPSG:3395 CRS.
|
|
*/
|
|
|
|
const earthRadius = 6378137;
|
|
|
|
const Mercator = {
|
|
R: earthRadius,
|
|
R_MINOR: 6356752.314245179,
|
|
|
|
bounds: new Bounds([-20037508.34279, -15496570.73972], [20037508.34279, 18764656.23138]),
|
|
|
|
project(latlng) {
|
|
latlng = new LatLng(latlng);
|
|
const d = Math.PI / 180,
|
|
r = this.R,
|
|
tmp = this.R_MINOR / r,
|
|
e = Math.sqrt(1 - tmp * tmp);
|
|
let y = latlng.lat * d;
|
|
const con = e * Math.sin(y);
|
|
|
|
const ts = Math.tan(Math.PI / 4 - y / 2) / ((1 - con) / (1 + con)) ** (e / 2);
|
|
y = -r * Math.log(Math.max(ts, 1E-10));
|
|
|
|
return new Point(latlng.lng * d * r, y);
|
|
},
|
|
|
|
unproject(point) {
|
|
point = new Point(point);
|
|
const d = 180 / Math.PI,
|
|
r = this.R,
|
|
tmp = this.R_MINOR / r,
|
|
e = Math.sqrt(1 - tmp * tmp),
|
|
ts = Math.exp(-point.y / r);
|
|
let phi = Math.PI / 2 - 2 * Math.atan(ts);
|
|
|
|
for (let i = 0, dphi = 0.1, con; i < 15 && Math.abs(dphi) > 1e-7; i++) {
|
|
con = e * Math.sin(phi);
|
|
con = ((1 - con) / (1 + con)) ** (e / 2);
|
|
dphi = Math.PI / 2 - 2 * Math.atan(ts * con) - phi;
|
|
phi += dphi;
|
|
}
|
|
|
|
return new LatLng(phi * d, point.x * d / r);
|
|
}
|
|
};
|
|
|
|
/*
|
|
* @class Projection
|
|
|
|
* An object with methods for projecting geographical coordinates of the world onto
|
|
* a flat surface (and back). See [Map projection](https://en.wikipedia.org/wiki/Map_projection).
|
|
|
|
* @property bounds: Bounds
|
|
* The bounds (specified in CRS units) where the projection is valid
|
|
|
|
* @method project(latlng: LatLng): Point
|
|
* Projects geographical coordinates into a 2D point.
|
|
* Only accepts actual `LatLng` instances, not arrays.
|
|
|
|
* @method unproject(point: Point): LatLng
|
|
* The inverse of `project`. Projects a 2D point into a geographical location.
|
|
* Only accepts actual `Point` instances, not arrays.
|
|
|
|
* Note that the projection instances do not inherit from Leaflet's `Class` object,
|
|
* and can't be instantiated. Also, new classes can't inherit from them,
|
|
* and methods can't be added to them with the `include` function.
|
|
|
|
*/
|
|
|
|
var index = {
|
|
__proto__: null,
|
|
LonLat: LonLat,
|
|
Mercator: Mercator,
|
|
SphericalMercator: SphericalMercator
|
|
};
|
|
|
|
/*
|
|
* @namespace CRS
|
|
* @crs CRS.EPSG3395
|
|
*
|
|
* Rarely used by some commercial tile providers. Uses Elliptical Mercator projection.
|
|
*/
|
|
class EPSG3395 extends Earth {
|
|
static code = 'EPSG:3395';
|
|
static projection = Mercator;
|
|
|
|
static transformation = (() => {
|
|
const scale = 0.5 / (Math.PI * Mercator.R);
|
|
return new Transformation(scale, 0.5, -scale, 0.5);
|
|
})();
|
|
}
|
|
|
|
/*
|
|
* @namespace CRS
|
|
* @crs CRS.EPSG4326
|
|
*
|
|
* A common CRS among GIS enthusiasts. Uses simple Equirectangular projection.
|
|
*
|
|
* Leaflet complies with the [TMS coordinate scheme for EPSG:4326](https://wiki.osgeo.org/wiki/Tile_Map_Service_Specification#global-geodetic).
|
|
* If you are using a `TileLayer` with this CRS, ensure that there are two 256x256 pixel tiles covering the
|
|
* whole earth at zoom level zero, and that the tile coordinate origin is (-180,+90),
|
|
* or (-180,-90) for `TileLayer`s with [the `tms` option](#tilelayer-tms) set.
|
|
*/
|
|
|
|
class EPSG4326 extends Earth {
|
|
static code = 'EPSG:4326';
|
|
static projection = LonLat;
|
|
static transformation = new Transformation(1 / 180, 1, -1 / 180, 0.5);
|
|
}
|
|
|
|
/*
|
|
* @namespace CRS
|
|
* @crs CRS.Simple
|
|
*
|
|
* A simple CRS that maps longitude and latitude into `x` and `y` directly.
|
|
* May be used for maps of flat surfaces (e.g. game maps). Note that the `y`
|
|
* axis should still be inverted (going from bottom to top). `distance()` returns
|
|
* simple euclidean distance.
|
|
*/
|
|
|
|
class Simple extends CRS {
|
|
static projection = LonLat;
|
|
static transformation = new Transformation(1, 0, -1, 0);
|
|
|
|
static scale(zoom) {
|
|
return 2 ** zoom;
|
|
}
|
|
|
|
static zoom(scale) {
|
|
return Math.log(scale) / Math.LN2;
|
|
}
|
|
|
|
static distance(latlng1, latlng2) {
|
|
const dx = latlng2.lng - latlng1.lng,
|
|
dy = latlng2.lat - latlng1.lat;
|
|
|
|
return Math.sqrt(dx * dx + dy * dy);
|
|
}
|
|
|
|
static infinite = true;
|
|
}
|
|
|
|
CRS.Earth = Earth;
|
|
CRS.EPSG3395 = EPSG3395;
|
|
CRS.EPSG3857 = EPSG3857;
|
|
CRS.EPSG900913 = EPSG900913;
|
|
CRS.EPSG4326 = EPSG4326;
|
|
CRS.Simple = Simple;
|
|
|
|
/*
|
|
* @class Layer
|
|
* @inherits Evented
|
|
* @aka ILayer
|
|
*
|
|
* A set of methods from the Layer base class that all Leaflet layers use.
|
|
* Inherits all methods, options and events from `Evented`.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* const layer = new Marker(latlng).addTo(map);
|
|
* layer.addTo(map);
|
|
* layer.remove();
|
|
* ```
|
|
*
|
|
* @event add: Event
|
|
* Fired after the layer is added to a map
|
|
*
|
|
* @event remove: Event
|
|
* Fired after the layer is removed from a map
|
|
*/
|
|
|
|
|
|
class Layer extends Evented {
|
|
|
|
static {
|
|
// Classes extending `Layer` will inherit the following options:
|
|
this.setDefaultOptions({
|
|
// @option pane: String = 'overlayPane'
|
|
// By default the layer will be added to the map's [overlay pane](#map-overlaypane). Overriding this option will cause the layer to be placed on another pane by default.
|
|
// Not effective if the `renderer` option is set (the `renderer` option will override the `pane` option).
|
|
pane: 'overlayPane',
|
|
|
|
// @option attribution: String = null
|
|
// String to be shown in the attribution control, e.g. "© OpenStreetMap contributors". It describes the layer data and is often a legal obligation towards copyright holders and tile providers.
|
|
attribution: null,
|
|
|
|
bubblingPointerEvents: true
|
|
});
|
|
}
|
|
|
|
/* @section
|
|
* Classes extending `Layer` will inherit the following methods:
|
|
*
|
|
* @method addTo(map: Map|LayerGroup): this
|
|
* Adds the layer to the given map or layer group.
|
|
*/
|
|
addTo(map) {
|
|
map.addLayer(this);
|
|
return this;
|
|
}
|
|
|
|
// @method remove: this
|
|
// Removes the layer from the map it is currently active on.
|
|
remove() {
|
|
return this.removeFrom(this._map || this._mapToAdd);
|
|
}
|
|
|
|
// @method removeFrom(map: Map): this
|
|
// Removes the layer from the given map
|
|
//
|
|
// @alternative
|
|
// @method removeFrom(group: LayerGroup): this
|
|
// Removes the layer from the given `LayerGroup`
|
|
removeFrom(obj) {
|
|
obj?.removeLayer(this);
|
|
return this;
|
|
}
|
|
|
|
// @method getPane(name? : String): HTMLElement
|
|
// Returns the `HTMLElement` representing the named pane on the map. If `name` is omitted, returns the pane for this layer.
|
|
getPane(name) {
|
|
return this._map.getPane(name ? (this.options[name] || name) : this.options.pane);
|
|
}
|
|
|
|
addInteractiveTarget(targetEl) {
|
|
this._map._targets[stamp(targetEl)] = this;
|
|
return this;
|
|
}
|
|
|
|
removeInteractiveTarget(targetEl) {
|
|
delete this._map._targets[stamp(targetEl)];
|
|
return this;
|
|
}
|
|
|
|
// @method getAttribution: String
|
|
// Used by the `attribution control`, returns the [attribution option](#gridlayer-attribution).
|
|
getAttribution() {
|
|
return this.options.attribution;
|
|
}
|
|
|
|
_layerAdd(e) {
|
|
const map = e.target;
|
|
|
|
// check in case layer gets added and then removed before the map is ready
|
|
if (!map.hasLayer(this)) { return; }
|
|
|
|
this._map = map;
|
|
this._zoomAnimated = map._zoomAnimated;
|
|
|
|
if (this.getEvents) {
|
|
const events = this.getEvents();
|
|
map.on(events, this);
|
|
this.once('remove', () => map.off(events, this));
|
|
}
|
|
|
|
this.onAdd(map);
|
|
|
|
this.fire('add');
|
|
map.fire('layeradd', {layer: this});
|
|
}
|
|
}
|
|
|
|
/* @section Extension methods
|
|
* @uninheritable
|
|
*
|
|
* Every layer should extend from `Layer` and (re-)implement the following methods.
|
|
*
|
|
* @method onAdd(map: Map): this
|
|
* Should contain code that creates DOM elements for the layer, adds them to `map panes` where they should belong and puts listeners on relevant map events. Called on [`map.addLayer(layer)`](#map-addlayer).
|
|
*
|
|
* @method onRemove(map: Map): this
|
|
* Should contain all clean up code that removes the layer's elements from the DOM and removes listeners previously added in [`onAdd`](#layer-onadd). Called on [`map.removeLayer(layer)`](#map-removelayer).
|
|
*
|
|
* @method getEvents(): Object
|
|
* This optional method should return an object like `{ viewreset: this._reset }` for [`on`](#evented-on). The event handlers in this object will be automatically added and removed from the map with your layer.
|
|
*
|
|
* @method getAttribution(): String
|
|
* This optional method should return a string containing HTML to be shown on the `Attribution control` whenever the layer is visible.
|
|
*
|
|
* @method beforeAdd(map: Map): this
|
|
* Optional method. Called on [`map.addLayer(layer)`](#map-addlayer), before the layer is added to the map, before events are initialized, without waiting until the map is in a usable state. Use for early initialization only.
|
|
*/
|
|
|
|
|
|
/* @namespace Map
|
|
* @section Layer events
|
|
*
|
|
* @event layeradd: LayerEvent
|
|
* Fired when a new layer is added to the map.
|
|
*
|
|
* @event layerremove: LayerEvent
|
|
* Fired when some layer is removed from the map
|
|
*
|
|
* @section Methods for Layers and Controls
|
|
*/
|
|
Map$1.include({
|
|
// @method addLayer(layer: Layer): this
|
|
// Adds the given layer to the map
|
|
addLayer(layer) {
|
|
if (!layer._layerAdd) {
|
|
throw new Error('The provided object is not a Layer.');
|
|
}
|
|
|
|
const id = stamp(layer);
|
|
if (this._layers[id]) { return this; }
|
|
this._layers[id] = layer;
|
|
|
|
layer._mapToAdd = this;
|
|
|
|
if (layer.beforeAdd) {
|
|
layer.beforeAdd(this);
|
|
}
|
|
|
|
this.whenReady(layer._layerAdd, layer);
|
|
|
|
return this;
|
|
},
|
|
|
|
// @method removeLayer(layer: Layer): this
|
|
// Removes the given layer from the map.
|
|
removeLayer(layer) {
|
|
const id = stamp(layer);
|
|
|
|
if (!this._layers[id]) { return this; }
|
|
|
|
if (this._loaded) {
|
|
layer.onRemove(this);
|
|
}
|
|
|
|
delete this._layers[id];
|
|
|
|
if (this._loaded) {
|
|
this.fire('layerremove', {layer});
|
|
layer.fire('remove');
|
|
}
|
|
|
|
layer._map = layer._mapToAdd = null;
|
|
|
|
return this;
|
|
},
|
|
|
|
// @method hasLayer(layer: Layer): Boolean
|
|
// Returns `true` if the given layer is currently added to the map
|
|
hasLayer(layer) {
|
|
return stamp(layer) in this._layers;
|
|
},
|
|
|
|
/* @method eachLayer(fn: Function, context?: Object): this
|
|
* Iterates over the layers of the map, optionally specifying context of the iterator function.
|
|
* ```
|
|
* map.eachLayer(function(layer){
|
|
* layer.bindPopup('Hello');
|
|
* });
|
|
* ```
|
|
*/
|
|
eachLayer(method, context) {
|
|
for (const layer of Object.values(this._layers)) {
|
|
method.call(context, layer);
|
|
}
|
|
return this;
|
|
},
|
|
|
|
_addLayers(layers) {
|
|
layers = layers ? (Array.isArray(layers) ? layers : [layers]) : [];
|
|
|
|
for (const layer of layers) {
|
|
this.addLayer(layer);
|
|
}
|
|
},
|
|
|
|
_addZoomLimit(layer) {
|
|
if (!isNaN(layer.options.maxZoom) || !isNaN(layer.options.minZoom)) {
|
|
this._zoomBoundLayers[stamp(layer)] = layer;
|
|
this._updateZoomLevels();
|
|
}
|
|
},
|
|
|
|
_removeZoomLimit(layer) {
|
|
const id = stamp(layer);
|
|
|
|
if (this._zoomBoundLayers[id]) {
|
|
delete this._zoomBoundLayers[id];
|
|
this._updateZoomLevels();
|
|
}
|
|
},
|
|
|
|
_updateZoomLevels() {
|
|
let minZoom = Infinity,
|
|
maxZoom = -Infinity;
|
|
const oldZoomSpan = this._getZoomSpan();
|
|
|
|
for (const l of Object.values(this._zoomBoundLayers)) {
|
|
const options = l.options;
|
|
minZoom = Math.min(minZoom, options.minZoom ?? Infinity);
|
|
maxZoom = Math.max(maxZoom, options.maxZoom ?? -Infinity);
|
|
}
|
|
|
|
this._layersMaxZoom = maxZoom === -Infinity ? undefined : maxZoom;
|
|
this._layersMinZoom = minZoom === Infinity ? undefined : minZoom;
|
|
|
|
// @section Map state change events
|
|
// @event zoomlevelschange: Event
|
|
// Fired when the number of zoomlevels on the map is changed due
|
|
// to adding or removing a layer.
|
|
if (oldZoomSpan !== this._getZoomSpan()) {
|
|
this.fire('zoomlevelschange');
|
|
}
|
|
|
|
if (this.options.maxZoom === undefined && this._layersMaxZoom && this.getZoom() > this._layersMaxZoom) {
|
|
this.setZoom(this._layersMaxZoom);
|
|
}
|
|
if (this.options.minZoom === undefined && this._layersMinZoom && this.getZoom() < this._layersMinZoom) {
|
|
this.setZoom(this._layersMinZoom);
|
|
}
|
|
}
|
|
});
|
|
|
|
/*
|
|
* @class LayerGroup
|
|
* @inherits Interactive layer
|
|
*
|
|
* Used to group several layers and handle them as one. If you add it to the map,
|
|
* any layers added or removed from the group will be added/removed on the map as
|
|
* well. Extends `Layer`.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* new LayerGroup([marker1, marker2])
|
|
* .addLayer(polyline)
|
|
* .addTo(map);
|
|
* ```
|
|
*/
|
|
|
|
// @constructor LayerGroup(layers?: Layer[], options?: Object)
|
|
// Create a layer group, optionally given an initial set of layers and an `options` object.
|
|
class LayerGroup extends Layer {
|
|
|
|
initialize(layers, options) { // for compatibility of code using `LayerGroup.extend`
|
|
setOptions(this, options);
|
|
|
|
this._layers = {};
|
|
|
|
for (const layer of layers ?? []) {
|
|
this.addLayer(layer);
|
|
}
|
|
}
|
|
|
|
// @method addLayer(layer: Layer): this
|
|
// Adds the given layer to the group.
|
|
addLayer(layer) {
|
|
const id = this.getLayerId(layer);
|
|
|
|
this._layers[id] = layer;
|
|
|
|
this._map?.addLayer(layer);
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method removeLayer(layer: Layer): this
|
|
// Removes the given layer from the group.
|
|
// @alternative
|
|
// @method removeLayer(id: Number): this
|
|
// Removes the layer with the given internal ID from the group.
|
|
removeLayer(layer) {
|
|
const id = layer in this._layers ? layer : this.getLayerId(layer);
|
|
|
|
if (this._map && this._layers[id]) {
|
|
this._map.removeLayer(this._layers[id]);
|
|
}
|
|
|
|
delete this._layers[id];
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method hasLayer(layer: Layer): Boolean
|
|
// Returns `true` if the given layer is currently added to the group.
|
|
// @alternative
|
|
// @method hasLayer(id: Number): Boolean
|
|
// Returns `true` if the given internal ID is currently added to the group.
|
|
hasLayer(layer) {
|
|
const layerId = typeof layer === 'number' ? layer : this.getLayerId(layer);
|
|
return layerId in this._layers;
|
|
}
|
|
|
|
// @method clearLayers(): this
|
|
// Removes all the layers from the group.
|
|
clearLayers() {
|
|
return this.eachLayer(this.removeLayer, this);
|
|
}
|
|
|
|
// @method invoke(methodName: String, …): this
|
|
// Calls `methodName` on every layer contained in this group, passing any
|
|
// additional parameters. Has no effect if the layers contained do not
|
|
// implement `methodName`.
|
|
invoke(methodName, ...args) {
|
|
for (const layer of Object.values(this._layers)) {
|
|
layer[methodName]?.apply(layer, args);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
onAdd(map) {
|
|
this.eachLayer(map.addLayer, map);
|
|
}
|
|
|
|
onRemove(map) {
|
|
this.eachLayer(map.removeLayer, map);
|
|
}
|
|
|
|
// @method eachLayer(fn: Function, context?: Object): this
|
|
// Iterates over the layers of the group, optionally specifying context of the iterator function.
|
|
// ```js
|
|
// group.eachLayer(layer => layer.bindPopup('Hello'));
|
|
// ```
|
|
eachLayer(method, context) {
|
|
for (const layer of Object.values(this._layers)) {
|
|
method.call(context, layer);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method getLayer(id: Number): Layer
|
|
// Returns the layer with the given internal ID.
|
|
getLayer(id) {
|
|
return this._layers[id];
|
|
}
|
|
|
|
// @method getLayers(): Layer[]
|
|
// Returns an array of all the layers added to the group.
|
|
getLayers() {
|
|
const layers = [];
|
|
this.eachLayer(layers.push, layers);
|
|
return layers;
|
|
}
|
|
|
|
// @method setZIndex(zIndex: Number): this
|
|
// Calls `setZIndex` on every layer contained in this group, passing the z-index.
|
|
setZIndex(zIndex) {
|
|
return this.invoke('setZIndex', zIndex);
|
|
}
|
|
|
|
// @method getLayerId(layer: Layer): Number
|
|
// Returns the internal ID for a layer
|
|
getLayerId(layer) {
|
|
return stamp(layer);
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class FeatureGroup
|
|
* @inherits LayerGroup
|
|
*
|
|
* Extended `LayerGroup` that makes it easier to do the same thing to all its member layers:
|
|
* * [`bindPopup`](#layer-bindpopup) binds a popup to all of the layers at once (likewise with [`bindTooltip`](#layer-bindtooltip))
|
|
* * Events are propagated to the `FeatureGroup`, so if the group has an event
|
|
* handler, it will handle events from any of the layers. This includes pointer events
|
|
* and custom events.
|
|
* * Has `layeradd` and `layerremove` events
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* new FeatureGroup([marker1, marker2, polyline])
|
|
* .bindPopup('Hello world!')
|
|
* .on('click', function() { alert('Clicked on a member of the group!'); })
|
|
* .addTo(map);
|
|
* ```
|
|
*/
|
|
|
|
// @constructor FeatureGroup(layers?: Layer[], options?: Object)
|
|
// Create a feature group, optionally given an initial set of layers and an `options` object.
|
|
class FeatureGroup extends LayerGroup {
|
|
|
|
addLayer(layer) {
|
|
if (this.hasLayer(layer)) {
|
|
return this;
|
|
}
|
|
|
|
layer.addEventParent(this);
|
|
|
|
LayerGroup.prototype.addLayer.call(this, layer);
|
|
|
|
// @event layeradd: LayerEvent
|
|
// Fired when a layer is added to this `FeatureGroup`
|
|
return this.fire('layeradd', {layer});
|
|
}
|
|
|
|
removeLayer(layer) {
|
|
if (!this.hasLayer(layer)) {
|
|
return this;
|
|
}
|
|
if (layer in this._layers) {
|
|
layer = this._layers[layer];
|
|
}
|
|
|
|
layer.removeEventParent(this);
|
|
|
|
LayerGroup.prototype.removeLayer.call(this, layer);
|
|
|
|
// @event layerremove: LayerEvent
|
|
// Fired when a layer is removed from this `FeatureGroup`
|
|
return this.fire('layerremove', {layer});
|
|
}
|
|
|
|
// @method setStyle(style: Path options): this
|
|
// Sets the given path options to each layer of the group that has a `setStyle` method.
|
|
setStyle(style) {
|
|
return this.invoke('setStyle', style);
|
|
}
|
|
|
|
// @method bringToFront(): this
|
|
// Brings the layer group to the top of all other layers
|
|
bringToFront() {
|
|
return this.invoke('bringToFront');
|
|
}
|
|
|
|
// @method bringToBack(): this
|
|
// Brings the layer group to the back of all other layers
|
|
bringToBack() {
|
|
return this.invoke('bringToBack');
|
|
}
|
|
|
|
// @method getBounds(): LatLngBounds
|
|
// Returns the LatLngBounds of the Feature Group (created from bounds and coordinates of its children).
|
|
getBounds() {
|
|
const bounds = new LatLngBounds();
|
|
|
|
for (const layer of Object.values(this._layers)) {
|
|
bounds.extend(layer.getBounds ? layer.getBounds() : layer.getLatLng());
|
|
}
|
|
return bounds;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class Icon
|
|
*
|
|
* Represents an icon to provide when creating a marker.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* const myIcon = new Icon({
|
|
* iconUrl: 'my-icon.png',
|
|
* iconRetinaUrl: 'my-icon@2x.png',
|
|
* iconSize: [38, 95],
|
|
* iconAnchor: [22, 94],
|
|
* popupAnchor: [-3, -76],
|
|
* shadowUrl: 'my-icon-shadow.png',
|
|
* shadowRetinaUrl: 'my-icon-shadow@2x.png',
|
|
* shadowSize: [68, 95],
|
|
* shadowAnchor: [22, 94]
|
|
* });
|
|
*
|
|
* new Marker([50.505, 30.57], {icon: myIcon}).addTo(map);
|
|
* ```
|
|
*
|
|
* `Icon.Default` extends `Icon` and is the blue icon Leaflet uses for markers by default.
|
|
*
|
|
*/
|
|
|
|
// @constructor Icon(options: Icon options)
|
|
// Creates an icon instance with the given options.
|
|
class Icon extends Class {
|
|
|
|
static {
|
|
/* @section
|
|
* @aka Icon options
|
|
*
|
|
* @option iconUrl: String = null
|
|
* **(required)** The URL to the icon image (absolute or relative to your script path).
|
|
*
|
|
* @option iconRetinaUrl: String = null
|
|
* The URL to a retina sized version of the icon image (absolute or relative to your
|
|
* script path). Used for Retina screen devices.
|
|
*
|
|
* @option iconSize: Point = null
|
|
* Size of the icon image in pixels.
|
|
*
|
|
* @option iconAnchor: Point = null
|
|
* The coordinates of the "tip" of the icon (relative to its top left corner). The icon
|
|
* will be aligned so that this point is at the marker's geographical location. Centered
|
|
* by default if size is specified, also can be set in CSS with negative margins.
|
|
*
|
|
* @option popupAnchor: Point = [0, 0]
|
|
* The coordinates of the point from which popups will "open", relative to the icon anchor.
|
|
*
|
|
* @option tooltipAnchor: Point = [0, 0]
|
|
* The coordinates of the point from which tooltips will "open", relative to the icon anchor.
|
|
*
|
|
* @option shadowUrl: String = null
|
|
* The URL to the icon shadow image. If not specified, no shadow image will be created.
|
|
*
|
|
* @option shadowRetinaUrl: String = null
|
|
*
|
|
* @option shadowSize: Point = null
|
|
* Size of the shadow image in pixels.
|
|
*
|
|
* @option shadowAnchor: Point = null
|
|
* The coordinates of the "tip" of the shadow (relative to its top left corner) (the same
|
|
* as iconAnchor if not specified).
|
|
*
|
|
* @option className: String = ''
|
|
* A custom class name to assign to both icon and shadow images. Empty by default.
|
|
*/
|
|
this.setDefaultOptions({
|
|
popupAnchor: [0, 0],
|
|
tooltipAnchor: [0, 0],
|
|
|
|
// @option crossOrigin: Boolean|String = false
|
|
// Whether the crossOrigin attribute will be added to the tiles.
|
|
// If a String is provided, all tiles will have their crossOrigin attribute set to the String provided. This is needed if you want to access tile pixel data.
|
|
// Refer to [CORS Settings](https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes) for valid String values.
|
|
crossOrigin: false
|
|
});
|
|
}
|
|
|
|
initialize(options) {
|
|
setOptions(this, options);
|
|
}
|
|
|
|
// @method createIcon(oldIcon?: HTMLElement): HTMLElement
|
|
// Called internally when the icon has to be shown, returns a `<img>` HTML element
|
|
// styled according to the options.
|
|
createIcon(oldIcon) {
|
|
return this._createIcon('icon', oldIcon);
|
|
}
|
|
|
|
// @method createShadow(oldIcon?: HTMLElement): HTMLElement
|
|
// As `createIcon`, but for the shadow beneath it.
|
|
createShadow(oldIcon) {
|
|
return this._createIcon('shadow', oldIcon);
|
|
}
|
|
|
|
_createIcon(name, oldIcon) {
|
|
const src = this._getIconUrl(name);
|
|
|
|
if (!src) {
|
|
if (name === 'icon') {
|
|
throw new Error('iconUrl not set in Icon options (see the docs).');
|
|
}
|
|
return null;
|
|
}
|
|
|
|
const img = this._createImg(src, oldIcon && oldIcon.tagName === 'IMG' ? oldIcon : null);
|
|
this._setIconStyles(img, name);
|
|
|
|
if (this.options.crossOrigin || this.options.crossOrigin === '') {
|
|
img.crossOrigin = this.options.crossOrigin === true ? '' : this.options.crossOrigin;
|
|
}
|
|
|
|
return img;
|
|
}
|
|
|
|
_setIconStyles(img, name) {
|
|
const options = this.options;
|
|
let sizeOption = options[`${name}Size`];
|
|
|
|
if (typeof sizeOption === 'number') {
|
|
sizeOption = [sizeOption, sizeOption];
|
|
}
|
|
|
|
const size = Point.validate(sizeOption) && new Point(sizeOption);
|
|
|
|
const anchorPosition = name === 'shadow' && options.shadowAnchor || options.iconAnchor || size && size.divideBy(2, true);
|
|
const anchor = Point.validate(anchorPosition) && new Point(anchorPosition);
|
|
|
|
img.className = `leaflet-marker-${name} ${options.className || ''}`;
|
|
|
|
if (anchor) {
|
|
img.style.marginLeft = `${-anchor.x}px`;
|
|
img.style.marginTop = `${-anchor.y}px`;
|
|
}
|
|
|
|
if (size) {
|
|
img.style.width = `${size.x}px`;
|
|
img.style.height = `${size.y}px`;
|
|
}
|
|
}
|
|
|
|
_createImg(src, el) {
|
|
el ??= document.createElement('img');
|
|
el.src = src;
|
|
return el;
|
|
}
|
|
|
|
_getIconUrl(name) {
|
|
return Browser.retina && this.options[`${name}RetinaUrl`] || this.options[`${name}Url`];
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @miniclass Icon.Default (Icon)
|
|
* @section
|
|
*
|
|
* A trivial subclass of `Icon`, represents the icon to use in `Marker`s when
|
|
* no icon is specified. Points to the blue marker image distributed with Leaflet
|
|
* releases.
|
|
*
|
|
* In order to customize the default icon, just change the properties of `Icon.Default.prototype.options`
|
|
* (which is a set of `Icon options`).
|
|
*
|
|
* If you want to _completely_ replace the default icon, override the
|
|
* `Marker.prototype.options.icon` with your own icon instead.
|
|
*/
|
|
|
|
class IconDefault extends Icon {
|
|
|
|
static {
|
|
this.setDefaultOptions({
|
|
iconUrl: 'marker-icon.png',
|
|
iconRetinaUrl: 'marker-icon-2x.png',
|
|
shadowUrl: 'marker-shadow.png',
|
|
iconSize: [25, 41],
|
|
iconAnchor: [12, 41],
|
|
popupAnchor: [1, -34],
|
|
tooltipAnchor: [16, -28],
|
|
shadowSize: [41, 41]
|
|
});
|
|
}
|
|
|
|
_getIconUrl(name) {
|
|
// only detect once
|
|
if (!IconDefault.imagePath) {
|
|
IconDefault.imagePath = this._detectIconPath();
|
|
}
|
|
|
|
const url = Icon.prototype._getIconUrl.call(this, name);
|
|
if (!url) {
|
|
return null;
|
|
}
|
|
|
|
// @option imagePath: String
|
|
// `Icon.Default` will try to auto-detect the location of the
|
|
// blue icon images. If you are placing these images in a non-standard
|
|
// way, set this option to point to the right path.
|
|
return (this.options.imagePath || IconDefault.imagePath) + url;
|
|
}
|
|
|
|
_stripUrl(path) { // separate function to use in tests
|
|
const strip = function (str, re, idx) {
|
|
const match = re.exec(str);
|
|
return match && match[idx];
|
|
};
|
|
path = strip(path, /^url\((['"])?(.+)\1\)$/, 2);
|
|
return path && strip(path, /^(.*)marker-icon\.png$/, 1);
|
|
}
|
|
|
|
_detectIconPath() {
|
|
const el = create$1('div', 'leaflet-default-icon-path', document.body);
|
|
const path = this._stripUrl(getComputedStyle(el).backgroundImage);
|
|
|
|
document.body.removeChild(el);
|
|
if (path) { return path; }
|
|
const link = document.querySelector('link[href$="leaflet.css"]');
|
|
if (!link) { return ''; }
|
|
return link.href.substring(0, link.href.length - 'leaflet.css'.length - 1);
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Handler.MarkerDrag is used internally by Marker to make the markers draggable.
|
|
*/
|
|
|
|
|
|
/* @namespace Marker
|
|
* @section Interaction handlers
|
|
*
|
|
* Interaction handlers are properties of a marker instance that allow you to control interaction behavior in runtime, enabling or disabling certain features such as dragging (see `Handler` methods). Example:
|
|
*
|
|
* ```js
|
|
* marker.dragging.disable();
|
|
* ```
|
|
*
|
|
* @property dragging: Handler
|
|
* Marker dragging handler. Only valid when the marker is on the map (Otherwise set [`marker.options.draggable`](#marker-draggable)).
|
|
*/
|
|
|
|
class MarkerDrag extends Handler {
|
|
initialize(marker) {
|
|
this._marker = marker;
|
|
}
|
|
|
|
addHooks() {
|
|
const icon = this._marker._icon;
|
|
|
|
if (!this._draggable) {
|
|
this._draggable = new Draggable(icon, icon, true);
|
|
}
|
|
|
|
this._draggable.on({
|
|
dragstart: this._onDragStart,
|
|
predrag: this._onPreDrag,
|
|
drag: this._onDrag,
|
|
dragend: this._onDragEnd
|
|
}, this).enable();
|
|
|
|
icon.classList.add('leaflet-marker-draggable');
|
|
}
|
|
|
|
removeHooks() {
|
|
this._draggable.off({
|
|
dragstart: this._onDragStart,
|
|
predrag: this._onPreDrag,
|
|
drag: this._onDrag,
|
|
dragend: this._onDragEnd
|
|
}, this).disable();
|
|
|
|
this._marker._icon?.classList.remove('leaflet-marker-draggable');
|
|
}
|
|
|
|
moved() {
|
|
return this._draggable?._moved;
|
|
}
|
|
|
|
_adjustPan(e) {
|
|
const marker = this._marker,
|
|
map = marker._map,
|
|
speed = this._marker.options.autoPanSpeed,
|
|
padding = this._marker.options.autoPanPadding,
|
|
iconPos = getPosition(marker._icon),
|
|
bounds = map.getPixelBounds(),
|
|
origin = map.getPixelOrigin();
|
|
|
|
const panBounds = new Bounds(
|
|
bounds.min._subtract(origin).add(padding),
|
|
bounds.max._subtract(origin).subtract(padding)
|
|
);
|
|
|
|
if (!panBounds.contains(iconPos)) {
|
|
// Compute incremental movement
|
|
const movement = new Point(
|
|
(Math.max(panBounds.max.x, iconPos.x) - panBounds.max.x) / (bounds.max.x - panBounds.max.x) -
|
|
(Math.min(panBounds.min.x, iconPos.x) - panBounds.min.x) / (bounds.min.x - panBounds.min.x),
|
|
|
|
(Math.max(panBounds.max.y, iconPos.y) - panBounds.max.y) / (bounds.max.y - panBounds.max.y) -
|
|
(Math.min(panBounds.min.y, iconPos.y) - panBounds.min.y) / (bounds.min.y - panBounds.min.y)
|
|
).multiplyBy(speed);
|
|
|
|
map.panBy(movement, {animate: false});
|
|
|
|
this._draggable._newPos._add(movement);
|
|
this._draggable._startPos._add(movement);
|
|
|
|
setPosition(marker._icon, this._draggable._newPos);
|
|
this._onDrag(e);
|
|
|
|
this._panRequest = requestAnimationFrame(this._adjustPan.bind(this, e));
|
|
}
|
|
}
|
|
|
|
_onDragStart() {
|
|
// @section Dragging events
|
|
// @event dragstart: Event
|
|
// Fired when the user starts dragging the marker.
|
|
|
|
// @event movestart: Event
|
|
// Fired when the marker starts moving (because of dragging).
|
|
|
|
this._oldLatLng = this._marker.getLatLng();
|
|
|
|
// When using ES6 imports it could not be set when `Popup` was not imported as well
|
|
this._marker.closePopup?.();
|
|
|
|
this._marker
|
|
.fire('movestart')
|
|
.fire('dragstart');
|
|
}
|
|
|
|
_onPreDrag(e) {
|
|
if (this._marker.options.autoPan) {
|
|
cancelAnimationFrame(this._panRequest);
|
|
this._panRequest = requestAnimationFrame(this._adjustPan.bind(this, e));
|
|
}
|
|
}
|
|
|
|
_onDrag(e) {
|
|
const marker = this._marker,
|
|
shadow = marker._shadow,
|
|
iconPos = getPosition(marker._icon),
|
|
latlng = marker._map.layerPointToLatLng(iconPos);
|
|
|
|
// update shadow position
|
|
if (shadow) {
|
|
setPosition(shadow, iconPos);
|
|
}
|
|
|
|
marker._latlng = latlng;
|
|
e.latlng = latlng;
|
|
e.oldLatLng = this._oldLatLng;
|
|
|
|
// @event drag: Event
|
|
// Fired repeatedly while the user drags the marker.
|
|
marker
|
|
.fire('move', e)
|
|
.fire('drag', e);
|
|
}
|
|
|
|
_onDragEnd(e) {
|
|
// @event dragend: DragEndEvent
|
|
// Fired when the user stops dragging the marker.
|
|
|
|
cancelAnimationFrame(this._panRequest);
|
|
|
|
// @event moveend: Event
|
|
// Fired when the marker stops moving (because of dragging).
|
|
delete this._oldLatLng;
|
|
this._marker
|
|
.fire('moveend')
|
|
.fire('dragend', e);
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class Marker
|
|
* @inherits Interactive layer
|
|
* Marker is used to display clickable/draggable icons on the map. Extends `Layer`.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* new Marker([50.5, 30.5]).addTo(map);
|
|
* ```
|
|
*/
|
|
|
|
// @constructor Marker(latlng: LatLng, options? : Marker options)
|
|
// Instantiates a Marker object given a geographical point and optionally an options object.
|
|
class Marker extends Layer {
|
|
|
|
static {
|
|
// @section
|
|
// @aka Marker options
|
|
this.setDefaultOptions({
|
|
// @option icon: Icon = *
|
|
// Icon instance to use for rendering the marker.
|
|
// See [Icon documentation](#Icon) for details on how to customize the marker icon.
|
|
// If not specified, a common instance of `Icon.Default` is used.
|
|
icon: new IconDefault(),
|
|
|
|
// Option inherited from "Interactive layer" abstract class
|
|
interactive: true,
|
|
|
|
// @option keyboard: Boolean = true
|
|
// Whether the marker can be tabbed to with a keyboard and clicked by pressing enter.
|
|
keyboard: true,
|
|
|
|
// @option title: String = ''
|
|
// Text for the browser tooltip that appear on marker hover (no tooltip by default).
|
|
// [Useful for accessibility](https://leafletjs.com/examples/accessibility/#markers-must-be-labelled).
|
|
title: '',
|
|
|
|
// @option alt: String = 'Marker'
|
|
// Text for the `alt` attribute of the icon image.
|
|
// [Useful for accessibility](https://leafletjs.com/examples/accessibility/#markers-must-be-labelled).
|
|
alt: 'Marker',
|
|
|
|
// @option zIndexOffset: Number = 0
|
|
// By default, marker images zIndex is set automatically based on its latitude. Use this option if you want to put the marker on top of all others (or below), specifying a high value like `1000` (or high negative value, respectively).
|
|
zIndexOffset: 0,
|
|
|
|
// @option opacity: Number = 1.0
|
|
// The opacity of the marker.
|
|
opacity: 1,
|
|
|
|
// @option riseOnHover: Boolean = false
|
|
// If `true`, the marker will get on top of others when you hover the pointer over it.
|
|
riseOnHover: false,
|
|
|
|
// @option riseOffset: Number = 250
|
|
// The z-index offset used for the `riseOnHover` feature.
|
|
riseOffset: 250,
|
|
|
|
// @option pane: String = 'markerPane'
|
|
// `Map pane` where the markers icon will be added.
|
|
pane: 'markerPane',
|
|
|
|
// @option shadowPane: String = 'shadowPane'
|
|
// `Map pane` where the markers shadow will be added.
|
|
shadowPane: 'shadowPane',
|
|
|
|
// @option bubblingPointerEvents: Boolean = false
|
|
// When `true`, a pointer event on this marker will trigger the same event on the map
|
|
// (unless [`DomEvent.stopPropagation`](#domevent-stoppropagation) is used).
|
|
bubblingPointerEvents: false,
|
|
|
|
// @option autoPanOnFocus: Boolean = true
|
|
// When `true`, the map will pan whenever the marker is focused (via
|
|
// e.g. pressing `tab` on the keyboard) to ensure the marker is
|
|
// visible within the map's bounds
|
|
autoPanOnFocus: true,
|
|
|
|
// @section Draggable marker options
|
|
// @option draggable: Boolean = false
|
|
// Whether the marker is draggable with pointer or not.
|
|
draggable: false,
|
|
|
|
// @option autoPan: Boolean = false
|
|
// Whether to pan the map when dragging this marker near its edge or not.
|
|
autoPan: false,
|
|
|
|
// @option autoPanPadding: Point = Point(50, 50)
|
|
// Distance (in pixels to the left/right and to the top/bottom) of the
|
|
// map edge to start panning the map.
|
|
autoPanPadding: [50, 50],
|
|
|
|
// @option autoPanSpeed: Number = 10
|
|
// Number of pixels the map should pan by.
|
|
autoPanSpeed: 10
|
|
});
|
|
}
|
|
|
|
/* @section
|
|
*
|
|
* In addition to [shared layer methods](#Layer) like `addTo()` and `remove()` and [popup methods](#Popup) like bindPopup() you can also use the following methods:
|
|
*/
|
|
|
|
initialize(latlng, options) {
|
|
setOptions(this, options);
|
|
this._latlng = new LatLng(latlng);
|
|
}
|
|
|
|
onAdd(map) {
|
|
this._zoomAnimated = this._zoomAnimated && map.options.markerZoomAnimation;
|
|
|
|
if (this._zoomAnimated) {
|
|
map.on('zoomanim', this._animateZoom, this);
|
|
}
|
|
|
|
this._initIcon();
|
|
this.update();
|
|
}
|
|
|
|
onRemove(map) {
|
|
if (this.dragging?.enabled()) {
|
|
this.options.draggable = true;
|
|
this.dragging.removeHooks();
|
|
}
|
|
delete this.dragging;
|
|
|
|
if (this._zoomAnimated) {
|
|
map.off('zoomanim', this._animateZoom, this);
|
|
}
|
|
|
|
this._removeIcon();
|
|
this._removeShadow();
|
|
}
|
|
|
|
getEvents() {
|
|
return {
|
|
zoom: this.update,
|
|
viewreset: this.update
|
|
};
|
|
}
|
|
|
|
// @method getLatLng: LatLng
|
|
// Returns the current geographical position of the marker.
|
|
getLatLng() {
|
|
return this._latlng;
|
|
}
|
|
|
|
// @method setLatLng(latlng: LatLng): this
|
|
// Changes the marker position to the given point.
|
|
setLatLng(latlng) {
|
|
const oldLatLng = this._latlng;
|
|
this._latlng = new LatLng(latlng);
|
|
this.update();
|
|
|
|
// @event move: Event
|
|
// Fired when the marker is moved via [`setLatLng`](#marker-setlatlng) or by [dragging](#marker-dragging). Old and new coordinates are included in event arguments as `oldLatLng`, `latlng`.
|
|
return this.fire('move', {oldLatLng, latlng: this._latlng});
|
|
}
|
|
|
|
// @method setZIndexOffset(offset: Number): this
|
|
// Changes the [zIndex offset](#marker-zindexoffset) of the marker.
|
|
setZIndexOffset(offset) {
|
|
this.options.zIndexOffset = offset;
|
|
return this.update();
|
|
}
|
|
|
|
// @method getIcon: Icon
|
|
// Returns the current icon used by the marker
|
|
getIcon() {
|
|
return this.options.icon;
|
|
}
|
|
|
|
// @method setIcon(icon: Icon): this
|
|
// Changes the marker icon.
|
|
setIcon(icon) {
|
|
|
|
this.options.icon = icon;
|
|
|
|
if (this._map) {
|
|
this._initIcon();
|
|
this.update();
|
|
}
|
|
|
|
if (this._popup) {
|
|
this.bindPopup(this._popup, this._popup.options);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method getElement(): HTMLElement
|
|
// Returns the instance of [`HTMLElement`](https://developer.mozilla.org/docs/Web/API/HTMLElement)
|
|
// used by Marker layer.
|
|
getElement() {
|
|
return this._icon;
|
|
}
|
|
|
|
update() {
|
|
|
|
if (this._icon && this._map) {
|
|
const pos = this._map.latLngToLayerPoint(this._latlng).round();
|
|
this._setPos(pos);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
_initIcon() {
|
|
const options = this.options,
|
|
classToAdd = `leaflet-zoom-${this._zoomAnimated ? 'animated' : 'hide'}`;
|
|
|
|
const icon = options.icon.createIcon(this._icon);
|
|
let addIcon = false;
|
|
|
|
// if we're not reusing the icon, remove the old one and init new one
|
|
if (icon !== this._icon) {
|
|
if (this._icon) {
|
|
this._removeIcon();
|
|
}
|
|
addIcon = true;
|
|
|
|
if (options.title) {
|
|
icon.title = options.title;
|
|
}
|
|
|
|
if (icon.tagName === 'IMG') {
|
|
icon.alt = options.alt ?? '';
|
|
}
|
|
}
|
|
|
|
icon.classList.add(classToAdd);
|
|
|
|
if (options.keyboard) {
|
|
icon.tabIndex = '0';
|
|
icon.setAttribute('role', 'button');
|
|
}
|
|
|
|
this._icon = icon;
|
|
|
|
if (options.riseOnHover) {
|
|
this.on({
|
|
pointerover: this._bringToFront,
|
|
pointerout: this._resetZIndex
|
|
});
|
|
}
|
|
|
|
if (this.options.autoPanOnFocus) {
|
|
on(icon, 'focus', this._panOnFocus, this);
|
|
}
|
|
|
|
const newShadow = options.icon.createShadow(this._shadow);
|
|
let addShadow = false;
|
|
|
|
if (newShadow !== this._shadow) {
|
|
this._removeShadow();
|
|
addShadow = true;
|
|
}
|
|
|
|
if (newShadow) {
|
|
newShadow.classList.add(classToAdd);
|
|
newShadow.alt = '';
|
|
}
|
|
this._shadow = newShadow;
|
|
|
|
|
|
if (options.opacity < 1) {
|
|
this._updateOpacity();
|
|
}
|
|
|
|
|
|
if (addIcon) {
|
|
this.getPane().appendChild(this._icon);
|
|
}
|
|
this._initInteraction();
|
|
if (newShadow && addShadow) {
|
|
this.getPane(options.shadowPane).appendChild(this._shadow);
|
|
}
|
|
}
|
|
|
|
_removeIcon() {
|
|
if (this.options.riseOnHover) {
|
|
this.off({
|
|
pointerover: this._bringToFront,
|
|
pointerout: this._resetZIndex
|
|
});
|
|
}
|
|
|
|
if (this.options.autoPanOnFocus) {
|
|
off(this._icon, 'focus', this._panOnFocus, this);
|
|
}
|
|
|
|
this._icon.remove();
|
|
this.removeInteractiveTarget(this._icon);
|
|
|
|
this._icon = null;
|
|
}
|
|
|
|
_removeShadow() {
|
|
this._shadow?.remove();
|
|
this._shadow = null;
|
|
}
|
|
|
|
_setPos(pos) {
|
|
|
|
if (this._icon) {
|
|
setPosition(this._icon, pos);
|
|
}
|
|
|
|
if (this._shadow) {
|
|
setPosition(this._shadow, pos);
|
|
}
|
|
|
|
this._zIndex = pos.y + this.options.zIndexOffset;
|
|
|
|
this._resetZIndex();
|
|
}
|
|
|
|
_updateZIndex(offset) {
|
|
if (this._icon) {
|
|
this._icon.style.zIndex = this._zIndex + offset;
|
|
}
|
|
}
|
|
|
|
_animateZoom(opt) {
|
|
const pos = this._map._latLngToNewLayerPoint(this._latlng, opt.zoom, opt.center).round();
|
|
|
|
this._setPos(pos);
|
|
}
|
|
|
|
_initInteraction() {
|
|
|
|
if (!this.options.interactive) { return; }
|
|
|
|
this._icon.classList.add('leaflet-interactive');
|
|
|
|
this.addInteractiveTarget(this._icon);
|
|
|
|
if (MarkerDrag) {
|
|
let draggable = this.options.draggable;
|
|
if (this.dragging) {
|
|
draggable = this.dragging.enabled();
|
|
this.dragging.disable();
|
|
}
|
|
|
|
this.dragging = new MarkerDrag(this);
|
|
|
|
if (draggable) {
|
|
this.dragging.enable();
|
|
}
|
|
}
|
|
}
|
|
|
|
// @method setOpacity(opacity: Number): this
|
|
// Changes the opacity of the marker.
|
|
setOpacity(opacity) {
|
|
this.options.opacity = opacity;
|
|
if (this._map) {
|
|
this._updateOpacity();
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
_updateOpacity() {
|
|
const opacity = this.options.opacity;
|
|
|
|
if (this._icon) {
|
|
this._icon.style.opacity = opacity;
|
|
}
|
|
|
|
if (this._shadow) {
|
|
this._shadow.style.opacity = opacity;
|
|
}
|
|
}
|
|
|
|
_bringToFront() {
|
|
this._updateZIndex(this.options.riseOffset);
|
|
}
|
|
|
|
_resetZIndex() {
|
|
this._updateZIndex(0);
|
|
}
|
|
|
|
_panOnFocus() {
|
|
const map = this._map;
|
|
if (!map) { return; }
|
|
|
|
const iconOpts = this.options.icon.options;
|
|
const size = iconOpts.iconSize ? new Point(iconOpts.iconSize) : new Point(0, 0);
|
|
const anchor = iconOpts.iconAnchor ? new Point(iconOpts.iconAnchor) : new Point(0, 0);
|
|
|
|
map.panInside(this._latlng, {
|
|
paddingTopLeft: anchor,
|
|
paddingBottomRight: size.subtract(anchor)
|
|
});
|
|
}
|
|
|
|
_getPopupAnchor() {
|
|
return this.options.icon.options.popupAnchor;
|
|
}
|
|
|
|
_getTooltipAnchor() {
|
|
return this.options.icon.options.tooltipAnchor;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class Path
|
|
* @inherits Interactive layer
|
|
*
|
|
* An abstract class that contains options and constants shared between vector
|
|
* overlays (Polygon, Polyline, Circle). Do not use it directly. Extends `Layer`.
|
|
*/
|
|
|
|
class Path extends Layer {
|
|
|
|
static {
|
|
// @section
|
|
// @aka Path options
|
|
this.setDefaultOptions({
|
|
// @option stroke: Boolean = true
|
|
// Whether to draw stroke along the path. Set it to `false` to disable borders on polygons or circles.
|
|
stroke: true,
|
|
|
|
// @option color: String = '#3388ff'
|
|
// Stroke color
|
|
color: '#3388ff',
|
|
|
|
// @option weight: Number = 3
|
|
// Stroke width in pixels
|
|
weight: 3,
|
|
|
|
// @option opacity: Number = 1.0
|
|
// Stroke opacity
|
|
opacity: 1,
|
|
|
|
// @option lineCap: String= 'round'
|
|
// A string that defines [shape to be used at the end](https://developer.mozilla.org/docs/Web/SVG/Attribute/stroke-linecap) of the stroke.
|
|
lineCap: 'round',
|
|
|
|
// @option lineJoin: String = 'round'
|
|
// A string that defines [shape to be used at the corners](https://developer.mozilla.org/docs/Web/SVG/Attribute/stroke-linejoin) of the stroke.
|
|
lineJoin: 'round',
|
|
|
|
// @option dashArray: String = null
|
|
// A string that defines the stroke [dash pattern](https://developer.mozilla.org/docs/Web/SVG/Attribute/stroke-dasharray).
|
|
dashArray: null,
|
|
|
|
// @option dashOffset: String = null
|
|
// A string that defines the [distance into the dash pattern to start the dash](https://developer.mozilla.org/docs/Web/SVG/Attribute/stroke-dashoffset).
|
|
dashOffset: null,
|
|
|
|
// @option fill: Boolean = depends
|
|
// Whether to fill the path with color. Set it to `false` to disable filling on polygons or circles.
|
|
fill: false,
|
|
|
|
// @option fillColor: String = *
|
|
// Fill color. Defaults to the value of the [`color`](#path-color) option
|
|
fillColor: null,
|
|
|
|
// @option fillOpacity: Number = 0.2
|
|
// Fill opacity.
|
|
fillOpacity: 0.2,
|
|
|
|
// @option fillRule: String = 'evenodd'
|
|
// A string that defines [how the inside of a shape](https://developer.mozilla.org/docs/Web/SVG/Attribute/fill-rule) is determined.
|
|
fillRule: 'evenodd',
|
|
|
|
// className: '',
|
|
|
|
// Option inherited from "Interactive layer" abstract class
|
|
interactive: true,
|
|
|
|
// @option bubblingPointerEvents: Boolean = true
|
|
// When `true`, a pointer event on this path will trigger the same event on the map
|
|
// (unless [`DomEvent.stopPropagation`](#domevent-stoppropagation) is used).
|
|
bubblingPointerEvents: true
|
|
});
|
|
}
|
|
|
|
beforeAdd(map) {
|
|
// Renderer is set here because we need to call renderer.getEvents
|
|
// before this.getEvents.
|
|
this._renderer = map.getRenderer(this);
|
|
}
|
|
|
|
onAdd() {
|
|
this._renderer._initPath(this);
|
|
this._reset();
|
|
this._renderer._addPath(this);
|
|
}
|
|
|
|
onRemove() {
|
|
this._renderer._removePath(this);
|
|
}
|
|
|
|
// @method redraw(): this
|
|
// Redraws the layer. Sometimes useful after you changed the coordinates that the path uses.
|
|
redraw() {
|
|
if (this._map) {
|
|
this._renderer._updatePath(this);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method setStyle(style: Path options): this
|
|
// Changes the appearance of a Path based on the options in the `Path options` object.
|
|
setStyle(style) {
|
|
setOptions(this, style);
|
|
if (this._renderer) {
|
|
this._renderer._updateStyle(this);
|
|
if (this.options.stroke && style && Object.hasOwn(style, 'weight')) {
|
|
this._updateBounds();
|
|
}
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method bringToFront(): this
|
|
// Brings the layer to the top of all path layers.
|
|
bringToFront() {
|
|
this._renderer?._bringToFront(this);
|
|
return this;
|
|
}
|
|
|
|
// @method bringToBack(): this
|
|
// Brings the layer to the bottom of all path layers.
|
|
bringToBack() {
|
|
this._renderer?._bringToBack(this);
|
|
return this;
|
|
}
|
|
|
|
getElement() {
|
|
return this._path;
|
|
}
|
|
|
|
_reset() {
|
|
// defined in child classes
|
|
this._project();
|
|
this._update();
|
|
}
|
|
|
|
_clickTolerance() {
|
|
// used when doing hit detection for Canvas layers
|
|
return (this.options.stroke ? this.options.weight / 2 : 0) +
|
|
(this._renderer.options.tolerance || 0);
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class CircleMarker
|
|
* @inherits Path
|
|
*
|
|
* A circle of a fixed size with radius specified in pixels. Extends `Path`.
|
|
*/
|
|
|
|
// @constructor CircleMarker(latlng: LatLng, options?: CircleMarker options)
|
|
// Instantiates a circle marker object given a geographical point, and an optional options object.
|
|
class CircleMarker extends Path {
|
|
|
|
static {
|
|
// @section
|
|
// @aka CircleMarker options
|
|
this.setDefaultOptions({
|
|
fill: true,
|
|
|
|
// @option radius: Number = 10
|
|
// Radius of the circle marker, in pixels
|
|
radius: 10
|
|
});
|
|
}
|
|
|
|
initialize(latlng, options) {
|
|
setOptions(this, options);
|
|
this._latlng = new LatLng(latlng);
|
|
this._radius = this.options.radius;
|
|
}
|
|
|
|
// @method setLatLng(latLng: LatLng): this
|
|
// Sets the position of a circle marker to a new location.
|
|
setLatLng(latlng) {
|
|
const oldLatLng = this._latlng;
|
|
this._latlng = new LatLng(latlng);
|
|
this.redraw();
|
|
|
|
// @event move: Event
|
|
// Fired when the marker is moved via [`setLatLng`](#circlemarker-setlatlng). Old and new coordinates are included in event arguments as `oldLatLng`, `latlng`.
|
|
return this.fire('move', {oldLatLng, latlng: this._latlng});
|
|
}
|
|
|
|
// @method getLatLng(): LatLng
|
|
// Returns the current geographical position of the circle marker
|
|
getLatLng() {
|
|
return this._latlng;
|
|
}
|
|
|
|
// @method setRadius(radius: Number): this
|
|
// Sets the radius of a circle marker. Units are in pixels.
|
|
setRadius(radius) {
|
|
this.options.radius = this._radius = radius;
|
|
return this.redraw();
|
|
}
|
|
|
|
// @method getRadius(): Number
|
|
// Returns the current radius of the circle
|
|
getRadius() {
|
|
return this._radius;
|
|
}
|
|
|
|
setStyle(options) {
|
|
const radius = options?.radius ?? this._radius;
|
|
Path.prototype.setStyle.call(this, options);
|
|
this.setRadius(radius);
|
|
return this;
|
|
}
|
|
|
|
_project() {
|
|
this._point = this._map.latLngToLayerPoint(this._latlng);
|
|
this._updateBounds();
|
|
}
|
|
|
|
_updateBounds() {
|
|
const r = this._radius,
|
|
r2 = this._radiusY ?? r,
|
|
w = this._clickTolerance(),
|
|
p = [r + w, r2 + w];
|
|
this._pxBounds = new Bounds(this._point.subtract(p), this._point.add(p));
|
|
}
|
|
|
|
_update() {
|
|
if (this._map) {
|
|
this._updatePath();
|
|
}
|
|
}
|
|
|
|
_updatePath() {
|
|
this._renderer._updateCircle(this);
|
|
}
|
|
|
|
_empty() {
|
|
return this._radius && !this._renderer._bounds.intersects(this._pxBounds);
|
|
}
|
|
|
|
// Needed by the `Canvas` renderer for interactivity
|
|
_containsPoint(p) {
|
|
return p.distanceTo(this._point) <= this._radius + this._clickTolerance();
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class Circle
|
|
* @inherits CircleMarker
|
|
*
|
|
* A class for drawing circle overlays on a map. Extends `CircleMarker`.
|
|
*
|
|
* It's an approximation and starts to diverge from a real circle closer to poles (due to projection distortion).
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* new Circle([50.5, 30.5], {radius: 200}).addTo(map);
|
|
* ```
|
|
*/
|
|
|
|
// @constructor Circle(latlng: LatLng, options?: Circle options)
|
|
// Instantiates a circle object given a geographical point, and an options object
|
|
// which contains the circle radius.
|
|
class Circle extends CircleMarker {
|
|
|
|
initialize(latlng, options) {
|
|
setOptions(this, options);
|
|
this._latlng = new LatLng(latlng);
|
|
|
|
if (isNaN(this.options.radius)) { throw new Error('Circle radius cannot be NaN'); }
|
|
|
|
// @section
|
|
// @aka Circle options
|
|
// @option radius: Number; Radius of the circle, in meters.
|
|
this._mRadius = this.options.radius;
|
|
}
|
|
|
|
// @method setRadius(radius: Number): this
|
|
// Sets the radius of a circle. Units are in meters.
|
|
setRadius(radius) {
|
|
this._mRadius = radius;
|
|
return this.redraw();
|
|
}
|
|
|
|
// @method getRadius(): Number
|
|
// Returns the current radius of a circle. Units are in meters.
|
|
getRadius() {
|
|
return this._mRadius;
|
|
}
|
|
|
|
// @method getBounds(): LatLngBounds
|
|
// Returns the `LatLngBounds` of the path.
|
|
getBounds() {
|
|
const half = [this._radius, this._radiusY ?? this._radius];
|
|
|
|
return new LatLngBounds(
|
|
this._map.layerPointToLatLng(this._point.subtract(half)),
|
|
this._map.layerPointToLatLng(this._point.add(half)));
|
|
}
|
|
|
|
setStyle = Path.prototype.setStyle;
|
|
|
|
_project() {
|
|
|
|
const lng = this._latlng.lng,
|
|
lat = this._latlng.lat,
|
|
map = this._map,
|
|
crs = map.options.crs;
|
|
|
|
if (crs.distance === Earth.distance) {
|
|
const d = Math.PI / 180,
|
|
latR = (this._mRadius / Earth.R) / d,
|
|
top = map.project([lat + latR, lng]),
|
|
bottom = map.project([lat - latR, lng]),
|
|
p = top.add(bottom).divideBy(2),
|
|
lat2 = map.unproject(p).lat;
|
|
let lngR = Math.acos((Math.cos(latR * d) - Math.sin(lat * d) * Math.sin(lat2 * d)) /
|
|
(Math.cos(lat * d) * Math.cos(lat2 * d))) / d;
|
|
|
|
if (isNaN(lngR) || lngR === 0) {
|
|
lngR = latR / Math.cos(Math.PI / 180 * lat); // Fallback for edge case, #2425
|
|
}
|
|
|
|
this._point = p.subtract(map.getPixelOrigin());
|
|
this._radius = isNaN(lngR) ? 0 : p.x - map.project([lat2, lng - lngR]).x;
|
|
this._radiusY = p.y - top.y;
|
|
|
|
} else {
|
|
const latlng2 = crs.unproject(crs.project(this._latlng).subtract([this._mRadius, 0]));
|
|
|
|
this._point = map.latLngToLayerPoint(this._latlng);
|
|
this._radius = Math.abs(this._point.x - map.latLngToLayerPoint(latlng2).x);
|
|
}
|
|
|
|
this._updateBounds();
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class Polyline
|
|
* @inherits Path
|
|
*
|
|
* A class for drawing polyline overlays on a map. Extends `Path`.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* // create a red polyline from an array of LatLng points
|
|
* const latlngs = [
|
|
* [45.51, -122.68],
|
|
* [37.77, -122.43],
|
|
* [34.04, -118.2]
|
|
* ];
|
|
*
|
|
* const polyline = new Polyline(latlngs, {color: 'red'}).addTo(map);
|
|
*
|
|
* // zoom the map to the polyline
|
|
* map.fitBounds(polyline.getBounds());
|
|
* ```
|
|
*
|
|
* You can also pass a multi-dimensional array to represent a `MultiPolyline` shape:
|
|
*
|
|
* ```js
|
|
* // create a red polyline from an array of arrays of LatLng points
|
|
* const latlngs = [
|
|
* [[45.51, -122.68],
|
|
* [37.77, -122.43],
|
|
* [34.04, -118.2]],
|
|
* [[40.78, -73.91],
|
|
* [41.83, -87.62],
|
|
* [32.76, -96.72]]
|
|
* ];
|
|
* ```
|
|
*/
|
|
|
|
// @constructor Polyline(latlngs: LatLng[], options?: Polyline options)
|
|
// Instantiates a polyline object given an array of geographical points and
|
|
// optionally an options object. You can create a `Polyline` object with
|
|
// multiple separate lines (`MultiPolyline`) by passing an array of arrays
|
|
// of geographic points.
|
|
class Polyline extends Path {
|
|
|
|
static {
|
|
// @section
|
|
// @aka Polyline options
|
|
this.setDefaultOptions({
|
|
// @option smoothFactor: Number = 1.0
|
|
// How much to simplify the polyline on each zoom level. More means
|
|
// better performance and smoother look, and less means more accurate representation.
|
|
smoothFactor: 1.0,
|
|
|
|
// @option noClip: Boolean = false
|
|
// Disable polyline clipping.
|
|
noClip: false
|
|
});
|
|
}
|
|
|
|
initialize(latlngs, options) {
|
|
setOptions(this, options);
|
|
this._setLatLngs(latlngs);
|
|
}
|
|
|
|
// @method getLatLngs(): LatLng[]
|
|
// Returns an array of the points in the path, or nested arrays of points in case of multi-polyline.
|
|
getLatLngs() {
|
|
return this._latlngs;
|
|
}
|
|
|
|
// @method setLatLngs(latlngs: LatLng[]): this
|
|
// Replaces all the points in the polyline with the given array of geographical points.
|
|
setLatLngs(latlngs) {
|
|
this._setLatLngs(latlngs);
|
|
return this.redraw();
|
|
}
|
|
|
|
// @method isEmpty(): Boolean
|
|
// Returns `true` if the Polyline has no LatLngs.
|
|
isEmpty() {
|
|
return !this._latlngs.length;
|
|
}
|
|
|
|
// @method closestLayerPoint(p: Point): Point
|
|
// Returns the point closest to `p` on the Polyline.
|
|
closestLayerPoint(p) {
|
|
p = new Point(p);
|
|
let minDistance = Infinity,
|
|
minPoint = null,
|
|
p1, p2;
|
|
const closest = _sqClosestPointOnSegment;
|
|
|
|
for (const points of this._parts) {
|
|
for (let i = 1, len = points.length; i < len; i++) {
|
|
p1 = points[i - 1];
|
|
p2 = points[i];
|
|
|
|
const sqDist = closest(p, p1, p2, true);
|
|
|
|
if (sqDist < minDistance) {
|
|
minDistance = sqDist;
|
|
minPoint = closest(p, p1, p2);
|
|
}
|
|
}
|
|
}
|
|
if (minPoint) {
|
|
minPoint.distance = Math.sqrt(minDistance);
|
|
}
|
|
return minPoint;
|
|
}
|
|
|
|
// @method getCenter(): LatLng
|
|
// Returns the center ([centroid](https://en.wikipedia.org/wiki/Centroid)) of the polyline.
|
|
getCenter() {
|
|
// throws error when not yet added to map as this center calculation requires projected coordinates
|
|
if (!this._map) {
|
|
throw new Error('Must add layer to map before using getCenter()');
|
|
}
|
|
return polylineCenter(this._defaultShape(), this._map.options.crs);
|
|
}
|
|
|
|
// @method getBounds(): LatLngBounds
|
|
// Returns the `LatLngBounds` of the path.
|
|
getBounds() {
|
|
return this._bounds;
|
|
}
|
|
|
|
// @method addLatLng(latlng: LatLng, latlngs?: LatLng[]): this
|
|
// Adds a given point to the polyline. By default, adds to the first ring of
|
|
// the polyline in case of a multi-polyline, but can be overridden by passing
|
|
// a specific ring as a LatLng array (that you can earlier access with [`getLatLngs`](#polyline-getlatlngs)).
|
|
addLatLng(latlng, latlngs) {
|
|
latlngs ??= this._defaultShape();
|
|
latlng = new LatLng(latlng);
|
|
latlngs.push(latlng);
|
|
this._bounds.extend(latlng);
|
|
return this.redraw();
|
|
}
|
|
|
|
_setLatLngs(latlngs) {
|
|
this._bounds = new LatLngBounds();
|
|
this._latlngs = this._convertLatLngs(latlngs);
|
|
}
|
|
|
|
_defaultShape() {
|
|
return isFlat(this._latlngs) ? this._latlngs : this._latlngs[0];
|
|
}
|
|
|
|
// recursively convert latlngs input into actual LatLng instances; calculate bounds along the way
|
|
_convertLatLngs(latlngs) {
|
|
const result = [],
|
|
flat = isFlat(latlngs);
|
|
|
|
for (let i = 0, len = latlngs.length; i < len; i++) {
|
|
if (flat) {
|
|
result[i] = new LatLng(latlngs[i]);
|
|
this._bounds.extend(result[i]);
|
|
} else {
|
|
result[i] = this._convertLatLngs(latlngs[i]);
|
|
}
|
|
}
|
|
|
|
return result;
|
|
}
|
|
|
|
_project() {
|
|
const pxBounds = new Bounds();
|
|
this._rings = [];
|
|
this._projectLatlngs(this._latlngs, this._rings, pxBounds);
|
|
|
|
if (this._bounds.isValid() && pxBounds.isValid()) {
|
|
this._rawPxBounds = pxBounds;
|
|
this._updateBounds();
|
|
}
|
|
}
|
|
|
|
_updateBounds() {
|
|
const w = this._clickTolerance(),
|
|
p = new Point(w, w);
|
|
|
|
if (!this._rawPxBounds) {
|
|
return;
|
|
}
|
|
|
|
this._pxBounds = new Bounds([
|
|
this._rawPxBounds.min.subtract(p),
|
|
this._rawPxBounds.max.add(p)
|
|
]);
|
|
}
|
|
|
|
// recursively turns latlngs into a set of rings with projected coordinates
|
|
_projectLatlngs(latlngs, result, projectedBounds) {
|
|
const flat = latlngs[0] instanceof LatLng;
|
|
|
|
if (flat) {
|
|
const ring = latlngs.map(latlng => this._map.latLngToLayerPoint(latlng));
|
|
ring.forEach(r => projectedBounds.extend(r));
|
|
result.push(ring);
|
|
} else {
|
|
latlngs.forEach(latlng => this._projectLatlngs(latlng, result, projectedBounds));
|
|
}
|
|
}
|
|
|
|
// clip polyline by renderer bounds so that we have less to render for performance
|
|
_clipPoints() {
|
|
const bounds = this._renderer._bounds;
|
|
|
|
this._parts = [];
|
|
if (!this._pxBounds || !this._pxBounds.intersects(bounds)) {
|
|
return;
|
|
}
|
|
|
|
if (this.options.noClip) {
|
|
this._parts = this._rings;
|
|
return;
|
|
}
|
|
|
|
const parts = this._parts;
|
|
let i, j, k, len, len2, segment, points;
|
|
|
|
for (i = 0, k = 0, len = this._rings.length; i < len; i++) {
|
|
points = this._rings[i];
|
|
|
|
for (j = 0, len2 = points.length; j < len2 - 1; j++) {
|
|
segment = clipSegment(points[j], points[j + 1], bounds, j, true);
|
|
|
|
if (!segment) { continue; }
|
|
|
|
parts[k] ??= [];
|
|
parts[k].push(segment[0]);
|
|
|
|
// if segment goes out of screen, or it's the last one, it's the end of the line part
|
|
if ((segment[1] !== points[j + 1]) || (j === len2 - 2)) {
|
|
parts[k].push(segment[1]);
|
|
k++;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// simplify each clipped part of the polyline for performance
|
|
_simplifyPoints() {
|
|
const parts = this._parts,
|
|
tolerance = this.options.smoothFactor;
|
|
|
|
for (let i = 0, len = parts.length; i < len; i++) {
|
|
parts[i] = simplify(parts[i], tolerance);
|
|
}
|
|
}
|
|
|
|
_update() {
|
|
if (!this._map) { return; }
|
|
|
|
this._clipPoints();
|
|
this._simplifyPoints();
|
|
this._updatePath();
|
|
}
|
|
|
|
_updatePath() {
|
|
this._renderer._updatePoly(this);
|
|
}
|
|
|
|
// Needed by the `Canvas` renderer for interactivity
|
|
_containsPoint(p, closed) {
|
|
let i, j, k, len, len2, part;
|
|
const w = this._clickTolerance();
|
|
|
|
if (!this._pxBounds || !this._pxBounds.contains(p)) { return false; }
|
|
|
|
// hit detection for polylines
|
|
for (i = 0, len = this._parts.length; i < len; i++) {
|
|
part = this._parts[i];
|
|
|
|
for (j = 0, len2 = part.length, k = len2 - 1; j < len2; k = j++) {
|
|
if (!closed && (j === 0)) { continue; }
|
|
|
|
if (pointToSegmentDistance(p, part[k], part[j]) <= w) {
|
|
return true;
|
|
}
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class Polygon
|
|
* @inherits Polyline
|
|
*
|
|
* A class for drawing polygon overlays on a map. Extends `Polyline`.
|
|
*
|
|
* Note that points you pass when creating a polygon shouldn't have an additional last point equal to the first one — it's better to filter out such points.
|
|
*
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* // create a red polygon from an array of LatLng points
|
|
* const latlngs = [[37, -109.05],[41, -109.03],[41, -102.05],[37, -102.04]];
|
|
*
|
|
* const polygon = new Polygon(latlngs, {color: 'red'}).addTo(map);
|
|
*
|
|
* // zoom the map to the polygon
|
|
* map.fitBounds(polygon.getBounds());
|
|
* ```
|
|
*
|
|
* You can also pass an array of arrays of latlngs, with the first array representing the outer shape and the other arrays representing holes in the outer shape:
|
|
*
|
|
* ```js
|
|
* const latlngs = [
|
|
* [[37, -109.05],[41, -109.03],[41, -102.05],[37, -102.04]], // outer ring
|
|
* [[37.29, -108.58],[40.71, -108.58],[40.71, -102.50],[37.29, -102.50]] // hole
|
|
* ];
|
|
* ```
|
|
*
|
|
* Additionally, you can pass a multi-dimensional array to represent a MultiPolygon shape.
|
|
*
|
|
* ```js
|
|
* const latlngs = [
|
|
* [ // first polygon
|
|
* [[37, -109.05],[41, -109.03],[41, -102.05],[37, -102.04]], // outer ring
|
|
* [[37.29, -108.58],[40.71, -108.58],[40.71, -102.50],[37.29, -102.50]] // hole
|
|
* ],
|
|
* [ // second polygon
|
|
* [[41, -111.03],[45, -111.04],[45, -104.05],[41, -104.05]]
|
|
* ]
|
|
* ];
|
|
* ```
|
|
*/
|
|
|
|
// @constructor Polygon(latlngs: LatLng[], options?: Polyline options)
|
|
class Polygon extends Polyline {
|
|
|
|
static {
|
|
this.setDefaultOptions({
|
|
fill: true
|
|
});
|
|
}
|
|
|
|
isEmpty() {
|
|
return !this._latlngs.length || !this._latlngs[0].length;
|
|
}
|
|
|
|
// @method getCenter(): LatLng
|
|
// Returns the center ([centroid](http://en.wikipedia.org/wiki/Centroid)) of the Polygon.
|
|
getCenter() {
|
|
// throws error when not yet added to map as this center calculation requires projected coordinates
|
|
if (!this._map) {
|
|
throw new Error('Must add layer to map before using getCenter()');
|
|
}
|
|
return polygonCenter(this._defaultShape(), this._map.options.crs);
|
|
}
|
|
|
|
_convertLatLngs(latlngs) {
|
|
const result = Polyline.prototype._convertLatLngs.call(this, latlngs),
|
|
len = result.length;
|
|
|
|
// remove last point if it equals first one
|
|
if (len >= 2 && result[0] instanceof LatLng && result[0].equals(result[len - 1])) {
|
|
result.pop();
|
|
}
|
|
return result;
|
|
}
|
|
|
|
_setLatLngs(latlngs) {
|
|
Polyline.prototype._setLatLngs.call(this, latlngs);
|
|
if (isFlat(this._latlngs)) {
|
|
this._latlngs = [this._latlngs];
|
|
}
|
|
}
|
|
|
|
_defaultShape() {
|
|
return isFlat(this._latlngs[0]) ? this._latlngs[0] : this._latlngs[0][0];
|
|
}
|
|
|
|
_clipPoints() {
|
|
// polygons need a different clipping algorithm so we redefine that
|
|
|
|
let bounds = this._renderer._bounds;
|
|
const w = this.options.weight,
|
|
p = new Point(w, w);
|
|
|
|
// increase clip padding by stroke width to avoid stroke on clip edges
|
|
bounds = new Bounds(bounds.min.subtract(p), bounds.max.add(p));
|
|
|
|
this._parts = [];
|
|
if (!this._pxBounds || !this._pxBounds.intersects(bounds)) {
|
|
return;
|
|
}
|
|
|
|
if (this.options.noClip) {
|
|
this._parts = this._rings;
|
|
return;
|
|
}
|
|
|
|
for (const ring of this._rings) {
|
|
const clipped = clipPolygon(ring, bounds, true);
|
|
if (clipped.length) {
|
|
this._parts.push(clipped);
|
|
}
|
|
}
|
|
}
|
|
|
|
_updatePath() {
|
|
this._renderer._updatePoly(this, true);
|
|
}
|
|
|
|
// Needed by the `Canvas` renderer for interactivity
|
|
_containsPoint(p) {
|
|
let inside = false,
|
|
part, p1, p2, i, j, k, len, len2;
|
|
|
|
if (!this._pxBounds || !this._pxBounds.contains(p)) { return false; }
|
|
|
|
// ray casting algorithm for detecting if point is in polygon
|
|
for (i = 0, len = this._parts.length; i < len; i++) {
|
|
part = this._parts[i];
|
|
|
|
for (j = 0, len2 = part.length, k = len2 - 1; j < len2; k = j++) {
|
|
p1 = part[j];
|
|
p2 = part[k];
|
|
|
|
if (((p1.y > p.y) !== (p2.y > p.y)) && (p.x < (p2.x - p1.x) * (p.y - p1.y) / (p2.y - p1.y) + p1.x)) {
|
|
inside = !inside;
|
|
}
|
|
}
|
|
}
|
|
|
|
// also check if it's on polygon stroke
|
|
return inside || Polyline.prototype._containsPoint.call(this, p, true);
|
|
}
|
|
|
|
}
|
|
|
|
/*
|
|
* @class GeoJSON
|
|
* @inherits FeatureGroup
|
|
*
|
|
* Represents a GeoJSON object or an array of GeoJSON objects. Allows you to parse
|
|
* GeoJSON data and display it on the map. Extends `FeatureGroup`.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* new GeoJSON(data, {
|
|
* style: function (feature) {
|
|
* return {color: feature.properties.color};
|
|
* }
|
|
* }).bindPopup(function (layer) {
|
|
* return layer.feature.properties.description;
|
|
* }).addTo(map);
|
|
* ```
|
|
*/
|
|
|
|
// @namespace GeoJSON
|
|
// @constructor GeoJSON(geojson?: Object, options?: GeoJSON options)
|
|
// Creates a GeoJSON layer. Optionally accepts an object in
|
|
// [GeoJSON format](https://tools.ietf.org/html/rfc7946) to display on the map
|
|
// (you can alternatively add it later with `addData` method) and an `options` object.
|
|
class GeoJSON extends FeatureGroup {
|
|
|
|
/* @section
|
|
* @aka GeoJSON options
|
|
*
|
|
* @option pointToLayer: Function = *
|
|
* A `Function` defining how GeoJSON points spawn Leaflet layers. It is internally
|
|
* called when data is added, passing the GeoJSON point feature and its `LatLng`.
|
|
* The default is to spawn a default `Marker`:
|
|
* ```js
|
|
* function(geoJsonPoint, latlng) {
|
|
* return new Marker(latlng);
|
|
* }
|
|
* ```
|
|
*
|
|
* @option style: Function = *
|
|
* A `Function` defining the `Path options` for styling GeoJSON lines and polygons,
|
|
* called internally when data is added.
|
|
* The default value is to not override any defaults:
|
|
* ```js
|
|
* function (geoJsonFeature) {
|
|
* return {}
|
|
* }
|
|
* ```
|
|
*
|
|
* @option onEachFeature: Function = *
|
|
* A `Function` that will be called once for each created `Feature`, after it has
|
|
* been created and styled. Useful for attaching events and popups to features.
|
|
* The default is to do nothing with the newly created layers:
|
|
* ```js
|
|
* function (feature, layer) {}
|
|
* ```
|
|
*
|
|
* @option filter: Function = *
|
|
* A `Function` that will be used to decide whether to include a feature or not.
|
|
* The default is to include all features:
|
|
* ```js
|
|
* function (geoJsonFeature) {
|
|
* return true;
|
|
* }
|
|
* ```
|
|
* Note: dynamically changing the `filter` option will have effect only on newly
|
|
* added data. It will _not_ re-evaluate already included features.
|
|
*
|
|
* @option coordsToLatLng: Function = *
|
|
* A `Function` that will be used for converting GeoJSON coordinates to `LatLng`s.
|
|
* The default is the `coordsToLatLng` static method.
|
|
*
|
|
* @option markersInheritOptions: Boolean = false
|
|
* Whether default Markers for "Point" type Features inherit from group options.
|
|
*/
|
|
|
|
initialize(geojson, options) {
|
|
setOptions(this, options);
|
|
|
|
this._layers = {};
|
|
|
|
if (geojson) {
|
|
this.addData(geojson);
|
|
}
|
|
}
|
|
|
|
// @method addData( <GeoJSON> data ): this
|
|
// Adds a GeoJSON object to the layer.
|
|
addData(geojson) {
|
|
const features = Array.isArray(geojson) ? geojson : geojson.features;
|
|
|
|
if (features) {
|
|
for (const feature of features) {
|
|
// only add this if geometry or geometries are set and not null
|
|
if (feature.geometries || feature.geometry || feature.features || feature.coordinates) {
|
|
this.addData(feature);
|
|
}
|
|
}
|
|
return this;
|
|
}
|
|
|
|
const options = this.options;
|
|
|
|
if (options.filter && !options.filter(geojson)) { return this; }
|
|
|
|
const layer = geometryToLayer(geojson, options);
|
|
if (!layer) {
|
|
return this;
|
|
}
|
|
layer.feature = asFeature(geojson);
|
|
|
|
layer.defaultOptions = layer.options;
|
|
this.resetStyle(layer);
|
|
|
|
if (options.onEachFeature) {
|
|
options.onEachFeature(geojson, layer);
|
|
}
|
|
|
|
return this.addLayer(layer);
|
|
}
|
|
|
|
// @method resetStyle( <Path> layer? ): this
|
|
// Resets the given vector layer's style to the original GeoJSON style, useful for resetting style after hover events.
|
|
// If `layer` is omitted, the style of all features in the current layer is reset.
|
|
resetStyle(layer) {
|
|
if (layer === undefined) {
|
|
return this.eachLayer(this.resetStyle, this);
|
|
}
|
|
// reset any custom styles
|
|
layer.options = Object.create(layer.defaultOptions);
|
|
this._setLayerStyle(layer, this.options.style);
|
|
return this;
|
|
}
|
|
|
|
// @method setStyle( <Function> style ): this
|
|
// Changes styles of GeoJSON vector layers with the given style function.
|
|
setStyle(style) {
|
|
return this.eachLayer(layer => this._setLayerStyle(layer, style));
|
|
}
|
|
|
|
_setLayerStyle(layer, style) {
|
|
if (layer.setStyle) {
|
|
if (typeof style === 'function') {
|
|
style = style(layer.feature);
|
|
}
|
|
layer.setStyle(style);
|
|
}
|
|
}
|
|
}
|
|
|
|
// @section
|
|
// There are several static functions which can be called without instantiating GeoJSON:
|
|
|
|
// @function geometryToLayer(featureData: Object, options?: GeoJSON options): Layer
|
|
// Creates a `Layer` from a given GeoJSON feature. Can use a custom
|
|
// [`pointToLayer`](#geojson-pointtolayer) and/or [`coordsToLatLng`](#geojson-coordstolatlng)
|
|
// functions if provided as options.
|
|
function geometryToLayer(geojson, options) {
|
|
|
|
const geometry = geojson.type === 'Feature' ? geojson.geometry : geojson,
|
|
coords = geometry?.coordinates,
|
|
layers = [],
|
|
pointToLayer = options?.pointToLayer,
|
|
_coordsToLatLng = options?.coordsToLatLng ?? coordsToLatLng;
|
|
let latlng, latlngs;
|
|
|
|
if (!coords && !geometry) {
|
|
return null;
|
|
}
|
|
|
|
switch (geometry.type) {
|
|
case 'Point':
|
|
latlng = _coordsToLatLng(coords);
|
|
return _pointToLayer(pointToLayer, geojson, latlng, options);
|
|
|
|
case 'MultiPoint':
|
|
for (const coord of coords) {
|
|
latlng = _coordsToLatLng(coord);
|
|
layers.push(_pointToLayer(pointToLayer, geojson, latlng, options));
|
|
}
|
|
return new FeatureGroup(layers);
|
|
|
|
case 'LineString':
|
|
case 'MultiLineString':
|
|
latlngs = coordsToLatLngs(coords, geometry.type === 'LineString' ? 0 : 1, _coordsToLatLng);
|
|
return new Polyline(latlngs, options);
|
|
|
|
case 'Polygon':
|
|
case 'MultiPolygon':
|
|
latlngs = coordsToLatLngs(coords, geometry.type === 'Polygon' ? 1 : 2, _coordsToLatLng);
|
|
return new Polygon(latlngs, options);
|
|
|
|
case 'GeometryCollection':
|
|
for (const g of geometry.geometries) {
|
|
const geoLayer = geometryToLayer({
|
|
geometry: g,
|
|
type: 'Feature',
|
|
properties: geojson.properties
|
|
}, options);
|
|
|
|
if (geoLayer) {
|
|
layers.push(geoLayer);
|
|
}
|
|
}
|
|
return new FeatureGroup(layers);
|
|
|
|
case 'FeatureCollection':
|
|
for (const f of geometry.features) {
|
|
const featureLayer = geometryToLayer(f, options);
|
|
|
|
if (featureLayer) {
|
|
layers.push(featureLayer);
|
|
}
|
|
}
|
|
return new FeatureGroup(layers);
|
|
|
|
default:
|
|
throw new Error('Invalid GeoJSON object.');
|
|
}
|
|
}
|
|
|
|
function _pointToLayer(pointToLayerFn, geojson, latlng, options) {
|
|
return pointToLayerFn ?
|
|
pointToLayerFn(geojson, latlng) :
|
|
new Marker(latlng, options?.markersInheritOptions && options);
|
|
}
|
|
|
|
// @function coordsToLatLng(coords: Array): LatLng
|
|
// Creates a `LatLng` object from an array of 2 numbers (longitude, latitude)
|
|
// or 3 numbers (longitude, latitude, altitude) used in GeoJSON for points.
|
|
function coordsToLatLng(coords) {
|
|
return new LatLng(coords[1], coords[0], coords[2]);
|
|
}
|
|
|
|
// @function coordsToLatLngs(coords: Array, levelsDeep?: Number, coordsToLatLng?: Function): Array
|
|
// Creates a multidimensional array of `LatLng`s from a GeoJSON coordinates array.
|
|
// `levelsDeep` specifies the nesting level (0 is for an array of points, 1 for an array of arrays of points, etc., 0 by default).
|
|
// Can use a custom [`coordsToLatLng`](#geojson-coordstolatlng) function.
|
|
function coordsToLatLngs(coords, levelsDeep, _coordsToLatLng) {
|
|
return coords.map(coord => (levelsDeep ?
|
|
coordsToLatLngs(coord, levelsDeep - 1, _coordsToLatLng) :
|
|
(_coordsToLatLng || coordsToLatLng)(coord)));
|
|
}
|
|
|
|
// @function latLngToCoords(latlng: LatLng, precision?: Number|false): Array
|
|
// Reverse of [`coordsToLatLng`](#geojson-coordstolatlng)
|
|
// Coordinates values are rounded with [`formatNum`](#util-formatnum) function.
|
|
function latLngToCoords(latlng, precision) {
|
|
latlng = new LatLng(latlng);
|
|
return latlng.alt !== undefined ?
|
|
[formatNum(latlng.lng, precision), formatNum(latlng.lat, precision), formatNum(latlng.alt, precision)] :
|
|
[formatNum(latlng.lng, precision), formatNum(latlng.lat, precision)];
|
|
}
|
|
|
|
// @function latLngsToCoords(latlngs: Array, levelsDeep?: Number, close?: Boolean, precision?: Number|false): Array
|
|
// Reverse of [`coordsToLatLngs`](#geojson-coordstolatlngs)
|
|
// `close` determines whether the first point should be appended to the end of the array to close the feature, only used when `levelsDeep` is 0. False by default.
|
|
// Coordinates values are rounded with [`formatNum`](#util-formatnum) function.
|
|
function latLngsToCoords(latlngs, levelsDeep, close, precision) {
|
|
// Check for flat arrays required to ensure unbalanced arrays are correctly converted in recursion
|
|
const coords = latlngs.map(latlng => (levelsDeep ?
|
|
latLngsToCoords(latlng, isFlat(latlng) ? 0 : levelsDeep - 1, close, precision) :
|
|
latLngToCoords(latlng, precision)));
|
|
|
|
if (!levelsDeep && close && coords.length > 0) {
|
|
coords.push(coords[0].slice());
|
|
}
|
|
|
|
return coords;
|
|
}
|
|
|
|
// @function getFeature(layer: Layer, newGeometry: Object): Object
|
|
// Returns GeoJSON geometries/features of layer with new GeoJSON geometry.
|
|
function getFeature(layer, newGeometry) {
|
|
return layer.feature ?
|
|
{...layer.feature, geometry: newGeometry} :
|
|
asFeature(newGeometry);
|
|
}
|
|
|
|
// @function asFeature(geojson: Object): Object
|
|
// Normalize GeoJSON geometries/features into GeoJSON features.
|
|
function asFeature(geojson) {
|
|
if (geojson.type === 'Feature' || geojson.type === 'FeatureCollection') {
|
|
return geojson;
|
|
}
|
|
|
|
return {
|
|
type: 'Feature',
|
|
properties: {},
|
|
geometry: geojson
|
|
};
|
|
}
|
|
|
|
const PointToGeoJSON = {
|
|
toGeoJSON(precision) {
|
|
return getFeature(this, {
|
|
type: 'Point',
|
|
coordinates: latLngToCoords(this.getLatLng(), precision)
|
|
});
|
|
}
|
|
};
|
|
|
|
// @namespace Marker
|
|
// @section Other methods
|
|
// @method toGeoJSON(precision?: Number|false): Object
|
|
// Coordinates values are rounded with [`formatNum`](#util-formatnum) function with given `precision`.
|
|
// Returns a [`GeoJSON`](https://en.wikipedia.org/wiki/GeoJSON) representation of the marker (as a GeoJSON `Point` Feature).
|
|
Marker.include(PointToGeoJSON);
|
|
|
|
// @namespace CircleMarker
|
|
// @method toGeoJSON(precision?: Number|false): Object
|
|
// Coordinates values are rounded with [`formatNum`](#util-formatnum) function with given `precision`.
|
|
// Returns a [`GeoJSON`](https://en.wikipedia.org/wiki/GeoJSON) representation of the circle marker (as a GeoJSON `Point` Feature).
|
|
Circle.include(PointToGeoJSON);
|
|
CircleMarker.include(PointToGeoJSON);
|
|
|
|
|
|
// @namespace Polyline
|
|
// @method toGeoJSON(precision?: Number|false): Object
|
|
// Coordinates values are rounded with [`formatNum`](#util-formatnum) function with given `precision`.
|
|
// Returns a [`GeoJSON`](https://en.wikipedia.org/wiki/GeoJSON) representation of the polyline (as a GeoJSON `LineString` or `MultiLineString` Feature).
|
|
Polyline.include({
|
|
toGeoJSON(precision) {
|
|
const multi = !isFlat(this._latlngs);
|
|
|
|
const coords = latLngsToCoords(this._latlngs, multi ? 1 : 0, false, precision);
|
|
|
|
return getFeature(this, {
|
|
type: `${multi ? 'Multi' : ''}LineString`,
|
|
coordinates: coords
|
|
});
|
|
}
|
|
});
|
|
|
|
// @namespace Polygon
|
|
// @method toGeoJSON(precision?: Number|false): Object
|
|
// Coordinates values are rounded with [`formatNum`](#util-formatnum) function with given `precision`.
|
|
// Returns a [`GeoJSON`](https://en.wikipedia.org/wiki/GeoJSON) representation of the polygon (as a GeoJSON `Polygon` or `MultiPolygon` Feature).
|
|
Polygon.include({
|
|
toGeoJSON(precision) {
|
|
const holes = !isFlat(this._latlngs),
|
|
multi = holes && !isFlat(this._latlngs[0]);
|
|
|
|
let coords = latLngsToCoords(this._latlngs, multi ? 2 : holes ? 1 : 0, true, precision);
|
|
|
|
if (!holes) {
|
|
coords = [coords];
|
|
}
|
|
|
|
return getFeature(this, {
|
|
type: `${multi ? 'Multi' : ''}Polygon`,
|
|
coordinates: coords
|
|
});
|
|
}
|
|
});
|
|
|
|
|
|
// @namespace LayerGroup
|
|
LayerGroup.include({
|
|
toMultiPoint(precision) {
|
|
const coords = [];
|
|
|
|
this.eachLayer((layer) => {
|
|
coords.push(layer.toGeoJSON(precision).geometry.coordinates);
|
|
});
|
|
|
|
return getFeature(this, {
|
|
type: 'MultiPoint',
|
|
coordinates: coords
|
|
});
|
|
},
|
|
|
|
// @method toGeoJSON(precision?: Number|false): Object
|
|
// Coordinates values are rounded with [`formatNum`](#util-formatnum) function with given `precision`.
|
|
// Returns a [`GeoJSON`](https://en.wikipedia.org/wiki/GeoJSON) representation of the layer group (as a GeoJSON `FeatureCollection`, `GeometryCollection`, or `MultiPoint`).
|
|
toGeoJSON(precision) {
|
|
|
|
const type = this.feature?.geometry?.type;
|
|
|
|
if (type === 'MultiPoint') {
|
|
return this.toMultiPoint(precision);
|
|
}
|
|
|
|
const isGeometryCollection = type === 'GeometryCollection',
|
|
jsons = [];
|
|
|
|
this.eachLayer((layer) => {
|
|
if (layer.toGeoJSON) {
|
|
const json = layer.toGeoJSON(precision);
|
|
if (isGeometryCollection) {
|
|
jsons.push(json.geometry);
|
|
} else {
|
|
const feature = asFeature(json);
|
|
// Squash nested feature collections
|
|
if (feature.type === 'FeatureCollection') {
|
|
jsons.push.apply(jsons, feature.features);
|
|
} else {
|
|
jsons.push(feature);
|
|
}
|
|
}
|
|
}
|
|
});
|
|
|
|
if (isGeometryCollection) {
|
|
return getFeature(this, {
|
|
geometries: jsons,
|
|
type: 'GeometryCollection'
|
|
});
|
|
}
|
|
|
|
return {
|
|
type: 'FeatureCollection',
|
|
features: jsons
|
|
};
|
|
}
|
|
});
|
|
|
|
/*
|
|
* @class BlanketOverlay
|
|
* @inherits Layer
|
|
*
|
|
* Represents an HTML element that covers ("blankets") the entire surface
|
|
* of the map.
|
|
*
|
|
* Do not use this class directly. It's meant for `Renderer`, and for plugins
|
|
* that rely on one single HTML element
|
|
*/
|
|
|
|
class BlanketOverlay extends Layer {
|
|
|
|
static {
|
|
// @section
|
|
// @aka BlanketOverlay options
|
|
this.setDefaultOptions({
|
|
// @option padding: Number = 0.1
|
|
// How much to extend the clip area around the map view (relative to its size)
|
|
// e.g. 0.1 would be 10% of map view in each direction
|
|
padding: 0.1,
|
|
|
|
// @option continuous: Boolean = false
|
|
// When `false`, the blanket will update its position only when the
|
|
// map state settles (*after* a pan/zoom animation). When `true`,
|
|
// it will update when the map state changes (*during* pan/zoom
|
|
// animations)
|
|
continuous: false,
|
|
});
|
|
}
|
|
|
|
initialize(options) {
|
|
setOptions(this, options);
|
|
}
|
|
|
|
onAdd() {
|
|
if (!this._container) {
|
|
this._initContainer(); // defined by renderer implementations
|
|
|
|
// always keep transform-origin as 0 0, #8794
|
|
this._container.classList.add('leaflet-zoom-animated');
|
|
}
|
|
|
|
this.getPane().appendChild(this._container);
|
|
this._resizeContainer();
|
|
this._onMoveEnd();
|
|
}
|
|
|
|
onRemove() {
|
|
this._destroyContainer();
|
|
}
|
|
|
|
getEvents() {
|
|
const events = {
|
|
viewreset: this._reset,
|
|
zoom: this._onZoom,
|
|
moveend: this._onMoveEnd,
|
|
zoomend: this._onZoomEnd
|
|
};
|
|
if (this._zoomAnimated) {
|
|
events.zoomanim = this._onAnimZoom;
|
|
}
|
|
if (this.options.continuous) {
|
|
events.move = this._onMoveEnd;
|
|
}
|
|
return events;
|
|
}
|
|
|
|
_onAnimZoom(ev) {
|
|
this._updateTransform(ev.center, ev.zoom);
|
|
}
|
|
|
|
_onZoom() {
|
|
this._updateTransform(this._map.getCenter(), this._map.getZoom());
|
|
}
|
|
|
|
_updateTransform(center, zoom) {
|
|
const scale = this._map.getZoomScale(zoom, this._zoom),
|
|
viewHalf = this._map.getSize().multiplyBy(0.5 + this.options.padding),
|
|
currentCenterPoint = this._map.project(this._center, zoom),
|
|
topLeftOffset = viewHalf.multiplyBy(-scale).add(currentCenterPoint)
|
|
.subtract(this._map._getNewPixelOrigin(center, zoom));
|
|
|
|
setTransform(this._container, topLeftOffset, scale);
|
|
}
|
|
|
|
_onMoveEnd(ev) {
|
|
// Update pixel bounds of renderer container (for positioning/sizing/clipping later)
|
|
const p = this.options.padding,
|
|
size = this._map.getSize(),
|
|
min = this._map.containerPointToLayerPoint(size.multiplyBy(-p)).round();
|
|
|
|
this._bounds = new Bounds(min, min.add(size.multiplyBy(1 + p * 2)).round());
|
|
|
|
this._center = this._map.getCenter();
|
|
this._zoom = this._map.getZoom();
|
|
this._updateTransform(this._center, this._zoom);
|
|
|
|
this._onSettled(ev);
|
|
|
|
this._resizeContainer();
|
|
}
|
|
|
|
_reset() {
|
|
this._onSettled();
|
|
this._updateTransform(this._center, this._zoom);
|
|
this._onViewReset();
|
|
}
|
|
|
|
/*
|
|
* @section Subclass interface
|
|
* @uninheritable
|
|
* Subclasses must define the following methods:
|
|
*
|
|
* @method _initContainer(): undefined
|
|
* Must initialize the HTML element to use as blanket, and store it as
|
|
* `this._container`. The base implementation creates a blank `<div>`
|
|
*
|
|
* @method _destroyContainer(): undefined
|
|
* Must destroy the HTML element in `this._container` and free any other
|
|
* resources. The base implementation destroys the element and removes
|
|
* any event handlers attached to it.
|
|
*
|
|
* @method _resizeContainer(): Point
|
|
* The base implementation resizes the container (based on the map's size
|
|
* and taking into account the padding), returning the new size in CSS pixels.
|
|
*
|
|
* Subclass implementations shall reset container parameters and data
|
|
* structures as needed.
|
|
*
|
|
* @method _onZoomEnd(ev?: PointerEvent): undefined
|
|
* (Optional) Runs on the map's `zoomend` event.
|
|
*
|
|
* @method _onViewReset(ev?: PointerEvent): undefined
|
|
* (Optional) Runs on the map's `viewreset` event.
|
|
*
|
|
* @method _onSettled(): undefined
|
|
* Runs whenever the map state settles after changing (at the end of pan/zoom
|
|
* animations, etc). This should trigger the bulk of any rendering logic.
|
|
*
|
|
* If the `continuous` option is set to `true`, then this also runs on
|
|
* any map state change (including *during* pan/zoom animations).
|
|
*/
|
|
_initContainer() {
|
|
this._container = create$1('div');
|
|
}
|
|
_destroyContainer() {
|
|
off(this._container);
|
|
this._container.remove();
|
|
delete this._container;
|
|
}
|
|
_resizeContainer() {
|
|
const p = this.options.padding,
|
|
size = this._map.getSize().multiplyBy(1 + p * 2).round();
|
|
this._container.style.width = `${size.x}px`;
|
|
this._container.style.height = `${size.y}px`;
|
|
return size;
|
|
}
|
|
_onZoomEnd() {}
|
|
_onViewReset() {}
|
|
_onSettled() {}
|
|
}
|
|
|
|
/*
|
|
* @class ImageOverlay
|
|
* @inherits Interactive layer
|
|
*
|
|
* Used to load and display a single image over specific bounds of the map. Extends `Layer`.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* const imageUrl = 'https://maps.lib.utexas.edu/maps/historical/newark_nj_1922.jpg',
|
|
* imageBounds = [[40.712216, -74.22655], [40.773941, -74.12544]];
|
|
* new ImageOverlay(imageUrl, imageBounds).addTo(map);
|
|
* ```
|
|
*/
|
|
|
|
// @constructor ImageOverlay(imageUrl: String, bounds: LatLngBounds, options?: ImageOverlay options)
|
|
// Instantiates an image overlay object given the URL of the image and the
|
|
// geographical bounds it is tied to.
|
|
class ImageOverlay extends Layer {
|
|
|
|
static {
|
|
// @section
|
|
// @aka ImageOverlay options
|
|
this.setDefaultOptions({
|
|
// @option opacity: Number = 1.0
|
|
// The opacity of the image overlay.
|
|
opacity: 1,
|
|
|
|
// @option alt: String = ''
|
|
// Text for the `alt` attribute of the image (useful for accessibility).
|
|
alt: '',
|
|
|
|
// @option interactive: Boolean = false
|
|
// If `true`, the image overlay will emit [pointer events](#interactive-layer) when clicked or hovered.
|
|
interactive: false,
|
|
|
|
// @option crossOrigin: Boolean|String = false
|
|
// Whether the crossOrigin attribute will be added to the image.
|
|
// If a String is provided, the image will have its crossOrigin attribute set to the String provided. This is needed if you want to access image pixel data.
|
|
// Refer to [CORS Settings](https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes) for valid String values.
|
|
crossOrigin: false,
|
|
|
|
// @option errorOverlayUrl: String = ''
|
|
// URL to the overlay image to show in place of the overlay that failed to load.
|
|
errorOverlayUrl: '',
|
|
|
|
// @option zIndex: Number = 1
|
|
// The explicit [zIndex](https://developer.mozilla.org/docs/Web/CSS/CSS_Positioning/Understanding_z_index) of the overlay layer.
|
|
zIndex: 1,
|
|
|
|
// @option className: String = ''
|
|
// A custom class name to assign to the image. Empty by default.
|
|
className: '',
|
|
|
|
// @option decoding: String = 'auto'
|
|
// Tells the browser whether to decode the image in a synchronous fashion,
|
|
// as per the [`decoding` HTML attribute](https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/decoding).
|
|
// If the image overlay is flickering when being added/removed, set
|
|
// this option to `'sync'`.
|
|
decoding: 'auto'
|
|
});
|
|
}
|
|
|
|
initialize(url, bounds, options) { // (String, LatLngBounds, Object)
|
|
this._url = url;
|
|
this._bounds = new LatLngBounds(bounds);
|
|
|
|
setOptions(this, options);
|
|
}
|
|
|
|
onAdd() {
|
|
if (!this._image) {
|
|
this._initImage();
|
|
|
|
if (this.options.opacity < 1) {
|
|
this._updateOpacity();
|
|
}
|
|
}
|
|
|
|
if (this.options.interactive) {
|
|
this._image.classList.add('leaflet-interactive');
|
|
this.addInteractiveTarget(this._image);
|
|
}
|
|
|
|
this.getPane().appendChild(this._image);
|
|
this._reset();
|
|
}
|
|
|
|
onRemove() {
|
|
this._image.remove();
|
|
if (this.options.interactive) {
|
|
this.removeInteractiveTarget(this._image);
|
|
}
|
|
}
|
|
|
|
// @method setOpacity(opacity: Number): this
|
|
// Sets the opacity of the overlay.
|
|
setOpacity(opacity) {
|
|
this.options.opacity = opacity;
|
|
|
|
if (this._image) {
|
|
this._updateOpacity();
|
|
}
|
|
return this;
|
|
}
|
|
|
|
setStyle(styleOpts) {
|
|
if (styleOpts.opacity) {
|
|
this.setOpacity(styleOpts.opacity);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method bringToFront(): this
|
|
// Brings the layer to the top of all overlays.
|
|
bringToFront() {
|
|
if (this._map) {
|
|
toFront(this._image);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method bringToBack(): this
|
|
// Brings the layer to the bottom of all overlays.
|
|
bringToBack() {
|
|
if (this._map) {
|
|
toBack(this._image);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method setUrl(url: String): this
|
|
// Changes the URL of the image.
|
|
setUrl(url) {
|
|
this._url = url;
|
|
|
|
if (this._image) {
|
|
this._image.src = url;
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method setBounds(bounds: LatLngBounds): this
|
|
// Update the bounds that this ImageOverlay covers
|
|
setBounds(bounds) {
|
|
this._bounds = new LatLngBounds(bounds);
|
|
|
|
if (this._map) {
|
|
this._reset();
|
|
}
|
|
return this;
|
|
}
|
|
|
|
getEvents() {
|
|
const events = {
|
|
zoom: this._reset,
|
|
viewreset: this._reset
|
|
};
|
|
|
|
if (this._zoomAnimated) {
|
|
events.zoomanim = this._animateZoom;
|
|
}
|
|
|
|
return events;
|
|
}
|
|
|
|
// @method setZIndex(value: Number): this
|
|
// Changes the [zIndex](#imageoverlay-zindex) of the image overlay.
|
|
setZIndex(value) {
|
|
this.options.zIndex = value;
|
|
this._updateZIndex();
|
|
return this;
|
|
}
|
|
|
|
// @method getBounds(): LatLngBounds
|
|
// Get the bounds that this ImageOverlay covers
|
|
getBounds() {
|
|
return this._bounds;
|
|
}
|
|
|
|
// @method getElement(): HTMLElement
|
|
// Returns the instance of [`HTMLImageElement`](https://developer.mozilla.org/docs/Web/API/HTMLImageElement)
|
|
// used by this overlay.
|
|
getElement() {
|
|
return this._image;
|
|
}
|
|
|
|
_initImage() {
|
|
const wasElementSupplied = this._url.tagName === 'IMG';
|
|
const img = this._image = wasElementSupplied ? this._url : create$1('img');
|
|
|
|
img.classList.add('leaflet-image-layer');
|
|
if (this._zoomAnimated) { img.classList.add('leaflet-zoom-animated'); }
|
|
if (this.options.className) { img.classList.add(...splitWords(this.options.className)); }
|
|
|
|
img.onselectstart = falseFn;
|
|
img.onpointermove = falseFn;
|
|
|
|
// @event load: Event
|
|
// Fired when the ImageOverlay layer has loaded its image
|
|
img.onload = this.fire.bind(this, 'load');
|
|
img.onerror = this._overlayOnError.bind(this);
|
|
|
|
if (this.options.crossOrigin || this.options.crossOrigin === '') {
|
|
img.crossOrigin = this.options.crossOrigin === true ? '' : this.options.crossOrigin;
|
|
}
|
|
|
|
img.decoding = this.options.decoding;
|
|
|
|
if (this.options.zIndex) {
|
|
this._updateZIndex();
|
|
}
|
|
|
|
if (wasElementSupplied) {
|
|
this._url = img.src;
|
|
return;
|
|
}
|
|
|
|
img.src = this._url;
|
|
img.alt = this.options.alt;
|
|
}
|
|
|
|
_animateZoom(e) {
|
|
const scale = this._map.getZoomScale(e.zoom),
|
|
offset = this._map._latLngBoundsToNewLayerBounds(this._bounds, e.zoom, e.center).min;
|
|
|
|
setTransform(this._image, offset, scale);
|
|
}
|
|
|
|
_reset() {
|
|
const image = this._image,
|
|
bounds = new Bounds(
|
|
this._map.latLngToLayerPoint(this._bounds.getNorthWest()),
|
|
this._map.latLngToLayerPoint(this._bounds.getSouthEast())),
|
|
size = bounds.getSize();
|
|
|
|
setPosition(image, bounds.min);
|
|
|
|
image.style.width = `${size.x}px`;
|
|
image.style.height = `${size.y}px`;
|
|
}
|
|
|
|
_updateOpacity() {
|
|
this._image.style.opacity = this.options.opacity;
|
|
}
|
|
|
|
_updateZIndex() {
|
|
if (this._image && this.options.zIndex !== undefined && this.options.zIndex !== null) {
|
|
this._image.style.zIndex = this.options.zIndex;
|
|
}
|
|
}
|
|
|
|
_overlayOnError() {
|
|
// @event error: Event
|
|
// Fired when the ImageOverlay layer fails to load its image
|
|
this.fire('error');
|
|
|
|
const errorUrl = this.options.errorOverlayUrl;
|
|
if (errorUrl && this._url !== errorUrl) {
|
|
this._url = errorUrl;
|
|
this._image.src = errorUrl;
|
|
}
|
|
}
|
|
|
|
// @method getCenter(): LatLng
|
|
// Returns the center of the ImageOverlay.
|
|
getCenter() {
|
|
return this._bounds.getCenter();
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class VideoOverlay
|
|
* @inherits ImageOverlay
|
|
*
|
|
* Used to load and display a video player over specific bounds of the map. Extends `ImageOverlay`.
|
|
*
|
|
* A video overlay uses the [`<video>`](https://developer.mozilla.org/docs/Web/HTML/Element/video)
|
|
* HTML element.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* const videoUrl = 'https://www.mapbox.com/bites/00188/patricia_nasa.webm',
|
|
* videoBounds = [[ 32, -130], [ 13, -100]];
|
|
* new VideoOverlay(videoUrl, videoBounds ).addTo(map);
|
|
* ```
|
|
*/
|
|
|
|
// @constructor VideoOverlay(video: String|Array|HTMLVideoElement, bounds: LatLngBounds, options?: VideoOverlay options)
|
|
// Instantiates an image overlay object given the URL of the video (or array of URLs, or even a video element) and the
|
|
// geographical bounds it is tied to.
|
|
class VideoOverlay extends ImageOverlay {
|
|
|
|
static {
|
|
// @section
|
|
// @aka VideoOverlay options
|
|
this.setDefaultOptions({
|
|
// @option autoplay: Boolean = true
|
|
// Whether the video starts playing automatically when loaded.
|
|
// On some browsers autoplay will only work with `muted: true`
|
|
autoplay: true,
|
|
|
|
// @option loop: Boolean = false
|
|
// Whether the browser will offer controls to allow the user to control video playback, including volume, seeking, and pause/resume playback.
|
|
controls: false,
|
|
|
|
// @option loop: Boolean = true
|
|
// Whether the video will loop back to the beginning when played.
|
|
loop: true,
|
|
|
|
// @option keepAspectRatio: Boolean = true
|
|
// Whether the video will save aspect ratio after the projection.
|
|
keepAspectRatio: true,
|
|
|
|
// @option muted: Boolean = false
|
|
// Whether the video starts on mute when loaded.
|
|
muted: false,
|
|
|
|
// @option playsInline: Boolean = true
|
|
// Mobile browsers will play the video right where it is instead of open it up in fullscreen mode.
|
|
playsInline: true
|
|
});
|
|
}
|
|
|
|
_initImage() {
|
|
const wasElementSupplied = this._url.tagName === 'VIDEO';
|
|
const vid = this._image = wasElementSupplied ? this._url : create$1('video');
|
|
|
|
vid.classList.add('leaflet-image-layer');
|
|
if (this._zoomAnimated) { vid.classList.add('leaflet-zoom-animated'); }
|
|
if (this.options.className) { vid.classList.add(...splitWords(this.options.className)); }
|
|
|
|
on(vid, 'pointerdown', (e) => {
|
|
if (vid.controls) {
|
|
// Prevent the map from moving when the video or the seekbar is moved
|
|
stopPropagation(e);
|
|
}
|
|
});
|
|
|
|
// @event load: Event
|
|
// Fired when the video has finished loading the first frame
|
|
vid.onloadeddata = this.fire.bind(this, 'load');
|
|
|
|
if (wasElementSupplied) {
|
|
const sourceElements = vid.getElementsByTagName('source');
|
|
const sources = sourceElements.map(e => e.src);
|
|
this._url = (sourceElements.length > 0) ? sources : [vid.src];
|
|
return;
|
|
}
|
|
|
|
if (!Array.isArray(this._url)) { this._url = [this._url]; }
|
|
|
|
if (!this.options.keepAspectRatio && Object.hasOwn(vid.style, 'objectFit')) {
|
|
vid.style['objectFit'] = 'fill';
|
|
}
|
|
vid.autoplay = !!this.options.autoplay;
|
|
vid.controls = !!this.options.controls;
|
|
vid.loop = !!this.options.loop;
|
|
vid.muted = !!this.options.muted;
|
|
vid.playsInline = !!this.options.playsInline;
|
|
for (const url of this._url) {
|
|
const source = create$1('source');
|
|
source.src = url;
|
|
vid.appendChild(source);
|
|
}
|
|
}
|
|
|
|
// @method getElement(): HTMLVideoElement
|
|
// Returns the instance of [`HTMLVideoElement`](https://developer.mozilla.org/docs/Web/API/HTMLVideoElement)
|
|
// used by this overlay.
|
|
}
|
|
|
|
/*
|
|
* @class SVGOverlay
|
|
* @inherits ImageOverlay
|
|
*
|
|
* Used to load, display and provide DOM access to an SVG file over specific bounds of the map. Extends `ImageOverlay`.
|
|
*
|
|
* An SVG overlay uses the [`<svg>`](https://developer.mozilla.org/docs/Web/SVG/Element/svg) element.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* const svgElement = document.createElementNS("http://www.w3.org/2000/svg", "svg");
|
|
* svgElement.setAttribute('xmlns', "http://www.w3.org/2000/svg");
|
|
* svgElement.setAttribute('viewBox', "0 0 200 200");
|
|
* svgElement.innerHTML = '<rect width="200" height="200"/><rect x="75" y="23" width="50" height="50" style="fill:red"/><rect x="75" y="123" width="50" height="50" style="fill:#0013ff"/>';
|
|
* const svgElementBounds = [ [ 32, -130 ], [ 13, -100 ] ];
|
|
* new SVGOverlay(svgElement, svgElementBounds).addTo(map);
|
|
* ```
|
|
*/
|
|
|
|
// @constructor SVGOverlay(svg: String|SVGElement, bounds: LatLngBounds, options?: SVGOverlay options)
|
|
// Instantiates an image overlay object given an SVG element and the geographical bounds it is tied to.
|
|
// A viewBox attribute is required on the SVG element to zoom in and out properly.
|
|
class SVGOverlay extends ImageOverlay {
|
|
_initImage() {
|
|
const el = this._image = this._url;
|
|
|
|
el.classList.add('leaflet-image-layer');
|
|
if (this._zoomAnimated) { el.classList.add('leaflet-zoom-animated'); }
|
|
if (this.options.className) { el.classList.add(...splitWords(this.options.className)); }
|
|
|
|
el.onselectstart = falseFn;
|
|
el.onpointermove = falseFn;
|
|
}
|
|
|
|
// @method getElement(): SVGElement
|
|
// Returns the instance of [`SVGElement`](https://developer.mozilla.org/docs/Web/API/SVGElement)
|
|
// used by this overlay.
|
|
}
|
|
|
|
/*
|
|
* @class DivOverlay
|
|
* @inherits Interactive layer
|
|
* Base model for Popup and Tooltip. Inherit from it for custom overlays like plugins.
|
|
*/
|
|
|
|
// @namespace DivOverlay
|
|
class DivOverlay extends Layer {
|
|
|
|
static {
|
|
// @section
|
|
// @aka DivOverlay options
|
|
this.setDefaultOptions({
|
|
// @option interactive: Boolean = false
|
|
// If true, the popup/tooltip will listen to the pointer events.
|
|
interactive: false,
|
|
|
|
// @option offset: Point = Point(0, 0)
|
|
// The offset of the overlay position.
|
|
offset: [0, 0],
|
|
|
|
// @option className: String = ''
|
|
// A custom CSS class name to assign to the overlay.
|
|
className: '',
|
|
|
|
// @option pane: String = undefined
|
|
// `Map pane` where the overlay will be added.
|
|
pane: undefined,
|
|
|
|
// @option content: String|HTMLElement|Function = ''
|
|
// Sets the HTML content of the overlay while initializing. If a function is passed the source layer will be
|
|
// passed to the function. The function should return a `String` or `HTMLElement` to be used in the overlay.
|
|
content: ''
|
|
});
|
|
}
|
|
|
|
initialize(options, source) {
|
|
if (options instanceof LatLng || Array.isArray(options)) {
|
|
this._latlng = new LatLng(options);
|
|
setOptions(this, source);
|
|
} else {
|
|
setOptions(this, options);
|
|
this._source = source;
|
|
}
|
|
if (this.options.content) {
|
|
this._content = this.options.content;
|
|
}
|
|
}
|
|
|
|
// @method openOn(map: Map): this
|
|
// Adds the overlay to the map.
|
|
// Alternative to `map.openPopup(popup)`/`.openTooltip(tooltip)`.
|
|
openOn(map) {
|
|
map = arguments.length ? map : this._source._map; // experimental, not the part of public api
|
|
if (!map.hasLayer(this)) {
|
|
map.addLayer(this);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method close(): this
|
|
// Closes the overlay.
|
|
// Alternative to `map.closePopup(popup)`/`.closeTooltip(tooltip)`
|
|
// and `layer.closePopup()`/`.closeTooltip()`.
|
|
close() {
|
|
this._map?.removeLayer(this);
|
|
return this;
|
|
}
|
|
|
|
// @method toggle(layer?: Layer): this
|
|
// Opens or closes the overlay bound to layer depending on its current state.
|
|
// Argument may be omitted only for overlay bound to layer.
|
|
// Alternative to `layer.togglePopup()`/`.toggleTooltip()`.
|
|
toggle(layer) {
|
|
if (this._map) {
|
|
this.close();
|
|
} else {
|
|
if (arguments.length) {
|
|
this._source = layer;
|
|
} else {
|
|
layer = this._source;
|
|
}
|
|
this._prepareOpen();
|
|
|
|
// open the overlay on the map
|
|
this.openOn(layer._map);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
onAdd(map) {
|
|
this._zoomAnimated = map._zoomAnimated;
|
|
|
|
if (!this._container) {
|
|
this._initLayout();
|
|
}
|
|
|
|
if (map._fadeAnimated) {
|
|
this._container.style.opacity = 0;
|
|
}
|
|
|
|
clearTimeout(this._removeTimeout);
|
|
this.getPane().appendChild(this._container);
|
|
this.update();
|
|
|
|
if (map._fadeAnimated) {
|
|
this._container.style.opacity = 1;
|
|
}
|
|
|
|
this.bringToFront();
|
|
|
|
if (this.options.interactive) {
|
|
this._container.classList.add('leaflet-interactive');
|
|
this.addInteractiveTarget(this._container);
|
|
}
|
|
}
|
|
|
|
onRemove(map) {
|
|
if (map._fadeAnimated) {
|
|
this._container.style.opacity = 0;
|
|
this._removeTimeout = setTimeout(() => this._container.remove(), 200);
|
|
} else {
|
|
this._container.remove();
|
|
}
|
|
|
|
if (this.options.interactive) {
|
|
this._container.classList.remove('leaflet-interactive');
|
|
this.removeInteractiveTarget(this._container);
|
|
}
|
|
}
|
|
|
|
// @namespace DivOverlay
|
|
// @method getLatLng: LatLng
|
|
// Returns the geographical point of the overlay.
|
|
getLatLng() {
|
|
return this._latlng;
|
|
}
|
|
|
|
// @method setLatLng(latlng: LatLng): this
|
|
// Sets the geographical point where the overlay will open.
|
|
setLatLng(latlng) {
|
|
this._latlng = new LatLng(latlng);
|
|
if (this._map) {
|
|
this._updatePosition();
|
|
this._adjustPan();
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method getContent: String|HTMLElement|Function)
|
|
// Returns the content of the overlay.
|
|
getContent() {
|
|
return this._content;
|
|
}
|
|
|
|
// @method setContent(htmlContent: String|HTMLElement|Function): this
|
|
// Sets the HTML content of the overlay. If a function is passed the source layer will be passed to the function.
|
|
// The function should return a `String` or `HTMLElement` to be used in the overlay.
|
|
setContent(content) {
|
|
this._content = content;
|
|
this.update();
|
|
return this;
|
|
}
|
|
|
|
// @method getElement: HTMLElement
|
|
// Returns the HTML container of the overlay.
|
|
getElement() {
|
|
return this._container;
|
|
}
|
|
|
|
// @method update: null
|
|
// Updates the overlay content, layout and position. Useful for updating the overlay after something inside changed, e.g. image loaded.
|
|
update() {
|
|
if (!this._map) { return; }
|
|
|
|
this._container.style.visibility = 'hidden';
|
|
|
|
this._updateContent();
|
|
this._updateLayout();
|
|
this._updatePosition();
|
|
|
|
this._container.style.visibility = '';
|
|
|
|
this._adjustPan();
|
|
}
|
|
|
|
getEvents() {
|
|
const events = {
|
|
zoom: this._updatePosition,
|
|
viewreset: this._updatePosition
|
|
};
|
|
|
|
if (this._zoomAnimated) {
|
|
events.zoomanim = this._animateZoom;
|
|
}
|
|
return events;
|
|
}
|
|
|
|
// @method isOpen: Boolean
|
|
// Returns `true` when the overlay is visible on the map.
|
|
isOpen() {
|
|
return !!this._map && this._map.hasLayer(this);
|
|
}
|
|
|
|
// @method bringToFront: this
|
|
// Brings this overlay in front of other overlays (in the same map pane).
|
|
bringToFront() {
|
|
if (this._map) {
|
|
toFront(this._container);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method bringToBack: this
|
|
// Brings this overlay to the back of other overlays (in the same map pane).
|
|
bringToBack() {
|
|
if (this._map) {
|
|
toBack(this._container);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// prepare bound overlay to open: update latlng pos / content source (for FeatureGroup)
|
|
_prepareOpen(latlng) {
|
|
let source = this._source;
|
|
if (!source._map) { return false; }
|
|
|
|
if (source instanceof FeatureGroup) {
|
|
source = null;
|
|
for (const layer of Object.values(this._source._layers)) {
|
|
if (layer._map) {
|
|
source = layer;
|
|
break;
|
|
}
|
|
}
|
|
if (!source) { return false; } // Unable to get source layer.
|
|
|
|
// set overlay source to this layer
|
|
this._source = source;
|
|
}
|
|
|
|
if (!latlng) {
|
|
if (source.getCenter) {
|
|
latlng = source.getCenter();
|
|
} else if (source.getLatLng) {
|
|
latlng = source.getLatLng();
|
|
} else if (source.getBounds) {
|
|
latlng = source.getBounds().getCenter();
|
|
} else {
|
|
throw new Error('Unable to get source layer LatLng.');
|
|
}
|
|
}
|
|
this.setLatLng(latlng);
|
|
|
|
if (this._map) {
|
|
// update the overlay (content, layout, etc...)
|
|
this.update();
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
_updateContent() {
|
|
if (!this._content) { return; }
|
|
|
|
const node = this._contentNode;
|
|
const content = (typeof this._content === 'function') ? this._content(this._source ?? this) : this._content;
|
|
|
|
if (typeof content === 'string') {
|
|
node.innerHTML = content;
|
|
} else {
|
|
while (node.hasChildNodes()) {
|
|
node.removeChild(node.firstChild);
|
|
}
|
|
node.appendChild(content);
|
|
}
|
|
|
|
// @namespace DivOverlay
|
|
// @section DivOverlay events
|
|
// @event contentupdate: Event
|
|
// Fired when the content of the overlay is updated
|
|
this.fire('contentupdate');
|
|
}
|
|
|
|
_updatePosition() {
|
|
if (!this._map) { return; }
|
|
|
|
const pos = this._map.latLngToLayerPoint(this._latlng),
|
|
anchor = this._getAnchor();
|
|
let offset = new Point(this.options.offset);
|
|
|
|
if (this._zoomAnimated) {
|
|
setPosition(this._container, pos.add(anchor));
|
|
} else {
|
|
offset = offset.add(pos).add(anchor);
|
|
}
|
|
|
|
const bottom = this._containerBottom = -offset.y,
|
|
left = this._containerLeft = -Math.round(this._containerWidth / 2) + offset.x;
|
|
|
|
// bottom position the overlay in case the height of the overlay changes (images loading etc)
|
|
this._container.style.bottom = `${bottom}px`;
|
|
this._container.style.left = `${left}px`;
|
|
}
|
|
|
|
_getAnchor() {
|
|
return [0, 0];
|
|
}
|
|
|
|
}
|
|
|
|
Map$1.include({
|
|
_initOverlay(OverlayClass, content, latlng, options) {
|
|
let overlay = content;
|
|
if (!(overlay instanceof OverlayClass)) {
|
|
overlay = new OverlayClass(options).setContent(content);
|
|
}
|
|
if (latlng) {
|
|
overlay.setLatLng(latlng);
|
|
}
|
|
return overlay;
|
|
}
|
|
});
|
|
|
|
|
|
Layer.include({
|
|
_initOverlay(OverlayClass, old, content, options) {
|
|
let overlay = content;
|
|
if (overlay instanceof OverlayClass) {
|
|
setOptions(overlay, options);
|
|
overlay._source = this;
|
|
} else {
|
|
overlay = (old && !options) ? old : new OverlayClass(options, this);
|
|
overlay.setContent(content);
|
|
}
|
|
return overlay;
|
|
}
|
|
});
|
|
|
|
/*
|
|
* @class Popup
|
|
* @inherits DivOverlay
|
|
* Used to open popups in certain places of the map. Use [Map.openPopup](#map-openpopup) to
|
|
* open popups while making sure that only one popup is open at one time
|
|
* (recommended for usability), or use [Map.addLayer](#map-addlayer) to open as many as you want.
|
|
*
|
|
* @example
|
|
*
|
|
* If you want to just bind a popup to marker click and then open it, it's really easy:
|
|
*
|
|
* ```js
|
|
* marker.bindPopup(popupContent).openPopup();
|
|
* ```
|
|
* Path overlays like polylines also have a `bindPopup` method.
|
|
*
|
|
* A popup can be also standalone:
|
|
*
|
|
* ```js
|
|
* const popup = new Popup()
|
|
* .setLatLng(latlng)
|
|
* .setContent('<p>Hello world!<br />This is a nice popup.</p>')
|
|
* .openOn(map);
|
|
* ```
|
|
* or
|
|
* ```js
|
|
* const popup = new Popup(latlng, {content: '<p>Hello world!<br />This is a nice popup.</p>'})
|
|
* .openOn(map);
|
|
* ```
|
|
*/
|
|
|
|
|
|
// @namespace Popup
|
|
// @constructor Popup(options?: Popup options, source?: Layer)
|
|
// Instantiates a `Popup` object given an optional `options` object that describes its appearance and location and an optional `source` object that is used to tag the popup with a reference to the Layer to which it refers.
|
|
// @alternative
|
|
// @constructor Popup(latlng: LatLng, options?: Popup options)
|
|
// Instantiates a `Popup` object given `latlng` where the popup will open and an optional `options` object that describes its appearance and location.
|
|
class Popup extends DivOverlay {
|
|
|
|
static {
|
|
// @section
|
|
// @aka Popup options
|
|
this.setDefaultOptions({
|
|
// @option pane: String = 'popupPane'
|
|
// `Map pane` where the popup will be added.
|
|
pane: 'popupPane',
|
|
|
|
// @option offset: Point = Point(0, 7)
|
|
// The offset of the popup position.
|
|
offset: [0, 7],
|
|
|
|
// @option maxWidth: Number = 300
|
|
// Max width of the popup, in pixels.
|
|
maxWidth: 300,
|
|
|
|
// @option minWidth: Number = 50
|
|
// Min width of the popup, in pixels.
|
|
minWidth: 50,
|
|
|
|
// @option maxHeight: Number = null
|
|
// If set, creates a scrollable container of the given height
|
|
// inside a popup if its content exceeds it.
|
|
// The scrollable container can be styled using the
|
|
// `leaflet-popup-scrolled` CSS class selector.
|
|
maxHeight: null,
|
|
|
|
// @option autoPan: Boolean = true
|
|
// Set it to `false` if you don't want the map to do panning animation
|
|
// to fit the opened popup.
|
|
autoPan: true,
|
|
|
|
// @option autoPanPaddingTopLeft: Point = null
|
|
// The margin between the popup and the top left corner of the map
|
|
// view after autopanning was performed.
|
|
autoPanPaddingTopLeft: null,
|
|
|
|
// @option autoPanPaddingBottomRight: Point = null
|
|
// The margin between the popup and the bottom right corner of the map
|
|
// view after autopanning was performed.
|
|
autoPanPaddingBottomRight: null,
|
|
|
|
// @option autoPanPadding: Point = Point(5, 5)
|
|
// Equivalent of setting both top left and bottom right autopan padding to the same value.
|
|
autoPanPadding: [5, 5],
|
|
|
|
// @option keepInView: Boolean = false
|
|
// Set it to `true` if you want to prevent users from panning the popup
|
|
// off of the screen while it is open.
|
|
keepInView: false,
|
|
|
|
// @option closeButton: Boolean = true
|
|
// Controls the presence of a close button in the popup.
|
|
closeButton: true,
|
|
|
|
// @option closeButtonLabel: String = 'Close popup'
|
|
// Specifies the 'aria-label' attribute of the close button.
|
|
closeButtonLabel: 'Close popup',
|
|
|
|
// @option autoClose: Boolean = true
|
|
// Set it to `false` if you want to override the default behavior of
|
|
// the popup closing when another popup is opened.
|
|
autoClose: true,
|
|
|
|
// @option closeOnEscapeKey: Boolean = true
|
|
// Set it to `false` if you want to override the default behavior of
|
|
// the ESC key for closing of the popup.
|
|
closeOnEscapeKey: true,
|
|
|
|
// @option closeOnClick: Boolean = *
|
|
// Set it if you want to override the default behavior of the popup closing when user clicks
|
|
// on the map. Defaults to the map's [`closePopupOnClick`](#map-closepopuponclick) option.
|
|
|
|
// @option className: String = ''
|
|
// A custom CSS class name to assign to the popup.
|
|
className: '',
|
|
|
|
// @option trackResize: Boolean = true
|
|
// Whether the popup shall react to changes in the size of its contents
|
|
// (e.g. when an image inside the popup loads) and reposition itself.
|
|
trackResize: true,
|
|
});
|
|
}
|
|
|
|
// @namespace Popup
|
|
// @method openOn(map: Map): this
|
|
// Alternative to `map.openPopup(popup)`.
|
|
// Adds the popup to the map and closes the previous one.
|
|
openOn(map) {
|
|
map = arguments.length ? map : this._source._map; // experimental, not the part of public api
|
|
|
|
if (!map.hasLayer(this) && map._popup && map._popup.options.autoClose) {
|
|
map.removeLayer(map._popup);
|
|
}
|
|
map._popup = this;
|
|
|
|
return DivOverlay.prototype.openOn.call(this, map);
|
|
}
|
|
|
|
onAdd(map) {
|
|
DivOverlay.prototype.onAdd.call(this, map);
|
|
|
|
// @namespace Map
|
|
// @section Popup events
|
|
// @event popupopen: PopupEvent
|
|
// Fired when a popup is opened in the map
|
|
map.fire('popupopen', {popup: this});
|
|
|
|
if (this._source) {
|
|
// @namespace Layer
|
|
// @section Popup events
|
|
// @event popupopen: PopupEvent
|
|
// Fired when a popup bound to this layer is opened
|
|
this._source.fire('popupopen', {popup: this}, true);
|
|
// For non-path layers, we toggle the popup when clicking
|
|
// again the layer, so prevent the map to reopen it.
|
|
if (!(this._source instanceof Path)) {
|
|
this._source.on('preclick', stopPropagation);
|
|
}
|
|
}
|
|
}
|
|
|
|
onRemove(map) {
|
|
DivOverlay.prototype.onRemove.call(this, map);
|
|
|
|
// @namespace Map
|
|
// @section Popup events
|
|
// @event popupclose: PopupEvent
|
|
// Fired when a popup in the map is closed
|
|
map.fire('popupclose', {popup: this});
|
|
|
|
if (this._source) {
|
|
// @namespace Layer
|
|
// @section Popup events
|
|
// @event popupclose: PopupEvent
|
|
// Fired when a popup bound to this layer is closed
|
|
this._source.fire('popupclose', {popup: this}, true);
|
|
if (!(this._source instanceof Path)) {
|
|
this._source.off('preclick', stopPropagation);
|
|
}
|
|
}
|
|
}
|
|
|
|
getEvents() {
|
|
const events = DivOverlay.prototype.getEvents.call(this);
|
|
|
|
if (this.options.closeOnClick ?? this._map.options.closePopupOnClick) {
|
|
events.preclick = this.close;
|
|
}
|
|
|
|
if (this.options.keepInView) {
|
|
events.moveend = this._adjustPan;
|
|
}
|
|
|
|
return events;
|
|
}
|
|
|
|
_initLayout() {
|
|
const prefix = 'leaflet-popup',
|
|
container = this._container = create$1('div', `${prefix} ${this.options.className || ''} leaflet-zoom-animated`);
|
|
|
|
const wrapper = this._wrapper = create$1('div', `${prefix}-content-wrapper`, container);
|
|
this._contentNode = create$1('div', `${prefix}-content`, wrapper);
|
|
|
|
disableClickPropagation(container);
|
|
disableScrollPropagation(this._contentNode);
|
|
on(container, 'contextmenu', stopPropagation);
|
|
|
|
this._tipContainer = create$1('div', `${prefix}-tip-container`, container);
|
|
this._tip = create$1('div', `${prefix}-tip`, this._tipContainer);
|
|
|
|
if (this.options.closeButton) {
|
|
const closeButton = this._closeButton = create$1('a', `${prefix}-close-button`, container);
|
|
closeButton.setAttribute('role', 'button'); // overrides the implicit role=link of <a> elements #7399
|
|
closeButton.setAttribute('aria-label', this.options.closeButtonLabel);
|
|
|
|
closeButton.href = '#close';
|
|
closeButton.innerHTML = '<span aria-hidden="true">×</span>';
|
|
|
|
on(closeButton, 'click', (ev) => {
|
|
preventDefault(ev);
|
|
this.close();
|
|
});
|
|
}
|
|
|
|
|
|
if (this.options.trackResize) {
|
|
this._resizeObserver = new ResizeObserver(((entries) => {
|
|
if (!this._map) { return; }
|
|
this._containerWidth = entries[0]?.contentRect?.width;
|
|
this._containerHeight = entries[0]?.contentRect?.height;
|
|
|
|
this._updateLayout();
|
|
this._updatePosition();
|
|
this._adjustPan();
|
|
}));
|
|
|
|
this._resizeObserver.observe(this._contentNode);
|
|
}
|
|
}
|
|
|
|
_updateLayout() {
|
|
const container = this._contentNode,
|
|
style = container.style;
|
|
|
|
style.maxWidth = `${this.options.maxWidth}px`;
|
|
style.minWidth = `${this.options.minWidth}px`;
|
|
|
|
const height = this._containerHeight ?? container.offsetHeight,
|
|
maxHeight = this.options.maxHeight,
|
|
scrolledClass = 'leaflet-popup-scrolled';
|
|
|
|
if (maxHeight && height > maxHeight) {
|
|
style.height = `${maxHeight}px`;
|
|
container.classList.add(scrolledClass);
|
|
} else {
|
|
container.classList.remove(scrolledClass);
|
|
}
|
|
|
|
this._containerWidth = this._container.offsetWidth;
|
|
this._containerHeight = this._container.offsetHeight;
|
|
}
|
|
|
|
_animateZoom(e) {
|
|
const pos = this._map._latLngToNewLayerPoint(this._latlng, e.zoom, e.center),
|
|
anchor = this._getAnchor();
|
|
setPosition(this._container, pos.add(anchor));
|
|
}
|
|
|
|
_adjustPan() {
|
|
if (!this.options.autoPan) { return; }
|
|
this._map._panAnim?.stop();
|
|
|
|
// We can endlessly recurse if keepInView is set and the view resets.
|
|
// Let's guard against that by exiting early if we're responding to our own autopan.
|
|
if (this._autopanning) {
|
|
this._autopanning = false;
|
|
return;
|
|
}
|
|
|
|
const map = this._map,
|
|
marginBottom = parseInt(getComputedStyle(this._container).marginBottom, 10) || 0,
|
|
containerHeight = this._containerHeight + marginBottom,
|
|
containerWidth = this._containerWidth,
|
|
layerPos = new Point(this._containerLeft, -containerHeight - this._containerBottom);
|
|
|
|
layerPos._add(getPosition(this._container));
|
|
|
|
const containerPos = map.layerPointToContainerPoint(layerPos),
|
|
padding = new Point(this.options.autoPanPadding),
|
|
paddingTL = new Point(this.options.autoPanPaddingTopLeft ?? padding),
|
|
paddingBR = new Point(this.options.autoPanPaddingBottomRight ?? padding),
|
|
size = map.getSize();
|
|
let dx = 0,
|
|
dy = 0;
|
|
|
|
if (containerPos.x + containerWidth + paddingBR.x > size.x) { // right
|
|
dx = containerPos.x + containerWidth - size.x + paddingBR.x;
|
|
}
|
|
if (containerPos.x - dx - paddingTL.x < 0) { // left
|
|
dx = containerPos.x - paddingTL.x;
|
|
}
|
|
if (containerPos.y + containerHeight + paddingBR.y > size.y) { // bottom
|
|
dy = containerPos.y + containerHeight - size.y + paddingBR.y;
|
|
}
|
|
if (containerPos.y - dy - paddingTL.y < 0) { // top
|
|
dy = containerPos.y - paddingTL.y;
|
|
}
|
|
|
|
// @namespace Map
|
|
// @section Popup events
|
|
// @event autopanstart: Event
|
|
// Fired when the map starts autopanning when opening a popup.
|
|
if (dx || dy) {
|
|
// Track that we're autopanning, as this function will be re-ran on moveend
|
|
if (this.options.keepInView) {
|
|
this._autopanning = true;
|
|
}
|
|
|
|
map
|
|
.fire('autopanstart')
|
|
.panBy([dx, dy]);
|
|
}
|
|
}
|
|
|
|
_getAnchor() {
|
|
// Where should we anchor the popup on the source layer?
|
|
return new Point(this._source?._getPopupAnchor ? this._source._getPopupAnchor() : [0, 0]);
|
|
}
|
|
|
|
}
|
|
|
|
|
|
/* @namespace Map
|
|
* @section Interaction Options
|
|
* @option closePopupOnClick: Boolean = true
|
|
* Set it to `false` if you don't want popups to close when user clicks the map.
|
|
*/
|
|
Map$1.mergeOptions({
|
|
closePopupOnClick: true
|
|
});
|
|
|
|
|
|
// @namespace Map
|
|
// @section Methods for Layers and Controls
|
|
Map$1.include({
|
|
// @method openPopup(popup: Popup): this
|
|
// Opens the specified popup while closing the previously opened (to make sure only one is opened at one time for usability).
|
|
// @alternative
|
|
// @method openPopup(content: String|HTMLElement, latlng: LatLng, options?: Popup options): this
|
|
// Creates a popup with the specified content and options and opens it in the given point on a map.
|
|
openPopup(popup, latlng, options) {
|
|
this._initOverlay(Popup, popup, latlng, options)
|
|
.openOn(this);
|
|
|
|
return this;
|
|
},
|
|
|
|
// @method closePopup(popup?: Popup): this
|
|
// Closes the popup previously opened with [openPopup](#map-openpopup) (or the given one).
|
|
closePopup(popup) {
|
|
popup = arguments.length ? popup : this._popup;
|
|
popup?.close();
|
|
return this;
|
|
}
|
|
});
|
|
|
|
/*
|
|
* @namespace Layer
|
|
* @section Popup methods example
|
|
*
|
|
* All layers share a set of methods convenient for binding popups to it.
|
|
*
|
|
* ```js
|
|
* const layer = new Polygon(latlngs).bindPopup('Hi There!').addTo(map);
|
|
* layer.openPopup();
|
|
* layer.closePopup();
|
|
* ```
|
|
*
|
|
* Popups will also be automatically opened when the layer is clicked on and closed when the layer is removed from the map or another popup is opened.
|
|
*/
|
|
|
|
// @section Popup methods
|
|
Layer.include({
|
|
|
|
// @method bindPopup(content: String|HTMLElement|Function|Popup, options?: Popup options): this
|
|
// Binds a popup to the layer with the passed `content` and sets up the
|
|
// necessary event listeners. If a `Function` is passed it will receive
|
|
// the layer as the first argument and should return a `String` or `HTMLElement`.
|
|
bindPopup(content, options) {
|
|
this._popup = this._initOverlay(Popup, this._popup, content, options);
|
|
if (!this._popupHandlersAdded) {
|
|
this.on({
|
|
click: this._openPopup,
|
|
keypress: this._onKeyPress,
|
|
remove: this.closePopup,
|
|
move: this._movePopup
|
|
});
|
|
this._popupHandlersAdded = true;
|
|
}
|
|
|
|
return this;
|
|
},
|
|
|
|
// @method unbindPopup(): this
|
|
// Removes the popup previously bound with `bindPopup`.
|
|
unbindPopup() {
|
|
if (this._popup) {
|
|
this.off({
|
|
click: this._openPopup,
|
|
keypress: this._onKeyPress,
|
|
remove: this.closePopup,
|
|
move: this._movePopup
|
|
});
|
|
this._popupHandlersAdded = false;
|
|
this._popup = null;
|
|
}
|
|
return this;
|
|
},
|
|
|
|
// @method openPopup(latlng?: LatLng): this
|
|
// Opens the bound popup at the specified `latlng` or at the default popup anchor if no `latlng` is passed.
|
|
openPopup(latlng) {
|
|
if (this._popup) {
|
|
if (!(this instanceof FeatureGroup)) {
|
|
this._popup._source = this;
|
|
}
|
|
if (this._popup._prepareOpen(latlng || this._latlng)) {
|
|
// open the popup on the map
|
|
this._popup.openOn(this._map);
|
|
}
|
|
}
|
|
return this;
|
|
},
|
|
|
|
// @method closePopup(): this
|
|
// Closes the popup bound to this layer if it is open.
|
|
closePopup() {
|
|
this._popup?.close();
|
|
return this;
|
|
},
|
|
|
|
// @method togglePopup(): this
|
|
// Opens or closes the popup bound to this layer depending on its current state.
|
|
togglePopup() {
|
|
this._popup?.toggle(this);
|
|
return this;
|
|
},
|
|
|
|
// @method isPopupOpen(): boolean
|
|
// Returns `true` if the popup bound to this layer is currently open.
|
|
isPopupOpen() {
|
|
return this._popup?.isOpen() ?? false;
|
|
},
|
|
|
|
// @method setPopupContent(content: String|HTMLElement|Popup): this
|
|
// Sets the content of the popup bound to this layer.
|
|
setPopupContent(content) {
|
|
this._popup?.setContent(content);
|
|
return this;
|
|
},
|
|
|
|
// @method getPopup(): Popup
|
|
// Returns the popup bound to this layer.
|
|
getPopup() {
|
|
return this._popup;
|
|
},
|
|
|
|
_openPopup(e) {
|
|
if (!this._popup || !this._map) {
|
|
return;
|
|
}
|
|
// prevent map click
|
|
stop(e);
|
|
|
|
const target = e.propagatedFrom ?? e.target;
|
|
if (this._popup._source === target && !(target instanceof Path)) {
|
|
// treat it like a marker and figure out
|
|
// if we should toggle it open/closed
|
|
if (this._map.hasLayer(this._popup)) {
|
|
this.closePopup();
|
|
} else {
|
|
this.openPopup(e.latlng);
|
|
}
|
|
return;
|
|
}
|
|
this._popup._source = target;
|
|
this.openPopup(e.latlng);
|
|
},
|
|
|
|
_movePopup(e) {
|
|
this._popup.setLatLng(e.latlng);
|
|
},
|
|
|
|
_onKeyPress(e) {
|
|
if (e.originalEvent.code === 'Enter') {
|
|
this._openPopup(e);
|
|
}
|
|
}
|
|
});
|
|
|
|
/*
|
|
* @class Tooltip
|
|
* @inherits DivOverlay
|
|
* Used to display small texts on top of map layers.
|
|
*
|
|
* @example
|
|
* If you want to just bind a tooltip to marker:
|
|
*
|
|
* ```js
|
|
* marker.bindTooltip("my tooltip text").openTooltip();
|
|
* ```
|
|
* Path overlays like polylines also have a `bindTooltip` method.
|
|
*
|
|
* A tooltip can be also standalone:
|
|
*
|
|
* ```js
|
|
* const tooltip = new Tooltip()
|
|
* .setLatLng(latlng)
|
|
* .setContent('Hello world!<br />This is a nice tooltip.')
|
|
* .addTo(map);
|
|
* ```
|
|
* or
|
|
* ```js
|
|
* const tooltip = new Tooltip(latlng, {content: 'Hello world!<br />This is a nice tooltip.'})
|
|
* .addTo(map);
|
|
* ```
|
|
*
|
|
*
|
|
* Note about tooltip offset. Leaflet takes two options in consideration
|
|
* for computing tooltip offsetting:
|
|
* - the `offset` Tooltip option: it defaults to [0, 0], and it's specific to one tooltip.
|
|
* Add a positive x offset to move the tooltip to the right, and a positive y offset to
|
|
* move it to the bottom. Negatives will move to the left and top.
|
|
* - the `tooltipAnchor` Icon option: this will only be considered for Marker. You
|
|
* should adapt this value if you use a custom icon.
|
|
*/
|
|
|
|
|
|
// @namespace Tooltip
|
|
// @constructor Tooltip(options?: Tooltip options, source?: Layer)
|
|
// Instantiates a `Tooltip` object given an optional `options` object that describes its appearance and location and an optional `source` object that is used to tag the tooltip with a reference to the Layer to which it refers.
|
|
// @alternative
|
|
// @constructor Tooltip(latlng: LatLng, options?: Tooltip options)
|
|
// Instantiates a `Tooltip` object given `latlng` where the tooltip will open and an optional `options` object that describes its appearance and location.
|
|
class Tooltip extends DivOverlay {
|
|
|
|
static {
|
|
// @section
|
|
// @aka Tooltip options
|
|
this.setDefaultOptions({
|
|
// @option pane: String = 'tooltipPane'
|
|
// `Map pane` where the tooltip will be added.
|
|
pane: 'tooltipPane',
|
|
|
|
// @option offset: Point = Point(0, 0)
|
|
// Optional offset of the tooltip position.
|
|
offset: [0, 0],
|
|
|
|
// @option direction: String = 'auto'
|
|
// Direction where to open the tooltip. Possible values are: `right`, `left`,
|
|
// `top`, `bottom`, `center`, `auto`.
|
|
// `auto` will dynamically switch between `right` and `left` according to the tooltip
|
|
// position on the map.
|
|
direction: 'auto',
|
|
|
|
// @option permanent: Boolean = false
|
|
// Whether to open the tooltip permanently or only on pointerover.
|
|
permanent: false,
|
|
|
|
// @option sticky: Boolean = false
|
|
// If true, the tooltip will follow the pointer instead of being fixed at the feature center.
|
|
sticky: false,
|
|
|
|
// @option opacity: Number = 0.9
|
|
// Tooltip container opacity.
|
|
opacity: 0.9
|
|
});
|
|
}
|
|
|
|
onAdd(map) {
|
|
DivOverlay.prototype.onAdd.call(this, map);
|
|
this.setOpacity(this.options.opacity);
|
|
|
|
// @namespace Map
|
|
// @section Tooltip events
|
|
// @event tooltipopen: TooltipEvent
|
|
// Fired when a tooltip is opened in the map.
|
|
map.fire('tooltipopen', {tooltip: this});
|
|
|
|
if (this._source) {
|
|
this.addEventParent(this._source);
|
|
|
|
// @namespace Layer
|
|
// @section Tooltip events
|
|
// @event tooltipopen: TooltipEvent
|
|
// Fired when a tooltip bound to this layer is opened.
|
|
this._source.fire('tooltipopen', {tooltip: this}, true);
|
|
}
|
|
}
|
|
|
|
onRemove(map) {
|
|
DivOverlay.prototype.onRemove.call(this, map);
|
|
|
|
// @namespace Map
|
|
// @section Tooltip events
|
|
// @event tooltipclose: TooltipEvent
|
|
// Fired when a tooltip in the map is closed.
|
|
map.fire('tooltipclose', {tooltip: this});
|
|
|
|
if (this._source) {
|
|
this.removeEventParent(this._source);
|
|
|
|
// @namespace Layer
|
|
// @section Tooltip events
|
|
// @event tooltipclose: TooltipEvent
|
|
// Fired when a tooltip bound to this layer is closed.
|
|
this._source.fire('tooltipclose', {tooltip: this}, true);
|
|
}
|
|
}
|
|
|
|
getEvents() {
|
|
const events = DivOverlay.prototype.getEvents.call(this);
|
|
|
|
if (!this.options.permanent) {
|
|
events.preclick = this.close;
|
|
}
|
|
|
|
return events;
|
|
}
|
|
|
|
_initLayout() {
|
|
const prefix = 'leaflet-tooltip',
|
|
className = `${prefix} ${this.options.className || ''} leaflet-zoom-${this._zoomAnimated ? 'animated' : 'hide'}`;
|
|
|
|
this._contentNode = this._container = create$1('div', className);
|
|
|
|
this._container.setAttribute('role', 'tooltip');
|
|
this._container.setAttribute('id', `leaflet-tooltip-${stamp(this)}`);
|
|
}
|
|
|
|
_updateLayout() {}
|
|
|
|
_adjustPan() {}
|
|
|
|
_setPosition(pos) {
|
|
let subX, subY, direction = this.options.direction;
|
|
const map = this._map,
|
|
container = this._container,
|
|
centerPoint = map.latLngToContainerPoint(map.getCenter()),
|
|
tooltipPoint = map.layerPointToContainerPoint(pos),
|
|
tooltipWidth = container.offsetWidth,
|
|
tooltipHeight = container.offsetHeight,
|
|
offset = new Point(this.options.offset),
|
|
anchor = this._getAnchor();
|
|
|
|
if (direction === 'top') {
|
|
subX = tooltipWidth / 2;
|
|
subY = tooltipHeight;
|
|
} else if (direction === 'bottom') {
|
|
subX = tooltipWidth / 2;
|
|
subY = 0;
|
|
} else if (direction === 'center') {
|
|
subX = tooltipWidth / 2;
|
|
subY = tooltipHeight / 2;
|
|
} else if (direction === 'right') {
|
|
subX = 0;
|
|
subY = tooltipHeight / 2;
|
|
} else if (direction === 'left') {
|
|
subX = tooltipWidth;
|
|
subY = tooltipHeight / 2;
|
|
} else if (tooltipPoint.x < centerPoint.x) {
|
|
direction = 'right';
|
|
subX = 0;
|
|
subY = tooltipHeight / 2;
|
|
} else {
|
|
direction = 'left';
|
|
subX = tooltipWidth + (offset.x + anchor.x) * 2;
|
|
subY = tooltipHeight / 2;
|
|
}
|
|
|
|
pos = pos.subtract(new Point(subX, subY, true)).add(offset).add(anchor);
|
|
|
|
container.classList.remove(
|
|
'leaflet-tooltip-right',
|
|
'leaflet-tooltip-left',
|
|
'leaflet-tooltip-top',
|
|
'leaflet-tooltip-bottom'
|
|
);
|
|
container.classList.add(`leaflet-tooltip-${direction}`);
|
|
setPosition(container, pos);
|
|
}
|
|
|
|
_updatePosition() {
|
|
const pos = this._map.latLngToLayerPoint(this._latlng);
|
|
this._setPosition(pos);
|
|
}
|
|
|
|
setOpacity(opacity) {
|
|
this.options.opacity = opacity;
|
|
|
|
if (this._container) {
|
|
this._container.style.opacity = opacity;
|
|
}
|
|
}
|
|
|
|
_animateZoom(e) {
|
|
const pos = this._map._latLngToNewLayerPoint(this._latlng, e.zoom, e.center);
|
|
this._setPosition(pos);
|
|
}
|
|
|
|
_getAnchor() {
|
|
// Where should we anchor the tooltip on the source layer?
|
|
return new Point(this._source?._getTooltipAnchor && !this.options.sticky ? this._source._getTooltipAnchor() : [0, 0]);
|
|
}
|
|
|
|
}
|
|
|
|
// @namespace Map
|
|
// @section Methods for Layers and Controls
|
|
Map$1.include({
|
|
|
|
// @method openTooltip(tooltip: Tooltip): this
|
|
// Opens the specified tooltip.
|
|
// @alternative
|
|
// @method openTooltip(content: String|HTMLElement, latlng: LatLng, options?: Tooltip options): this
|
|
// Creates a tooltip with the specified content and options and open it.
|
|
openTooltip(tooltip, latlng, options) {
|
|
this._initOverlay(Tooltip, tooltip, latlng, options)
|
|
.openOn(this);
|
|
|
|
return this;
|
|
},
|
|
|
|
// @method closeTooltip(tooltip: Tooltip): this
|
|
// Closes the tooltip given as parameter.
|
|
closeTooltip(tooltip) {
|
|
tooltip.close();
|
|
return this;
|
|
}
|
|
|
|
});
|
|
|
|
/*
|
|
* @namespace Layer
|
|
* @section Tooltip methods example
|
|
*
|
|
* All layers share a set of methods convenient for binding tooltips to it.
|
|
*
|
|
* ```js
|
|
* const layer = new Polygon(latlngs).bindTooltip('Hi There!').addTo(map);
|
|
* layer.openTooltip();
|
|
* layer.closeTooltip();
|
|
* ```
|
|
*/
|
|
|
|
// @section Tooltip methods
|
|
Layer.include({
|
|
|
|
// @method bindTooltip(content: String|HTMLElement|Function|Tooltip, options?: Tooltip options): this
|
|
// Binds a tooltip to the layer with the passed `content` and sets up the
|
|
// necessary event listeners. If a `Function` is passed it will receive
|
|
// the layer as the first argument and should return a `String` or `HTMLElement`.
|
|
bindTooltip(content, options) {
|
|
|
|
if (this._tooltip && this.isTooltipOpen()) {
|
|
this.unbindTooltip();
|
|
}
|
|
|
|
this._tooltip = this._initOverlay(Tooltip, this._tooltip, content, options);
|
|
this._initTooltipInteractions();
|
|
|
|
if (this._tooltip.options.permanent && this._map && this._map.hasLayer(this)) {
|
|
this.openTooltip();
|
|
}
|
|
|
|
return this;
|
|
},
|
|
|
|
// @method unbindTooltip(): this
|
|
// Removes the tooltip previously bound with `bindTooltip`.
|
|
unbindTooltip() {
|
|
if (this._tooltip) {
|
|
this._initTooltipInteractions(true);
|
|
this.closeTooltip();
|
|
this._tooltip = null;
|
|
}
|
|
return this;
|
|
},
|
|
|
|
_initTooltipInteractions(remove) {
|
|
if (!remove && this._tooltipHandlersAdded) { return; }
|
|
const onOff = remove ? 'off' : 'on',
|
|
events = {
|
|
remove: this.closeTooltip,
|
|
move: this._moveTooltip
|
|
};
|
|
if (!this._tooltip.options.permanent) {
|
|
events.pointerover = this._openTooltip;
|
|
events.pointerout = this.closeTooltip;
|
|
events.click = this._openTooltip;
|
|
if (this._map) {
|
|
this._addFocusListeners(remove);
|
|
} else {
|
|
events.add = () => this._addFocusListeners(remove);
|
|
}
|
|
} else {
|
|
events.add = this._openTooltip;
|
|
}
|
|
if (this._tooltip.options.sticky) {
|
|
events.pointermove = this._moveTooltip;
|
|
}
|
|
this[onOff](events);
|
|
this._tooltipHandlersAdded = !remove;
|
|
},
|
|
|
|
// @method openTooltip(latlng?: LatLng): this
|
|
// Opens the bound tooltip at the specified `latlng` or at the default tooltip anchor if no `latlng` is passed.
|
|
openTooltip(latlng) {
|
|
if (this._tooltip) {
|
|
if (!(this instanceof FeatureGroup)) {
|
|
this._tooltip._source = this;
|
|
}
|
|
if (this._tooltip._prepareOpen(latlng)) {
|
|
// open the tooltip on the map
|
|
this._tooltip.openOn(this._map);
|
|
|
|
if (this.getElement) {
|
|
this._setAriaDescribedByOnLayer(this);
|
|
} else if (this.eachLayer) {
|
|
this.eachLayer(this._setAriaDescribedByOnLayer, this);
|
|
}
|
|
}
|
|
}
|
|
return this;
|
|
},
|
|
|
|
// @method closeTooltip(): this
|
|
// Closes the tooltip bound to this layer if it is open.
|
|
closeTooltip() {
|
|
if (this._tooltip) {
|
|
return this._tooltip.close();
|
|
}
|
|
},
|
|
|
|
// @method toggleTooltip(): this
|
|
// Opens or closes the tooltip bound to this layer depending on its current state.
|
|
toggleTooltip() {
|
|
this._tooltip?.toggle(this);
|
|
return this;
|
|
},
|
|
|
|
// @method isTooltipOpen(): boolean
|
|
// Returns `true` if the tooltip bound to this layer is currently open.
|
|
isTooltipOpen() {
|
|
return this._tooltip.isOpen();
|
|
},
|
|
|
|
// @method setTooltipContent(content: String|HTMLElement|Tooltip): this
|
|
// Sets the content of the tooltip bound to this layer.
|
|
setTooltipContent(content) {
|
|
this._tooltip?.setContent(content);
|
|
return this;
|
|
},
|
|
|
|
// @method getTooltip(): Tooltip
|
|
// Returns the tooltip bound to this layer.
|
|
getTooltip() {
|
|
return this._tooltip;
|
|
},
|
|
|
|
_addFocusListeners(remove) {
|
|
if (this.getElement) {
|
|
this._addFocusListenersOnLayer(this, remove);
|
|
} else if (this.eachLayer) {
|
|
this.eachLayer(layer => this._addFocusListenersOnLayer(layer, remove), this);
|
|
}
|
|
},
|
|
|
|
_addFocusListenersOnLayer(layer, remove) {
|
|
const el = typeof layer.getElement === 'function' && layer.getElement();
|
|
if (el) {
|
|
const onOff = remove ? 'off' : 'on';
|
|
if (!remove) {
|
|
// Remove focus listener, if already existing
|
|
el._leaflet_focus_handler && off(el, 'focus', el._leaflet_focus_handler, this);
|
|
|
|
// eslint-disable-next-line camelcase
|
|
el._leaflet_focus_handler = () => {
|
|
if (this._tooltip) {
|
|
this._tooltip._source = layer;
|
|
this.openTooltip();
|
|
}
|
|
};
|
|
}
|
|
|
|
el._leaflet_focus_handler && DomEvent[onOff](el, 'focus', el._leaflet_focus_handler, this);
|
|
DomEvent[onOff](el, 'blur', this.closeTooltip, this);
|
|
|
|
if (remove) {
|
|
delete el._leaflet_focus_handler;
|
|
}
|
|
}
|
|
},
|
|
|
|
_setAriaDescribedByOnLayer(layer) {
|
|
const el = typeof layer.getElement === 'function' && layer.getElement();
|
|
el?.setAttribute?.('aria-describedby', this._tooltip._container.id);
|
|
},
|
|
|
|
|
|
_openTooltip(e) {
|
|
if (!this._tooltip || !this._map) {
|
|
return;
|
|
}
|
|
|
|
// If the map is moving, we will show the tooltip after it's done.
|
|
if (this._map.dragging?.moving()) {
|
|
if (e.type === 'add' && !this._moveEndOpensTooltip) {
|
|
this._moveEndOpensTooltip = true;
|
|
this._map.once('moveend', () => {
|
|
this._moveEndOpensTooltip = false;
|
|
this._openTooltip(e);
|
|
});
|
|
}
|
|
return;
|
|
}
|
|
|
|
this._tooltip._source = e.propagatedFrom ?? e.target;
|
|
|
|
this.openTooltip(this._tooltip.options.sticky ? e.latlng : undefined);
|
|
},
|
|
|
|
_moveTooltip(e) {
|
|
let latlng = e.latlng, containerPoint, layerPoint;
|
|
if (this._tooltip.options.sticky && e.originalEvent) {
|
|
containerPoint = this._map.pointerEventToContainerPoint(e.originalEvent);
|
|
layerPoint = this._map.containerPointToLayerPoint(containerPoint);
|
|
latlng = this._map.layerPointToLatLng(layerPoint);
|
|
}
|
|
this._tooltip.setLatLng(latlng);
|
|
}
|
|
});
|
|
|
|
/*
|
|
* @class DivIcon
|
|
* @inherits Icon
|
|
*
|
|
* Represents a lightweight icon for markers that uses a simple `<div>`
|
|
* element instead of an image. Inherits from `Icon` but ignores the `iconUrl` and shadow options.
|
|
*
|
|
* @example
|
|
* ```js
|
|
* const myIcon = new DivIcon({className: 'my-div-icon'});
|
|
* // you can set .my-div-icon styles in CSS
|
|
*
|
|
* new Marker([50.505, 30.57], {icon: myIcon}).addTo(map);
|
|
* ```
|
|
*
|
|
* By default, it has a 'leaflet-div-icon' CSS class and is styled as a little white square with a shadow.
|
|
*/
|
|
|
|
// @constructor DivIcon(options: DivIcon options)
|
|
// Creates a `DivIcon` instance with the given options.
|
|
class DivIcon extends Icon {
|
|
|
|
static {
|
|
this.setDefaultOptions({
|
|
// @section
|
|
// @aka DivIcon options
|
|
iconSize: [12, 12], // also can be set through CSS
|
|
|
|
// iconAnchor: (Point),
|
|
// popupAnchor: (Point),
|
|
|
|
// @option html: String|HTMLElement = ''
|
|
// Custom HTML code to put inside the div element, empty by default. Alternatively,
|
|
// an instance of `HTMLElement`.
|
|
html: false,
|
|
|
|
// @option bgPos: Point = [0, 0]
|
|
// Optional relative position of the background, in pixels
|
|
bgPos: null,
|
|
|
|
className: 'leaflet-div-icon'
|
|
});
|
|
}
|
|
|
|
createIcon(oldIcon) {
|
|
const div = (oldIcon && oldIcon.tagName === 'DIV') ? oldIcon : document.createElement('div'),
|
|
options = this.options;
|
|
|
|
if (options.html instanceof Element) {
|
|
div.replaceChildren();
|
|
div.appendChild(options.html);
|
|
} else {
|
|
div.innerHTML = options.html !== false ? options.html : '';
|
|
}
|
|
|
|
if (options.bgPos) {
|
|
const bgPos = new Point(options.bgPos);
|
|
div.style.backgroundPosition = `${-bgPos.x}px ${-bgPos.y}px`;
|
|
}
|
|
this._setIconStyles(div, 'icon');
|
|
|
|
return div;
|
|
}
|
|
|
|
createShadow() {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
Icon.Default = IconDefault;
|
|
|
|
/*
|
|
* @class GridLayer
|
|
* @inherits Layer
|
|
*
|
|
* Generic class for handling a tiled grid of HTML elements. This is the base class for all tile layers and replaces `TileLayer.Canvas`.
|
|
* GridLayer can be extended to create a tiled grid of HTML elements like `<canvas>`, `<img>` or `<div>`. GridLayer will handle creating and animating these DOM elements for you.
|
|
*
|
|
*
|
|
* @section Synchronous usage
|
|
* @example
|
|
*
|
|
* To create a custom layer, extend GridLayer and implement the `createTile()` method, which will be passed a `Point` object with the `x`, `y`, and `z` (zoom level) coordinates to draw your tile.
|
|
*
|
|
* ```js
|
|
* class CanvasLayer extends GridLayer {
|
|
* createTile(coords) {
|
|
* // create a <canvas> element for drawing
|
|
* const tile = DomUtil.create('canvas', 'leaflet-tile');
|
|
*
|
|
* // setup tile width and height according to the options
|
|
* const size = this.getTileSize();
|
|
* tile.width = size.x;
|
|
* tile.height = size.y;
|
|
*
|
|
* // get a canvas context and draw something on it using coords.x, coords.y and coords.z
|
|
* const ctx = tile.getContext('2d');
|
|
*
|
|
* // return the tile so it can be rendered on screen
|
|
* return tile;
|
|
* }
|
|
* }
|
|
* ```
|
|
*
|
|
* @section Asynchronous usage
|
|
* @example
|
|
*
|
|
* Tile creation can also be asynchronous, this is useful when using a third-party drawing library. Once the tile is finished drawing it can be passed to the `done()` callback.
|
|
*
|
|
* ```js
|
|
* class CanvasLayer extends GridLayer {
|
|
* createTile(coords, done) {
|
|
* const error;
|
|
*
|
|
* // create a <canvas> element for drawing
|
|
* const tile = DomUtil.create('canvas', 'leaflet-tile');
|
|
*
|
|
* // setup tile width and height according to the options
|
|
* const size = this.getTileSize();
|
|
* tile.width = size.x;
|
|
* tile.height = size.y;
|
|
*
|
|
* // draw something asynchronously and pass the tile to the done() callback
|
|
* setTimeout(function() {
|
|
* done(error, tile);
|
|
* }, 1000);
|
|
*
|
|
* return tile;
|
|
* }
|
|
* }
|
|
* ```
|
|
*
|
|
* @section
|
|
*/
|
|
|
|
|
|
// @constructor GridLayer(options?: GridLayer options)
|
|
// Creates a new instance of GridLayer with the supplied options.
|
|
class GridLayer extends Layer {
|
|
|
|
static {
|
|
// @section
|
|
// @aka GridLayer options
|
|
this.setDefaultOptions({
|
|
// @option tileSize: Number|Point = 256
|
|
// Width and height of tiles in the grid. Use a number if width and height are equal, or `Point(width, height)` otherwise.
|
|
tileSize: 256,
|
|
|
|
// @option opacity: Number = 1.0
|
|
// Opacity of the tiles. Can be used in the `createTile()` function.
|
|
opacity: 1,
|
|
|
|
// @option updateWhenIdle: Boolean = (depends)
|
|
// Load new tiles only when panning ends.
|
|
// `true` by default on mobile browsers, in order to avoid too many requests and keep smooth navigation.
|
|
// `false` otherwise in order to display new tiles _during_ panning, since it is easy to pan outside the
|
|
// [`keepBuffer`](#gridlayer-keepbuffer) option in desktop browsers.
|
|
updateWhenIdle: Browser.mobile,
|
|
|
|
// @option updateWhenZooming: Boolean = true
|
|
// By default, a smooth zoom animation (during a [pinch zoom](#map-pinchzoom) or a [`flyTo()`](#map-flyto)) will update grid layers every integer zoom level. Setting this option to `false` will update the grid layer only when the smooth animation ends.
|
|
updateWhenZooming: true,
|
|
|
|
// @option updateInterval: Number = 200
|
|
// Tiles will not update more than once every `updateInterval` milliseconds when panning.
|
|
updateInterval: 200,
|
|
|
|
// @option zIndex: Number = 1
|
|
// The explicit zIndex of the tile layer.
|
|
zIndex: 1,
|
|
|
|
// @option bounds: LatLngBounds = undefined
|
|
// If set, tiles will only be loaded inside the set `LatLngBounds`.
|
|
bounds: null,
|
|
|
|
// @option minZoom: Number = 0
|
|
// The minimum zoom level down to which this layer will be displayed (inclusive).
|
|
minZoom: 0,
|
|
|
|
// @option maxZoom: Number = undefined
|
|
// The maximum zoom level up to which this layer will be displayed (inclusive).
|
|
maxZoom: undefined,
|
|
|
|
// @option maxNativeZoom: Number = undefined
|
|
// Maximum zoom number the tile source has available. If it is specified,
|
|
// the tiles on all zoom levels higher than `maxNativeZoom` will be loaded
|
|
// from `maxNativeZoom` level and auto-scaled.
|
|
maxNativeZoom: undefined,
|
|
|
|
// @option minNativeZoom: Number = undefined
|
|
// Minimum zoom number the tile source has available. If it is specified,
|
|
// the tiles on all zoom levels lower than `minNativeZoom` will be loaded
|
|
// from `minNativeZoom` level and auto-scaled.
|
|
minNativeZoom: undefined,
|
|
|
|
// @option noWrap: Boolean = false
|
|
// Whether the layer is wrapped around the antimeridian. If `true`, the
|
|
// GridLayer will only be displayed once at low zoom levels. Has no
|
|
// effect when the [map CRS](#map-crs) doesn't wrap around. Can be used
|
|
// in combination with [`bounds`](#gridlayer-bounds) to prevent requesting
|
|
// tiles outside the CRS limits.
|
|
noWrap: false,
|
|
|
|
// @option pane: String = 'tilePane'
|
|
// `Map pane` where the grid layer will be added.
|
|
pane: 'tilePane',
|
|
|
|
// @option className: String = ''
|
|
// A custom class name to assign to the tile layer. Empty by default.
|
|
className: '',
|
|
|
|
// @option keepBuffer: Number = 2
|
|
// When panning the map, keep this many rows and columns of tiles before unloading them.
|
|
keepBuffer: 2
|
|
});
|
|
}
|
|
|
|
initialize(options) {
|
|
setOptions(this, options);
|
|
}
|
|
|
|
onAdd() {
|
|
this._initContainer();
|
|
|
|
this._levels = {};
|
|
this._tiles = {};
|
|
|
|
this._resetView(); // implicit _update() call
|
|
}
|
|
|
|
beforeAdd(map) {
|
|
map._addZoomLimit(this);
|
|
}
|
|
|
|
onRemove(map) {
|
|
this._removeAllTiles();
|
|
this._container.remove();
|
|
map._removeZoomLimit(this);
|
|
this._container = null;
|
|
this._tileZoom = undefined;
|
|
clearTimeout(this._pruneTimeout);
|
|
}
|
|
|
|
// @method bringToFront: this
|
|
// Brings the tile layer to the top of all tile layers.
|
|
bringToFront() {
|
|
if (this._map) {
|
|
toFront(this._container);
|
|
this._setAutoZIndex(Math.max);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method bringToBack: this
|
|
// Brings the tile layer to the bottom of all tile layers.
|
|
bringToBack() {
|
|
if (this._map) {
|
|
toBack(this._container);
|
|
this._setAutoZIndex(Math.min);
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method getContainer: HTMLElement
|
|
// Returns the HTML element that contains the tiles for this layer.
|
|
getContainer() {
|
|
return this._container;
|
|
}
|
|
|
|
// @method setOpacity(opacity: Number): this
|
|
// Changes the [opacity](#gridlayer-opacity) of the grid layer.
|
|
setOpacity(opacity) {
|
|
this.options.opacity = opacity;
|
|
this._updateOpacity();
|
|
return this;
|
|
}
|
|
|
|
// @method setZIndex(zIndex: Number): this
|
|
// Changes the [zIndex](#gridlayer-zindex) of the grid layer.
|
|
setZIndex(zIndex) {
|
|
this.options.zIndex = zIndex;
|
|
this._updateZIndex();
|
|
|
|
return this;
|
|
}
|
|
|
|
// @method isLoading: Boolean
|
|
// Returns `true` if any tile in the grid layer has not finished loading.
|
|
isLoading() {
|
|
return this._loading;
|
|
}
|
|
|
|
// @method redraw: this
|
|
// Causes the layer to clear all the tiles and request them again.
|
|
redraw() {
|
|
if (this._map) {
|
|
this._removeAllTiles();
|
|
const tileZoom = this._clampZoom(this._map.getZoom());
|
|
if (tileZoom !== this._tileZoom) {
|
|
this._tileZoom = tileZoom;
|
|
this._updateLevels();
|
|
}
|
|
this._update();
|
|
}
|
|
return this;
|
|
}
|
|
|
|
getEvents() {
|
|
const events = {
|
|
viewprereset: this._invalidateAll,
|
|
viewreset: this._resetView,
|
|
zoom: this._resetView,
|
|
moveend: this._onMoveEnd
|
|
};
|
|
|
|
if (!this.options.updateWhenIdle) {
|
|
// update tiles on move, but not more often than once per given interval
|
|
if (!this._onMove) {
|
|
this._onMove = throttle(this._onMoveEnd, this.options.updateInterval, this);
|
|
}
|
|
|
|
events.move = this._onMove;
|
|
}
|
|
|
|
if (this._zoomAnimated) {
|
|
events.zoomanim = this._animateZoom;
|
|
}
|
|
|
|
return events;
|
|
}
|
|
|
|
// @section Extension methods
|
|
// Layers extending `GridLayer` shall reimplement the following method.
|
|
// @method createTile(coords: Object, done?: Function): HTMLElement
|
|
// Called only internally, must be overridden by classes extending `GridLayer`.
|
|
// Returns the `HTMLElement` corresponding to the given `coords`. If the `done` callback
|
|
// is specified, it must be called when the tile has finished loading and drawing.
|
|
createTile() {
|
|
return document.createElement('div');
|
|
}
|
|
|
|
// @section
|
|
// @method getTileSize: Point
|
|
// Normalizes the [tileSize option](#gridlayer-tilesize) into a point. Used by the `createTile()` method.
|
|
getTileSize() {
|
|
const s = this.options.tileSize;
|
|
return s instanceof Point ? s : new Point(s, s);
|
|
}
|
|
|
|
_updateZIndex() {
|
|
if (this._container && this.options.zIndex !== undefined && this.options.zIndex !== null) {
|
|
this._container.style.zIndex = this.options.zIndex;
|
|
}
|
|
}
|
|
|
|
_setAutoZIndex(compare) {
|
|
// go through all other layers of the same pane, set zIndex to max + 1 (front) or min - 1 (back)
|
|
|
|
const layers = this.getPane().children;
|
|
let edgeZIndex = -compare(-Infinity, Infinity); // -Infinity for max, Infinity for min
|
|
|
|
for (const layer of layers) {
|
|
const zIndex = layer.style.zIndex;
|
|
|
|
if (layer !== this._container && zIndex) {
|
|
edgeZIndex = compare(edgeZIndex, +zIndex);
|
|
}
|
|
}
|
|
|
|
if (isFinite(edgeZIndex)) {
|
|
this.options.zIndex = edgeZIndex + compare(-1, 1);
|
|
this._updateZIndex();
|
|
}
|
|
}
|
|
|
|
_updateOpacity() {
|
|
if (!this._map) { return; }
|
|
|
|
this._container.style.opacity = this.options.opacity;
|
|
|
|
const now = +new Date();
|
|
let nextFrame = false,
|
|
willPrune = false;
|
|
|
|
for (const tile of Object.values(this._tiles ?? {})) {
|
|
if (!tile.current || !tile.loaded) { continue; }
|
|
|
|
const fade = Math.min(1, (now - tile.loaded) / 200);
|
|
|
|
tile.el.style.opacity = fade;
|
|
if (fade < 1) {
|
|
nextFrame = true;
|
|
} else {
|
|
if (tile.active) {
|
|
willPrune = true;
|
|
} else {
|
|
this._onOpaqueTile(tile);
|
|
}
|
|
tile.active = true;
|
|
}
|
|
}
|
|
|
|
if (willPrune && !this._noPrune) { this._pruneTiles(); }
|
|
|
|
if (nextFrame) {
|
|
cancelAnimationFrame(this._fadeFrame);
|
|
this._fadeFrame = requestAnimationFrame(this._updateOpacity.bind(this));
|
|
}
|
|
}
|
|
|
|
_onOpaqueTile() {}
|
|
|
|
_initContainer() {
|
|
if (this._container) { return; }
|
|
|
|
this._container = create$1('div', `leaflet-layer ${this.options.className ?? ''}`);
|
|
this._updateZIndex();
|
|
|
|
if (this.options.opacity < 1) {
|
|
this._updateOpacity();
|
|
}
|
|
|
|
this.getPane().appendChild(this._container);
|
|
}
|
|
|
|
_updateLevels() {
|
|
|
|
const zoom = this._tileZoom,
|
|
maxZoom = this.options.maxZoom;
|
|
|
|
if (zoom === undefined) { return undefined; }
|
|
|
|
for (let z of Object.keys(this._levels)) {
|
|
z = Number(z);
|
|
if (this._levels[z].el.children.length || z === zoom) {
|
|
this._levels[z].el.style.zIndex = maxZoom - Math.abs(zoom - z);
|
|
this._onUpdateLevel(z);
|
|
} else {
|
|
this._levels[z].el.remove();
|
|
this._removeTilesAtZoom(z);
|
|
this._onRemoveLevel(z);
|
|
delete this._levels[z];
|
|
}
|
|
}
|
|
|
|
let level = this._levels[zoom];
|
|
const map = this._map;
|
|
|
|
if (!level) {
|
|
level = this._levels[zoom] = {};
|
|
|
|
level.el = create$1('div', 'leaflet-tile-container leaflet-zoom-animated', this._container);
|
|
level.el.style.zIndex = maxZoom;
|
|
|
|
level.origin = map.project(map.unproject(map.getPixelOrigin()), zoom).round();
|
|
level.zoom = zoom;
|
|
|
|
this._setZoomTransform(level, map.getCenter(), map.getZoom());
|
|
|
|
// force reading offsetWidth so the browser considers the newly added element for transition
|
|
falseFn(level.el.offsetWidth);
|
|
|
|
this._onCreateLevel(level);
|
|
}
|
|
|
|
this._level = level;
|
|
|
|
return level;
|
|
}
|
|
|
|
_onUpdateLevel() {}
|
|
|
|
_onRemoveLevel() {}
|
|
|
|
_onCreateLevel() {}
|
|
|
|
_pruneTiles() {
|
|
if (!this._map) {
|
|
return;
|
|
}
|
|
|
|
const zoom = this._map.getZoom();
|
|
if (zoom > this.options.maxZoom ||
|
|
zoom < this.options.minZoom) {
|
|
this._removeAllTiles();
|
|
return;
|
|
}
|
|
|
|
for (const tile of Object.values(this._tiles)) {
|
|
tile.retain = tile.current;
|
|
}
|
|
|
|
for (const tile of Object.values(this._tiles)) {
|
|
if (tile.current && !tile.active) {
|
|
const coords = tile.coords;
|
|
if (!this._retainParent(coords.x, coords.y, coords.z, coords.z - 5)) {
|
|
this._retainChildren(coords.x, coords.y, coords.z, coords.z + 2);
|
|
}
|
|
}
|
|
}
|
|
|
|
for (const [key, tile] of Object.entries(this._tiles)) {
|
|
if (!tile.retain) {
|
|
this._removeTile(key);
|
|
}
|
|
}
|
|
}
|
|
|
|
_removeTilesAtZoom(zoom) {
|
|
for (const [key, tile] of Object.entries(this._tiles)) {
|
|
if (tile.coords.z === zoom) {
|
|
this._removeTile(key);
|
|
}
|
|
}
|
|
}
|
|
|
|
_removeAllTiles() {
|
|
for (const key of Object.keys(this._tiles)) {
|
|
this._removeTile(key);
|
|
}
|
|
}
|
|
|
|
_invalidateAll() {
|
|
for (const z of Object.keys(this._levels)) {
|
|
this._levels[z].el.remove();
|
|
this._onRemoveLevel(Number(z));
|
|
delete this._levels[z];
|
|
}
|
|
this._removeAllTiles();
|
|
|
|
this._tileZoom = undefined;
|
|
}
|
|
|
|
_retainParent(x, y, z, minZoom) {
|
|
const x2 = Math.floor(x / 2),
|
|
y2 = Math.floor(y / 2),
|
|
z2 = z - 1,
|
|
coords2 = new Point(+x2, +y2);
|
|
coords2.z = +z2;
|
|
|
|
const key = this._tileCoordsToKey(coords2),
|
|
tile = this._tiles[key];
|
|
|
|
if (tile?.active) {
|
|
tile.retain = true;
|
|
return true;
|
|
|
|
} else if (tile?.loaded) {
|
|
tile.retain = true;
|
|
}
|
|
|
|
if (z2 > minZoom) {
|
|
return this._retainParent(x2, y2, z2, minZoom);
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
_retainChildren(x, y, z, maxZoom) {
|
|
|
|
for (let i = 2 * x; i < 2 * x + 2; i++) {
|
|
for (let j = 2 * y; j < 2 * y + 2; j++) {
|
|
|
|
const coords = new Point(i, j);
|
|
coords.z = z + 1;
|
|
|
|
const key = this._tileCoordsToKey(coords),
|
|
tile = this._tiles[key];
|
|
|
|
if (tile?.active) {
|
|
tile.retain = true;
|
|
continue;
|
|
|
|
} else if (tile?.loaded) {
|
|
tile.retain = true;
|
|
}
|
|
|
|
if (z + 1 < maxZoom) {
|
|
this._retainChildren(i, j, z + 1, maxZoom);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
_resetView(e) {
|
|
const animating = e && (e.pinch || e.flyTo);
|
|
this._setView(this._map.getCenter(), this._map.getZoom(), animating, animating);
|
|
}
|
|
|
|
_animateZoom(e) {
|
|
this._setView(e.center, e.zoom, true, e.noUpdate);
|
|
}
|
|
|
|
_clampZoom(zoom) {
|
|
const options = this.options;
|
|
|
|
if (undefined !== options.minNativeZoom && zoom < options.minNativeZoom) {
|
|
return options.minNativeZoom;
|
|
}
|
|
|
|
if (undefined !== options.maxNativeZoom && options.maxNativeZoom < zoom) {
|
|
return options.maxNativeZoom;
|
|
}
|
|
|
|
return zoom;
|
|
}
|
|
|
|
_setView(center, zoom, noPrune, noUpdate) {
|
|
let tileZoom = Math.round(zoom);
|
|
if ((this.options.maxZoom !== undefined && tileZoom > this.options.maxZoom) ||
|
|
(this.options.minZoom !== undefined && tileZoom < this.options.minZoom)) {
|
|
tileZoom = undefined;
|
|
} else {
|
|
tileZoom = this._clampZoom(tileZoom);
|
|
}
|
|
|
|
const tileZoomChanged = this.options.updateWhenZooming && (tileZoom !== this._tileZoom);
|
|
|
|
if (!noUpdate || tileZoomChanged) {
|
|
|
|
this._tileZoom = tileZoom;
|
|
|
|
if (this._abortLoading) {
|
|
this._abortLoading();
|
|
}
|
|
|
|
this._updateLevels();
|
|
this._resetGrid();
|
|
|
|
if (tileZoom !== undefined) {
|
|
this._update(center);
|
|
}
|
|
|
|
if (!noPrune) {
|
|
this._pruneTiles();
|
|
}
|
|
|
|
// Flag to prevent _updateOpacity from pruning tiles during
|
|
// a zoom anim or a pinch gesture
|
|
this._noPrune = !!noPrune;
|
|
}
|
|
|
|
this._setZoomTransforms(center, zoom);
|
|
}
|
|
|
|
_setZoomTransforms(center, zoom) {
|
|
for (const level of Object.values(this._levels)) {
|
|
this._setZoomTransform(level, center, zoom);
|
|
}
|
|
}
|
|
|
|
_setZoomTransform(level, center, zoom) {
|
|
const scale = this._map.getZoomScale(zoom, level.zoom),
|
|
translate = level.origin.multiplyBy(scale)
|
|
.subtract(this._map._getNewPixelOrigin(center, zoom)).round();
|
|
|
|
setTransform(level.el, translate, scale);
|
|
}
|
|
|
|
_resetGrid() {
|
|
const map = this._map,
|
|
crs = map.options.crs,
|
|
tileSize = this._tileSize = this.getTileSize(),
|
|
tileZoom = this._tileZoom;
|
|
|
|
const bounds = this._map.getPixelWorldBounds(this._tileZoom);
|
|
if (bounds) {
|
|
this._globalTileRange = this._pxBoundsToTileRange(bounds);
|
|
}
|
|
|
|
this._wrapX = crs.wrapLng && !this.options.noWrap && [
|
|
Math.floor(map.project([0, crs.wrapLng[0]], tileZoom).x / tileSize.x),
|
|
Math.ceil(map.project([0, crs.wrapLng[1]], tileZoom).x / tileSize.y)
|
|
];
|
|
this._wrapY = crs.wrapLat && !this.options.noWrap && [
|
|
Math.floor(map.project([crs.wrapLat[0], 0], tileZoom).y / tileSize.x),
|
|
Math.ceil(map.project([crs.wrapLat[1], 0], tileZoom).y / tileSize.y)
|
|
];
|
|
}
|
|
|
|
_onMoveEnd() {
|
|
if (!this._map || this._map._animatingZoom) { return; }
|
|
|
|
this._update();
|
|
}
|
|
|
|
_getTiledPixelBounds(center) {
|
|
const map = this._map,
|
|
mapZoom = map._animatingZoom ? Math.max(map._animateToZoom, map.getZoom()) : map.getZoom(),
|
|
scale = map.getZoomScale(mapZoom, this._tileZoom),
|
|
pixelCenter = map.project(center, this._tileZoom).floor(),
|
|
halfSize = map.getSize().divideBy(scale * 2);
|
|
|
|
return new Bounds(pixelCenter.subtract(halfSize), pixelCenter.add(halfSize));
|
|
}
|
|
|
|
// Private method to load tiles in the grid's active zoom level according to map bounds
|
|
_update(center) {
|
|
const map = this._map;
|
|
if (!map) { return; }
|
|
const zoom = this._clampZoom(map.getZoom());
|
|
|
|
if (center === undefined) { center = map.getCenter(); }
|
|
if (this._tileZoom === undefined) { return; } // if out of minzoom/maxzoom
|
|
|
|
const pixelBounds = this._getTiledPixelBounds(center),
|
|
tileRange = this._pxBoundsToTileRange(pixelBounds),
|
|
tileCenter = tileRange.getCenter(),
|
|
queue = [],
|
|
margin = this.options.keepBuffer,
|
|
noPruneRange = new Bounds(tileRange.getBottomLeft().subtract([margin, -margin]),
|
|
tileRange.getTopRight().add([margin, -margin]));
|
|
|
|
// Sanity check: panic if the tile range contains Infinity somewhere.
|
|
if (!(isFinite(tileRange.min.x) &&
|
|
isFinite(tileRange.min.y) &&
|
|
isFinite(tileRange.max.x) &&
|
|
isFinite(tileRange.max.y))) { throw new Error('Attempted to load an infinite number of tiles'); }
|
|
|
|
for (const tile of Object.values(this._tiles)) {
|
|
const c = tile.coords;
|
|
if (c.z !== this._tileZoom || !noPruneRange.contains(new Point(c.x, c.y))) {
|
|
tile.current = false;
|
|
}
|
|
}
|
|
|
|
// _update just loads more tiles. If the tile zoom level differs too much
|
|
// from the map's, let _setView reset levels and prune old tiles.
|
|
if (Math.abs(zoom - this._tileZoom) > 1) { this._setView(center, zoom); return; }
|
|
|
|
// create a queue of coordinates to load tiles from
|
|
for (let j = tileRange.min.y; j <= tileRange.max.y; j++) {
|
|
for (let i = tileRange.min.x; i <= tileRange.max.x; i++) {
|
|
const coords = new Point(i, j);
|
|
coords.z = this._tileZoom;
|
|
|
|
if (!this._isValidTile(coords)) { continue; }
|
|
|
|
const tile = this._tiles[this._tileCoordsToKey(coords)];
|
|
if (tile) {
|
|
tile.current = true;
|
|
} else {
|
|
queue.push(coords);
|
|
}
|
|
}
|
|
}
|
|
|
|
// sort tile queue to load tiles in order of their distance to center
|
|
queue.sort((a, b) => a.distanceTo(tileCenter) - b.distanceTo(tileCenter));
|
|
|
|
if (queue.length !== 0) {
|
|
// if it's the first batch of tiles to load
|
|
if (!this._loading) {
|
|
this._loading = true;
|
|
// @event loading: Event
|
|
// Fired when the grid layer starts loading tiles.
|
|
this.fire('loading');
|
|
}
|
|
|
|
// create DOM fragment to append tiles in one batch
|
|
const fragment = document.createDocumentFragment();
|
|
|
|
for (const q of queue) {
|
|
this._addTile(q, fragment);
|
|
}
|
|
|
|
this._level.el.appendChild(fragment);
|
|
}
|
|
}
|
|
|
|
_isValidTile(coords) {
|
|
const crs = this._map.options.crs;
|
|
|
|
if (!crs.infinite) {
|
|
// don't load tile if it's out of bounds and not wrapped
|
|
const bounds = this._globalTileRange;
|
|
if ((!crs.wrapLng && (coords.x < bounds.min.x || coords.x > bounds.max.x)) ||
|
|
(!crs.wrapLat && (coords.y < bounds.min.y || coords.y > bounds.max.y))) { return false; }
|
|
}
|
|
|
|
if (!this.options.bounds) { return true; }
|
|
|
|
// don't load tile if it doesn't intersect the bounds in options
|
|
const tileBounds = this._tileCoordsToBounds(coords);
|
|
return new LatLngBounds(this.options.bounds).overlaps(tileBounds);
|
|
}
|
|
|
|
_keyToBounds(key) {
|
|
return this._tileCoordsToBounds(this._keyToTileCoords(key));
|
|
}
|
|
|
|
_tileCoordsToNwSe(coords) {
|
|
const map = this._map,
|
|
tileSize = this.getTileSize(),
|
|
nwPoint = coords.scaleBy(tileSize),
|
|
sePoint = nwPoint.add(tileSize),
|
|
nw = map.unproject(nwPoint, coords.z),
|
|
se = map.unproject(sePoint, coords.z);
|
|
return [nw, se];
|
|
}
|
|
|
|
// converts tile coordinates to its geographical bounds
|
|
_tileCoordsToBounds(coords) {
|
|
const bp = this._tileCoordsToNwSe(coords);
|
|
let bounds = new LatLngBounds(bp[0], bp[1]);
|
|
|
|
if (!this.options.noWrap) {
|
|
bounds = this._map.wrapLatLngBounds(bounds);
|
|
}
|
|
return bounds;
|
|
}
|
|
// converts tile coordinates to key for the tile cache
|
|
_tileCoordsToKey(coords) {
|
|
return `${coords.x}:${coords.y}:${coords.z}`;
|
|
}
|
|
|
|
// converts tile cache key to coordinates
|
|
_keyToTileCoords(key) {
|
|
const k = key.split(':'),
|
|
coords = new Point(+k[0], +k[1]);
|
|
coords.z = +k[2];
|
|
return coords;
|
|
}
|
|
|
|
_removeTile(key) {
|
|
const tile = this._tiles[key];
|
|
if (!tile) { return; }
|
|
|
|
tile.el.remove();
|
|
|
|
delete this._tiles[key];
|
|
|
|
// @event tileunload: TileEvent
|
|
// Fired when a tile is removed (e.g. when a tile goes off the screen).
|
|
this.fire('tileunload', {
|
|
tile: tile.el,
|
|
coords: this._keyToTileCoords(key)
|
|
});
|
|
}
|
|
|
|
_initTile(tile) {
|
|
tile.classList.add('leaflet-tile');
|
|
|
|
const tileSize = this.getTileSize();
|
|
tile.style.width = `${tileSize.x}px`;
|
|
tile.style.height = `${tileSize.y}px`;
|
|
|
|
tile.onselectstart = falseFn;
|
|
tile.onpointermove = falseFn;
|
|
}
|
|
|
|
_addTile(coords, container) {
|
|
const tilePos = this._getTilePos(coords),
|
|
key = this._tileCoordsToKey(coords);
|
|
|
|
const tile = this.createTile(this._wrapCoords(coords), this._tileReady.bind(this, coords));
|
|
|
|
this._initTile(tile);
|
|
|
|
// if createTile is defined with a second argument ("done" callback),
|
|
// we know that tile is async and will be ready later; otherwise
|
|
if (this.createTile.length < 2) {
|
|
// mark tile as ready, but delay one frame for opacity animation to happen
|
|
requestAnimationFrame(this._tileReady.bind(this, coords, null, tile));
|
|
}
|
|
|
|
setPosition(tile, tilePos);
|
|
|
|
// save tile in cache
|
|
this._tiles[key] = {
|
|
el: tile,
|
|
coords,
|
|
current: true
|
|
};
|
|
|
|
container.appendChild(tile);
|
|
// @event tileloadstart: TileEvent
|
|
// Fired when a tile is requested and starts loading.
|
|
this.fire('tileloadstart', {
|
|
tile,
|
|
coords
|
|
});
|
|
}
|
|
|
|
_tileReady(coords, err, tile) {
|
|
if (err) {
|
|
// @event tileerror: TileErrorEvent
|
|
// Fired when there is an error loading a tile.
|
|
this.fire('tileerror', {
|
|
error: err,
|
|
tile,
|
|
coords
|
|
});
|
|
}
|
|
|
|
const key = this._tileCoordsToKey(coords);
|
|
|
|
tile = this._tiles[key];
|
|
if (!tile) { return; }
|
|
|
|
tile.loaded = +new Date();
|
|
if (this._map._fadeAnimated) {
|
|
tile.el.style.opacity = 0;
|
|
cancelAnimationFrame(this._fadeFrame);
|
|
this._fadeFrame = requestAnimationFrame(this._updateOpacity.bind(this));
|
|
} else {
|
|
tile.active = true;
|
|
this._pruneTiles();
|
|
}
|
|
|
|
if (!err) {
|
|
tile.el.classList.add('leaflet-tile-loaded');
|
|
|
|
// @event tileload: TileEvent
|
|
// Fired when a tile loads.
|
|
this.fire('tileload', {
|
|
tile: tile.el,
|
|
coords
|
|
});
|
|
}
|
|
|
|
if (this._noTilesToLoad()) {
|
|
this._loading = false;
|
|
// @event load: Event
|
|
// Fired when the grid layer loaded all visible tiles.
|
|
this.fire('load');
|
|
|
|
if (!this._map._fadeAnimated) {
|
|
requestAnimationFrame(this._pruneTiles.bind(this));
|
|
} else {
|
|
// Wait a bit more than 0.2 secs (the duration of the tile fade-in)
|
|
// to trigger a pruning.
|
|
this._pruneTimeout = setTimeout(this._pruneTiles.bind(this), 250);
|
|
}
|
|
}
|
|
}
|
|
|
|
_getTilePos(coords) {
|
|
return coords.scaleBy(this.getTileSize()).subtract(this._level.origin);
|
|
}
|
|
|
|
_wrapCoords(coords) {
|
|
const newCoords = new Point(
|
|
this._wrapX ? wrapNum(coords.x, this._wrapX) : coords.x,
|
|
this._wrapY ? wrapNum(coords.y, this._wrapY) : coords.y);
|
|
newCoords.z = coords.z;
|
|
return newCoords;
|
|
}
|
|
|
|
_pxBoundsToTileRange(bounds) {
|
|
const tileSize = this.getTileSize();
|
|
return new Bounds(
|
|
bounds.min.unscaleBy(tileSize).floor(),
|
|
bounds.max.unscaleBy(tileSize).ceil().subtract([1, 1]));
|
|
}
|
|
|
|
_noTilesToLoad() {
|
|
return Object.values(this._tiles).every(t => t.loaded);
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class TileLayer
|
|
* @inherits GridLayer
|
|
* Used to load and display tile layers on the map. Note that most tile servers require attribution, which you can set under `Layer`. Extends `GridLayer`.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* new TileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png?{foo}', {foo: 'bar', attribution: '© <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors'}).addTo(map);
|
|
* ```
|
|
*
|
|
* @section URL template
|
|
* @example
|
|
*
|
|
* A string of the following form:
|
|
*
|
|
* ```
|
|
* 'https://{s}.somedomain.com/blabla/{z}/{x}/{y}{r}.png'
|
|
* ```
|
|
*
|
|
* `{s}` means one of the available subdomains (used sequentially to help with browser parallel requests per domain limitation; subdomain values are specified in options; `a`, `b` or `c` by default, can be omitted), `{z}` — zoom level, `{x}` and `{y}` — tile coordinates. `{r}` can be used to add "@2x" to the URL to load retina tiles.
|
|
*
|
|
* You can use custom keys in the template, which will be [evaluated](#util-template) from TileLayer options, like this:
|
|
*
|
|
* ```
|
|
* new TileLayer('https://{s}.somedomain.com/{foo}/{z}/{x}/{y}.png', {foo: 'bar'});
|
|
* ```
|
|
*/
|
|
|
|
// @constructor TileLayer(urlTemplate: String, options?: TileLayer options)
|
|
// Instantiates a tile layer object given a `URL template` and optionally an options object.
|
|
class TileLayer extends GridLayer {
|
|
|
|
static {
|
|
// @section
|
|
// @aka TileLayer options
|
|
this.setDefaultOptions({
|
|
// @option minZoom: Number = 0
|
|
// The minimum zoom level down to which this layer will be displayed (inclusive).
|
|
minZoom: 0,
|
|
|
|
// @option maxZoom: Number = 18
|
|
// The maximum zoom level up to which this layer will be displayed (inclusive).
|
|
maxZoom: 18,
|
|
|
|
// @option subdomains: String|String[] = 'abc'
|
|
// Subdomains of the tile service. Can be passed in the form of one string (where each letter is a subdomain name) or an array of strings.
|
|
subdomains: 'abc',
|
|
|
|
// @option errorTileUrl: String = ''
|
|
// URL to the tile image to show in place of the tile that failed to load.
|
|
errorTileUrl: '',
|
|
|
|
// @option zoomOffset: Number = 0
|
|
// The zoom number used in tile URLs will be offset with this value.
|
|
zoomOffset: 0,
|
|
|
|
// @option tms: Boolean = false
|
|
// If `true`, inverses Y axis numbering for tiles (turn this on for [TMS](https://en.wikipedia.org/wiki/Tile_Map_Service) services).
|
|
tms: false,
|
|
|
|
// @option zoomReverse: Boolean = false
|
|
// If set to true, the zoom number used in tile URLs will be reversed (`maxZoom - zoom` instead of `zoom`)
|
|
zoomReverse: false,
|
|
|
|
// @option detectRetina: Boolean = false
|
|
// If `true` and user is on a retina display, it will request four tiles of half the specified size and a bigger zoom level in place of one to utilize the high resolution.
|
|
detectRetina: false,
|
|
|
|
// @option crossOrigin: Boolean|String = false
|
|
// Whether the crossOrigin attribute will be added to the tiles.
|
|
// If a String is provided, all tiles will have their crossOrigin attribute set to the String provided. This is needed if you want to access tile pixel data.
|
|
// Refer to [CORS Settings](https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes) for valid String values.
|
|
crossOrigin: false,
|
|
|
|
// @option referrerPolicy: Boolean|String = false
|
|
// Whether the referrerPolicy attribute will be added to the tiles.
|
|
// If a String is provided, all tiles will have their referrerPolicy attribute set to the String provided.
|
|
// This may be needed if your map's rendering context has a strict default but your tile provider expects a valid referrer
|
|
// (e.g. to validate an API token).
|
|
// Refer to [HTMLImageElement.referrerPolicy](https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/referrerPolicy) for valid String values.
|
|
referrerPolicy: false
|
|
});
|
|
}
|
|
|
|
initialize(url, options) {
|
|
|
|
this._url = url;
|
|
|
|
options = setOptions(this, options);
|
|
|
|
// in case the attribution hasn't been specified, check for known hosts that require attribution
|
|
if (options.attribution === null && URL.canParse(url)) {
|
|
const urlHostname = new URL(url).hostname;
|
|
|
|
// check for Open Street Map hosts
|
|
const osmHosts = ['tile.openstreetmap.org', 'tile.osm.org'];
|
|
if (osmHosts.some(host => urlHostname.endsWith(host))) {
|
|
options.attribution = '© <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors';
|
|
}
|
|
}
|
|
|
|
// detecting retina displays, adjusting tileSize and zoom levels
|
|
if (options.detectRetina && Browser.retina && options.maxZoom > 0) {
|
|
|
|
options.tileSize = Math.floor(options.tileSize / 2);
|
|
|
|
if (!options.zoomReverse) {
|
|
options.zoomOffset++;
|
|
options.maxZoom = Math.max(options.minZoom, options.maxZoom - 1);
|
|
} else {
|
|
options.zoomOffset--;
|
|
options.minZoom = Math.min(options.maxZoom, options.minZoom + 1);
|
|
}
|
|
|
|
options.minZoom = Math.max(0, options.minZoom);
|
|
} else if (!options.zoomReverse) {
|
|
// make sure maxZoom is gte minZoom
|
|
options.maxZoom = Math.max(options.minZoom, options.maxZoom);
|
|
} else {
|
|
// make sure minZoom is lte maxZoom
|
|
options.minZoom = Math.min(options.maxZoom, options.minZoom);
|
|
}
|
|
|
|
if (typeof options.subdomains === 'string') {
|
|
options.subdomains = options.subdomains.split('');
|
|
}
|
|
|
|
this.on('tileunload', this._onTileRemove);
|
|
}
|
|
|
|
// @method setUrl(url: String, noRedraw?: Boolean): this
|
|
// Updates the layer's URL template and redraws it (unless `noRedraw` is set to `true`).
|
|
// If the URL does not change, the layer will not be redrawn unless
|
|
// the noRedraw parameter is set to false.
|
|
setUrl(url, noRedraw) {
|
|
if (this._url === url && noRedraw === undefined) {
|
|
noRedraw = true;
|
|
}
|
|
|
|
this._url = url;
|
|
|
|
if (!noRedraw) {
|
|
this.redraw();
|
|
}
|
|
return this;
|
|
}
|
|
|
|
// @method createTile(coords: Object, done?: Function): HTMLElement
|
|
// Called only internally, overrides GridLayer's [`createTile()`](#gridlayer-createtile)
|
|
// to return an `<img>` HTML element with the appropriate image URL given `coords`. The `done`
|
|
// callback is called when the tile has been loaded.
|
|
createTile(coords, done) {
|
|
const tile = document.createElement('img');
|
|
|
|
on(tile, 'load', this._tileOnLoad.bind(this, done, tile));
|
|
on(tile, 'error', this._tileOnError.bind(this, done, tile));
|
|
|
|
if (this.options.crossOrigin || this.options.crossOrigin === '') {
|
|
tile.crossOrigin = this.options.crossOrigin === true ? '' : this.options.crossOrigin;
|
|
}
|
|
|
|
// for this new option we follow the documented behavior
|
|
// more closely by only setting the property when string
|
|
if (typeof this.options.referrerPolicy === 'string') {
|
|
tile.referrerPolicy = this.options.referrerPolicy;
|
|
}
|
|
|
|
// The alt attribute is set to the empty string,
|
|
// allowing screen readers to ignore the decorative image tiles.
|
|
// https://www.w3.org/WAI/tutorials/images/decorative/
|
|
// https://www.w3.org/TR/html-aria/#el-img-empty-alt
|
|
tile.alt = '';
|
|
|
|
tile.src = this.getTileUrl(coords);
|
|
|
|
return tile;
|
|
}
|
|
|
|
// @section Extension methods
|
|
// @uninheritable
|
|
// Layers extending `TileLayer` might reimplement the following method.
|
|
// @method getTileUrl(coords: Object): String
|
|
// Called only internally, returns the URL for a tile given its coordinates.
|
|
// Classes extending `TileLayer` can override this function to provide custom tile URL naming schemes.
|
|
getTileUrl(coords) {
|
|
const data = Object.create(this.options);
|
|
Object.assign(data, {
|
|
r: Browser.retina ? '@2x' : '',
|
|
s: this._getSubdomain(coords),
|
|
x: coords.x,
|
|
y: coords.y,
|
|
z: this._getZoomForUrl()
|
|
});
|
|
if (this._map && !this._map.options.crs.infinite) {
|
|
const invertedY = this._globalTileRange.max.y - coords.y;
|
|
if (this.options.tms) {
|
|
data['y'] = invertedY;
|
|
}
|
|
data['-y'] = invertedY;
|
|
}
|
|
|
|
return template(this._url, data);
|
|
}
|
|
|
|
_tileOnLoad(done, tile) {
|
|
done(null, tile);
|
|
}
|
|
|
|
_tileOnError(done, tile, e) {
|
|
const errorUrl = this.options.errorTileUrl;
|
|
if (errorUrl && tile.getAttribute('src') !== errorUrl) {
|
|
tile.src = errorUrl;
|
|
}
|
|
done(e, tile);
|
|
}
|
|
|
|
_onTileRemove(e) {
|
|
e.tile.onload = null;
|
|
}
|
|
|
|
_getZoomForUrl() {
|
|
let zoom = this._tileZoom;
|
|
const maxZoom = this.options.maxZoom,
|
|
zoomReverse = this.options.zoomReverse,
|
|
zoomOffset = this.options.zoomOffset;
|
|
|
|
if (zoomReverse) {
|
|
zoom = maxZoom - zoom;
|
|
}
|
|
|
|
return zoom + zoomOffset;
|
|
}
|
|
|
|
_getSubdomain(tilePoint) {
|
|
const index = Math.abs(tilePoint.x + tilePoint.y) % this.options.subdomains.length;
|
|
return this.options.subdomains[index];
|
|
}
|
|
|
|
// stops loading all tiles in the background layer
|
|
_abortLoading() {
|
|
let i, tile;
|
|
for (i of Object.keys(this._tiles)) {
|
|
if (this._tiles[i].coords.z !== this._tileZoom) {
|
|
tile = this._tiles[i].el;
|
|
|
|
tile.onload = falseFn;
|
|
tile.onerror = falseFn;
|
|
|
|
if (!tile.complete) {
|
|
tile.src = emptyImageUrl;
|
|
const coords = this._tiles[i].coords;
|
|
tile.remove();
|
|
delete this._tiles[i];
|
|
// @event tileabort: TileEvent
|
|
// Fired when a tile was loading but is now not wanted.
|
|
this.fire('tileabort', {
|
|
tile,
|
|
coords
|
|
});
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
_removeTile(key) {
|
|
const tile = this._tiles[key];
|
|
if (!tile) { return; }
|
|
|
|
// Cancels any pending http requests associated with the tile
|
|
tile.el.setAttribute('src', emptyImageUrl);
|
|
|
|
return GridLayer.prototype._removeTile.call(this, key);
|
|
}
|
|
|
|
_tileReady(coords, err, tile) {
|
|
if (!this._map || (tile && tile.getAttribute('src') === emptyImageUrl)) {
|
|
return;
|
|
}
|
|
|
|
return GridLayer.prototype._tileReady.call(this, coords, err, tile);
|
|
}
|
|
|
|
_clampZoom(zoom) {
|
|
return Math.round(GridLayer.prototype._clampZoom.call(this, zoom));
|
|
}
|
|
}
|
|
|
|
/*
|
|
* @class TileLayer.WMS
|
|
* @inherits TileLayer
|
|
* Used to display [WMS](https://en.wikipedia.org/wiki/Web_Map_Service) services as tile layers on the map. Extends `TileLayer`.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* const nexrad = new TileLayer.wms("http://mesonet.agron.iastate.edu/cgi-bin/wms/nexrad/n0r.cgi", {
|
|
* layers: 'nexrad-n0r-900913',
|
|
* format: 'image/png',
|
|
* transparent: true,
|
|
* attribution: "Weather data © 2012 IEM Nexrad"
|
|
* });
|
|
* ```
|
|
*/
|
|
|
|
// @constructor TileLayer.WMS(baseUrl: String, options: TileLayer.WMS options)
|
|
// Instantiates a WMS tile layer object given a base URL of the WMS service and a WMS parameters/options object.
|
|
class TileLayerWMS extends TileLayer {
|
|
|
|
static {
|
|
// @section
|
|
// @aka TileLayer.WMS options
|
|
// If any custom options not documented here are used, they will be sent to the
|
|
// WMS server as extra parameters in each request URL. This can be useful for
|
|
// [non-standard vendor WMS parameters](https://docs.geoserver.org/stable/en/user/services/wms/vendor.html).
|
|
this.prototype.defaultWmsParams = {
|
|
service: 'WMS',
|
|
request: 'GetMap',
|
|
|
|
// @option layers: String = ''
|
|
// **(required)** Comma-separated list of WMS layers to show.
|
|
layers: '',
|
|
|
|
// @option styles: String = ''
|
|
// Comma-separated list of WMS styles.
|
|
styles: '',
|
|
|
|
// @option format: String = 'image/jpeg'
|
|
// WMS image format (use `'image/png'` for layers with transparency).
|
|
format: 'image/jpeg',
|
|
|
|
// @option transparent: Boolean = false
|
|
// If `true`, the WMS service will return images with transparency.
|
|
transparent: false,
|
|
|
|
// @option version: String = '1.1.1'
|
|
// Version of the WMS service to use
|
|
version: '1.1.1'
|
|
};
|
|
|
|
this.setDefaultOptions({
|
|
// @option crs: CRS = null
|
|
// Coordinate Reference System to use for the WMS requests, defaults to
|
|
// map CRS. Don't change this if you're not sure what it means.
|
|
crs: null,
|
|
|
|
// @option uppercase: Boolean = false
|
|
// If `true`, WMS request parameter keys will be uppercase.
|
|
uppercase: false
|
|
});
|
|
}
|
|
|
|
initialize(url, options) {
|
|
|
|
this._url = url;
|
|
|
|
const wmsParams = {...this.defaultWmsParams};
|
|
|
|
// all keys that are not TileLayer options go to WMS params
|
|
for (const i of Object.keys(options)) {
|
|
if (!(i in this.options)) { // do not use Object.keys here, as it excludes options inherited from TileLayer
|
|
wmsParams[i] = options[i];
|
|
}
|
|
}
|
|
|
|
options = setOptions(this, options);
|
|
|
|
const realRetina = options.detectRetina && Browser.retina ? 2 : 1;
|
|
const tileSize = this.getTileSize();
|
|
wmsParams.width = tileSize.x * realRetina;
|
|
wmsParams.height = tileSize.y * realRetina;
|
|
|
|
this.wmsParams = wmsParams;
|
|
}
|
|
|
|
onAdd(map) {
|
|
|
|
this._crs = this.options.crs ?? map.options.crs;
|
|
this._wmsVersion = parseFloat(this.wmsParams.version);
|
|
|
|
const projectionKey = this._wmsVersion >= 1.3 ? 'crs' : 'srs';
|
|
this.wmsParams[projectionKey] = this._crs.code;
|
|
|
|
TileLayer.prototype.onAdd.call(this, map);
|
|
}
|
|
|
|
getTileUrl(coords) {
|
|
|
|
const tileBounds = this._tileCoordsToNwSe(coords),
|
|
crs = this._crs,
|
|
bounds = new Bounds(crs.project(tileBounds[0]), crs.project(tileBounds[1])),
|
|
min = bounds.min,
|
|
max = bounds.max,
|
|
bbox = (this._wmsVersion >= 1.3 && this._crs === EPSG4326 ?
|
|
[min.y, min.x, max.y, max.x] :
|
|
[min.x, min.y, max.x, max.y]).join(',');
|
|
const url = new URL(TileLayer.prototype.getTileUrl.call(this, coords));
|
|
for (const [k, v] of Object.entries({...this.wmsParams, bbox})) {
|
|
url.searchParams.append(this.options.uppercase ? k.toUpperCase() : k, v);
|
|
}
|
|
return url.toString();
|
|
}
|
|
|
|
// @method setParams(params: Object, noRedraw?: Boolean): this
|
|
// Merges an object with the new parameters and re-requests tiles on the current screen (unless `noRedraw` was set to true).
|
|
setParams(params, noRedraw) {
|
|
|
|
Object.assign(this.wmsParams, params);
|
|
|
|
if (!noRedraw) {
|
|
this.redraw();
|
|
}
|
|
|
|
return this;
|
|
}
|
|
}
|
|
|
|
TileLayer.WMS = TileLayerWMS;
|
|
|
|
/*
|
|
* @class Renderer
|
|
* @inherits BlanketOverlay
|
|
*
|
|
* Base class for vector renderer implementations (`SVG`, `Canvas`). Handles the
|
|
* DOM container of the renderer, its bounds, and its zoom animation.
|
|
*
|
|
* A `Renderer` works as an implicit layer group for all `Path`s - the renderer
|
|
* itself can be added or removed to the map. All paths use a renderer, which can
|
|
* be implicit (the map will decide the type of renderer and use it automatically)
|
|
* or explicit (using the [`renderer`](#path-renderer) option of the path).
|
|
*
|
|
* Do not use this class directly, use `SVG` and `Canvas` instead.
|
|
*
|
|
* The `continuous` option inherited from `BlanketOverlay` cannot be set to `true`
|
|
* (otherwise, renderers get out of place during a pinch-zoom operation).
|
|
*
|
|
* @event update: Event
|
|
* Fired when the renderer updates its bounds, center and zoom, for example when
|
|
* its map has moved
|
|
*/
|
|
|
|
class Renderer extends BlanketOverlay {
|
|
|
|
initialize(options) {
|
|
setOptions(this, {...options, continuous: false});
|
|
stamp(this);
|
|
this._layers ??= {};
|
|
}
|
|
|
|
onAdd(map) {
|
|
super.onAdd(map);
|
|
this.on('update', this._updatePaths, this);
|
|
}
|
|
|
|
onRemove() {
|
|
super.onRemove();
|
|
this.off('update', this._updatePaths, this);
|
|
}
|
|
|
|
_onZoomEnd() {
|
|
// When a zoom ends, the "origin pixel" changes. Internal coordinates
|
|
// of paths are relative to the origin pixel and therefore need to
|
|
// be recalculated.
|
|
for (const layer of Object.values(this._layers)) {
|
|
layer._project();
|
|
}
|
|
}
|
|
|
|
_updatePaths() {
|
|
for (const layer of Object.values(this._layers)) {
|
|
layer._update();
|
|
}
|
|
}
|
|
|
|
_onViewReset() {
|
|
for (const layer of Object.values(this._layers)) {
|
|
layer._reset();
|
|
}
|
|
}
|
|
|
|
_onSettled() {
|
|
this._update();
|
|
}
|
|
|
|
// Subclasses are responsible of implementing `_update()`. It should fire
|
|
// the 'update' event whenever appropriate (before/after rendering).
|
|
_update() {}
|
|
|
|
}
|
|
|
|
/*
|
|
* @class Canvas
|
|
* @inherits Renderer
|
|
*
|
|
* Allows vector layers to be displayed with [`<canvas>`](https://developer.mozilla.org/docs/Web/API/Canvas_API).
|
|
* Inherits `Renderer`.
|
|
*
|
|
* @example
|
|
*
|
|
* Use Canvas by default for all paths in the map:
|
|
*
|
|
* ```js
|
|
* const map = new Map('map', {
|
|
* renderer: new Canvas()
|
|
* });
|
|
* ```
|
|
*
|
|
* Use a Canvas renderer with extra padding for specific vector geometries:
|
|
*
|
|
* ```js
|
|
* const map = new Map('map');
|
|
* const myRenderer = new Canvas({ padding: 0.5 });
|
|
* const line = new Polyline( coordinates, { renderer: myRenderer } );
|
|
* const circle = new Circle( center, { renderer: myRenderer, radius: 100 } );
|
|
* ```
|
|
*/
|
|
|
|
// @constructor Canvas(options?: Renderer options)
|
|
// Creates a Canvas renderer with the given options.
|
|
class Canvas extends Renderer {
|
|
|
|
static {
|
|
// @section
|
|
// @aka Canvas options
|
|
this.setDefaultOptions({
|
|
// @option tolerance: Number = 0
|
|
// How much to extend the click tolerance around a path/object on the map.
|
|
tolerance: 0
|
|
});
|
|
}
|
|
|
|
getEvents() {
|
|
const events = Renderer.prototype.getEvents.call(this);
|
|
events.viewprereset = this._onViewPreReset;
|
|
return events;
|
|
}
|
|
|
|
_onViewPreReset() {
|
|
// Set a flag so that a viewprereset+moveend+viewreset only updates&redraws once
|
|
this._postponeUpdatePaths = true;
|
|
}
|
|
|
|
onAdd(map) {
|
|
Renderer.prototype.onAdd.call(this, map);
|
|
|
|
// Redraw vectors since canvas is cleared upon removal,
|
|
// in case of removing the renderer itself from the map.
|
|
this._draw();
|
|
}
|
|
|
|
onRemove() {
|
|
Renderer.prototype.onRemove.call(this);
|
|
|
|
clearTimeout(this._pointerHoverThrottleTimeout);
|
|
}
|
|
|
|
_initContainer() {
|
|
const container = this._container = document.createElement('canvas');
|
|
|
|
on(container, 'pointermove', this._onPointerMove, this);
|
|
on(container, 'click dblclick pointerdown pointerup contextmenu', this._onClick, this);
|
|
on(container, 'pointerout', this._handlePointerOut, this);
|
|
container['_leaflet_disable_events'] = true;
|
|
|
|
this._ctx = container.getContext('2d');
|
|
}
|
|
|
|
_destroyContainer() {
|
|
cancelAnimationFrame(this._redrawRequest);
|
|
this._redrawRequest = null;
|
|
delete this._ctx;
|
|
Renderer.prototype._destroyContainer.call(this);
|
|
}
|
|
|
|
_resizeContainer() {
|
|
const size = Renderer.prototype._resizeContainer.call(this);
|
|
const m = this._ctxScale = window.devicePixelRatio;
|
|
|
|
// set canvas size (also clearing it); use double size on retina
|
|
this._container.width = m * size.x;
|
|
this._container.height = m * size.y;
|
|
}
|
|
|
|
_updatePaths() {
|
|
if (this._postponeUpdatePaths) { return; }
|
|
|
|
this._redrawBounds = null;
|
|
for (const layer of Object.values(this._layers)) {
|
|
layer._update();
|
|
}
|
|
this._redraw();
|
|
}
|
|
|
|
_update() {
|
|
if (this._map._animatingZoom && this._bounds) { return; }
|
|
|
|
const b = this._bounds,
|
|
s = this._ctxScale;
|
|
|
|
// translate so we use the same path coordinates after canvas element moves
|
|
this._ctx.setTransform(
|
|
s, 0, 0, s,
|
|
-b.min.x * s,
|
|
-b.min.y * s);
|
|
|
|
// Tell paths to redraw themselves
|
|
this.fire('update');
|
|
}
|
|
|
|
_reset() {
|
|
Renderer.prototype._reset.call(this);
|
|
|
|
if (this._postponeUpdatePaths) {
|
|
this._postponeUpdatePaths = false;
|
|
this._updatePaths();
|
|
}
|
|
}
|
|
|
|
_initPath(layer) {
|
|
this._updateDashArray(layer);
|
|
this._layers[stamp(layer)] = layer;
|
|
|
|
const order = layer._order = {
|
|
layer,
|
|
prev: this._drawLast,
|
|
next: null
|
|
};
|
|
if (this._drawLast) { this._drawLast.next = order; }
|
|
this._drawLast = order;
|
|
this._drawFirst ??= this._drawLast;
|
|
}
|
|
|
|
_addPath(layer) {
|
|
this._requestRedraw(layer);
|
|
}
|
|
|
|
_removePath(layer) {
|
|
const order = layer._order;
|
|
const next = order.next;
|
|
const prev = order.prev;
|
|
|
|
if (next) {
|
|
next.prev = prev;
|
|
} else {
|
|
this._drawLast = prev;
|
|
}
|
|
if (prev) {
|
|
prev.next = next;
|
|
} else {
|
|
this._drawFirst = next;
|
|
}
|
|
|
|
delete layer._order;
|
|
|
|
delete this._layers[stamp(layer)];
|
|
|
|
this._requestRedraw(layer);
|
|
}
|
|
|
|
_updatePath(layer) {
|
|
// Redraw the union of the layer's old pixel
|
|
// bounds and the new pixel bounds.
|
|
this._extendRedrawBounds(layer);
|
|
layer._project();
|
|
layer._update();
|
|
// The redraw will extend the redraw bounds
|
|
// with the new pixel bounds.
|
|
this._requestRedraw(layer);
|
|
}
|
|
|
|
_updateStyle(layer) {
|
|
this._updateDashArray(layer);
|
|
this._requestRedraw(layer);
|
|
}
|
|
|
|
_updateDashArray(layer) {
|
|
if (typeof layer.options.dashArray === 'string') {
|
|
const parts = layer.options.dashArray.split(/[, ]+/);
|
|
// Ignore dash array containing invalid lengths
|
|
layer.options._dashArray = parts.map(n => Number(n)).filter(n => !isNaN(n));
|
|
} else {
|
|
layer.options._dashArray = layer.options.dashArray;
|
|
}
|
|
}
|
|
|
|
_requestRedraw(layer) {
|
|
if (!this._map) { return; }
|
|
|
|
this._extendRedrawBounds(layer);
|
|
this._redrawRequest ??= requestAnimationFrame(this._redraw.bind(this));
|
|
}
|
|
|
|
_extendRedrawBounds(layer) {
|
|
if (layer._pxBounds) {
|
|
const padding = (layer.options.weight ?? 0) + 1;
|
|
this._redrawBounds ??= new Bounds();
|
|
this._redrawBounds.extend(layer._pxBounds.min.subtract([padding, padding]));
|
|
this._redrawBounds.extend(layer._pxBounds.max.add([padding, padding]));
|
|
}
|
|
}
|
|
|
|
_redraw() {
|
|
this._redrawRequest = null;
|
|
|
|
if (this._redrawBounds) {
|
|
this._redrawBounds.min._floor();
|
|
this._redrawBounds.max._ceil();
|
|
}
|
|
|
|
this._clear(); // clear layers in redraw bounds
|
|
this._draw(); // draw layers
|
|
|
|
this._redrawBounds = null;
|
|
}
|
|
|
|
_clear() {
|
|
const bounds = this._redrawBounds;
|
|
if (bounds) {
|
|
const size = bounds.getSize();
|
|
this._ctx.clearRect(bounds.min.x, bounds.min.y, size.x, size.y);
|
|
} else {
|
|
this._ctx.save();
|
|
this._ctx.setTransform(1, 0, 0, 1, 0, 0);
|
|
this._ctx.clearRect(0, 0, this._container.width, this._container.height);
|
|
this._ctx.restore();
|
|
}
|
|
}
|
|
|
|
_draw() {
|
|
let layer;
|
|
const bounds = this._redrawBounds;
|
|
this._ctx.save();
|
|
if (bounds) {
|
|
const size = bounds.getSize();
|
|
this._ctx.beginPath();
|
|
this._ctx.rect(bounds.min.x, bounds.min.y, size.x, size.y);
|
|
this._ctx.clip();
|
|
}
|
|
|
|
this._drawing = true;
|
|
|
|
for (let order = this._drawFirst; order; order = order.next) {
|
|
layer = order.layer;
|
|
if (!bounds || (layer._pxBounds && layer._pxBounds.intersects(bounds))) {
|
|
layer._updatePath();
|
|
}
|
|
}
|
|
|
|
this._drawing = false;
|
|
|
|
this._ctx.restore(); // Restore state before clipping.
|
|
}
|
|
|
|
_updatePoly(layer, closed) {
|
|
if (!this._drawing) { return; }
|
|
|
|
const parts = layer._parts,
|
|
ctx = this._ctx;
|
|
|
|
if (!parts.length) { return; }
|
|
|
|
ctx.beginPath();
|
|
|
|
parts.forEach((p0) => {
|
|
p0.forEach((p, j) => {
|
|
ctx[j ? 'lineTo' : 'moveTo'](p.x, p.y);
|
|
});
|
|
if (closed) {
|
|
ctx.closePath();
|
|
}
|
|
});
|
|
|
|
this._fillStroke(ctx, layer);
|
|
|
|
// TODO optimization: 1 fill/stroke for all features with equal style instead of 1 for each feature
|
|
}
|
|
|
|
_updateCircle(layer) {
|
|
|
|
if (!this._drawing || layer._empty()) { return; }
|
|
|
|
const p = layer._point,
|
|
ctx = this._ctx,
|
|
r = Math.max(Math.round(layer._radius), 1),
|
|
s = (Math.max(Math.round(layer._radiusY), 1) || r) / r;
|
|
|
|
if (s !== 1) {
|
|
ctx.save();
|
|
ctx.scale(1, s);
|
|
}
|
|
|
|
ctx.beginPath();
|
|
ctx.arc(p.x, p.y / s, r, 0, Math.PI * 2, false);
|
|
|
|
if (s !== 1) {
|
|
ctx.restore();
|
|
}
|
|
|
|
this._fillStroke(ctx, layer);
|
|
}
|
|
|
|
_fillStroke(ctx, layer) {
|
|
const options = layer.options;
|
|
|
|
if (options.fill) {
|
|
ctx.globalAlpha = options.fillOpacity;
|
|
ctx.fillStyle = options.fillColor ?? options.color;
|
|
ctx.fill(options.fillRule || 'evenodd');
|
|
}
|
|
|
|
if (options.stroke && options.weight !== 0) {
|
|
if (ctx.setLineDash) {
|
|
ctx.lineDashOffset = Number(options.dashOffset ?? 0);
|
|
ctx.setLineDash(options._dashArray ?? []);
|
|
}
|
|
ctx.globalAlpha = options.opacity;
|
|
ctx.lineWidth = options.weight;
|
|
ctx.strokeStyle = options.color;
|
|
ctx.lineCap = options.lineCap;
|
|
ctx.lineJoin = options.lineJoin;
|
|
ctx.stroke();
|
|
}
|
|
}
|
|
|
|
// Canvas obviously doesn't have pointer events for individual drawn objects,
|
|
// so we emulate that by calculating what's under the pointer on pointermove/click manually
|
|
|
|
_onClick(e) {
|
|
const point = this._map.pointerEventToLayerPoint(e);
|
|
let layer, clickedLayer;
|
|
|
|
for (let order = this._drawFirst; order; order = order.next) {
|
|
layer = order.layer;
|
|
if (layer.options.interactive && layer._containsPoint(point)) {
|
|
if (!(e.type === 'click' || e.type === 'preclick') || !this._map._draggableMoved(layer)) {
|
|
clickedLayer = layer;
|
|
}
|
|
}
|
|
}
|
|
this._fireEvent(clickedLayer ? [clickedLayer] : false, e);
|
|
}
|
|
|
|
_onPointerMove(e) {
|
|
if (!this._map || this._map.dragging.moving() || this._map._animatingZoom) { return; }
|
|
|
|
const point = this._map.pointerEventToLayerPoint(e);
|
|
this._handlePointerHover(e, point);
|
|
}
|
|
|
|
|
|
_handlePointerOut(e) {
|
|
const layer = this._hoveredLayer;
|
|
if (layer) {
|
|
// if we're leaving the layer, fire pointerout
|
|
this._container.classList.remove('leaflet-interactive');
|
|
this._fireEvent([layer], e, 'pointerout');
|
|
this._hoveredLayer = null;
|
|
this._pointerHoverThrottled = false;
|
|
}
|
|
}
|
|
|
|
_handlePointerHover(e, point) {
|
|
if (this._pointerHoverThrottled) {
|
|
return;
|
|
}
|
|
|
|
let layer, candidateHoveredLayer;
|
|
|
|
for (let order = this._drawFirst; order; order = order.next) {
|
|
layer = order.layer;
|
|
if (layer.options.interactive && layer._containsPoint(point)) {
|
|
candidateHoveredLayer = layer;
|
|
}
|
|
}
|
|
|
|
if (candidateHoveredLayer !== this._hoveredLayer) {
|
|
this._handlePointerOut(e);
|
|
|
|
if (candidateHoveredLayer) {
|
|
this._container.classList.add('leaflet-interactive'); // change cursor
|
|
this._fireEvent([candidateHoveredLayer], e, 'pointerover');
|
|
this._hoveredLayer = candidateHoveredLayer;
|
|
}
|
|
}
|
|
|
|
this._fireEvent(this._hoveredLayer ? [this._hoveredLayer] : false, e);
|
|
|
|
this._pointerHoverThrottled = true;
|
|
this._pointerHoverThrottleTimeout = setTimeout((() => {
|
|
this._pointerHoverThrottled = false;
|
|
}), 32);
|
|
}
|
|
|
|
_fireEvent(layers, e, type) {
|
|
this._map._fireDOMEvent(e, type || e.type, layers);
|
|
}
|
|
|
|
_bringToFront(layer) {
|
|
const order = layer._order;
|
|
|
|
if (!order) { return; }
|
|
|
|
const next = order.next;
|
|
const prev = order.prev;
|
|
|
|
if (next) {
|
|
next.prev = prev;
|
|
} else {
|
|
// Already last
|
|
return;
|
|
}
|
|
if (prev) {
|
|
prev.next = next;
|
|
} else if (next) {
|
|
// Update first entry unless this is the
|
|
// single entry
|
|
this._drawFirst = next;
|
|
}
|
|
|
|
order.prev = this._drawLast;
|
|
this._drawLast.next = order;
|
|
|
|
order.next = null;
|
|
this._drawLast = order;
|
|
|
|
this._requestRedraw(layer);
|
|
}
|
|
|
|
_bringToBack(layer) {
|
|
const order = layer._order;
|
|
|
|
if (!order) { return; }
|
|
|
|
const next = order.next;
|
|
const prev = order.prev;
|
|
|
|
if (prev) {
|
|
prev.next = next;
|
|
} else {
|
|
// Already first
|
|
return;
|
|
}
|
|
if (next) {
|
|
next.prev = prev;
|
|
} else if (prev) {
|
|
// Update last entry unless this is the
|
|
// single entry
|
|
this._drawLast = prev;
|
|
}
|
|
|
|
order.prev = null;
|
|
|
|
order.next = this._drawFirst;
|
|
this._drawFirst.prev = order;
|
|
this._drawFirst = order;
|
|
|
|
this._requestRedraw(layer);
|
|
}
|
|
}
|
|
|
|
// @namespace SVG; @section
|
|
// There are several static functions which can be called without instantiating SVG:
|
|
|
|
// @function create(name: String): SVGElement
|
|
// Returns a instance of [SVGElement](https://developer.mozilla.org/docs/Web/API/SVGElement),
|
|
// corresponding to the class name passed. For example, using 'line' will return
|
|
// an instance of [SVGLineElement](https://developer.mozilla.org/docs/Web/API/SVGLineElement).
|
|
function svgCreate(name) {
|
|
return document.createElementNS('http://www.w3.org/2000/svg', name);
|
|
}
|
|
|
|
// @function pointsToPath(rings: Point[], closed: Boolean): String
|
|
// Generates a SVG path string for multiple rings, with each ring turning
|
|
// into "M..L..L.." instructions
|
|
function pointsToPath(rings, closed) {
|
|
const str = rings.flatMap(points => [
|
|
...points.map((p, j) => `${(j ? 'L' : 'M') + p.x} ${p.y}`),
|
|
// closes the ring for polygons
|
|
closed ? 'z' : ''
|
|
]).join('');
|
|
|
|
// SVG complains about empty path strings
|
|
return str || 'M0 0';
|
|
}
|
|
|
|
const create = svgCreate;
|
|
|
|
/*
|
|
* @class SVG
|
|
* @inherits Renderer
|
|
*
|
|
* Allows vector layers to be displayed with [SVG](https://developer.mozilla.org/docs/Web/SVG).
|
|
* Inherits `Renderer`.
|
|
*
|
|
* @example
|
|
*
|
|
* Use SVG by default for all paths in the map:
|
|
*
|
|
* ```js
|
|
* const map = new Map('map', {
|
|
* renderer: new SVG()
|
|
* });
|
|
* ```
|
|
*
|
|
* Use a SVG renderer with extra padding for specific vector geometries:
|
|
*
|
|
* ```js
|
|
* const map = new Map('map');
|
|
* const myRenderer = new SVG({ padding: 0.5 });
|
|
* const line = new Polyline( coordinates, { renderer: myRenderer } );
|
|
* const circle = new Circle( center, { renderer: myRenderer, radius: 100 } );
|
|
* ```
|
|
*/
|
|
|
|
// @namespace SVG
|
|
// @constructor SVG(options?: Renderer options)
|
|
// Creates a SVG renderer with the given options.
|
|
class SVG extends Renderer {
|
|
|
|
_initContainer() {
|
|
this._container = create('svg');
|
|
|
|
// makes it possible to click through svg root; we'll reset it back in individual paths
|
|
this._container.setAttribute('pointer-events', 'none');
|
|
|
|
this._rootGroup = create('g');
|
|
this._container.appendChild(this._rootGroup);
|
|
}
|
|
|
|
_destroyContainer() {
|
|
Renderer.prototype._destroyContainer.call(this);
|
|
delete this._rootGroup;
|
|
delete this._svgSize;
|
|
}
|
|
|
|
_resizeContainer() {
|
|
const size = Renderer.prototype._resizeContainer.call(this);
|
|
|
|
// set size of svg-container if changed
|
|
if (!this._svgSize || !this._svgSize.equals(size)) {
|
|
this._svgSize = size;
|
|
this._container.setAttribute('width', size.x);
|
|
this._container.setAttribute('height', size.y);
|
|
}
|
|
}
|
|
|
|
_update() {
|
|
if (this._map._animatingZoom && this._bounds) { return; }
|
|
|
|
const b = this._bounds,
|
|
size = b.getSize(),
|
|
container = this._container;
|
|
|
|
// movement: update container viewBox so that we don't have to change coordinates of individual layers
|
|
container.setAttribute('viewBox', [b.min.x, b.min.y, size.x, size.y].join(' '));
|
|
|
|
this.fire('update');
|
|
}
|
|
|
|
// methods below are called by vector layers implementations
|
|
|
|
_initPath(layer) {
|
|
const path = layer._path = create('path');
|
|
|
|
// @namespace Path
|
|
// @option className: String = null
|
|
// Custom class name set on an element. Only for SVG renderer.
|
|
if (layer.options.className) {
|
|
path.classList.add(...splitWords(layer.options.className));
|
|
}
|
|
|
|
if (layer.options.interactive) {
|
|
path.classList.add('leaflet-interactive');
|
|
}
|
|
|
|
this._updateStyle(layer);
|
|
this._layers[stamp(layer)] = layer;
|
|
}
|
|
|
|
_addPath(layer) {
|
|
if (!this._rootGroup) { this._initContainer(); }
|
|
this._rootGroup.appendChild(layer._path);
|
|
layer.addInteractiveTarget(layer._path);
|
|
}
|
|
|
|
_removePath(layer) {
|
|
layer._path.remove();
|
|
layer.removeInteractiveTarget(layer._path);
|
|
delete this._layers[stamp(layer)];
|
|
}
|
|
|
|
_updatePath(layer) {
|
|
layer._project();
|
|
layer._update();
|
|
}
|
|
|
|
_updateStyle(layer) {
|
|
const path = layer._path,
|
|
options = layer.options;
|
|
|
|
if (!path) { return; }
|
|
|
|
if (options.stroke) {
|
|
path.setAttribute('stroke', options.color);
|
|
path.setAttribute('stroke-opacity', options.opacity);
|
|
path.setAttribute('stroke-width', options.weight);
|
|
path.setAttribute('stroke-linecap', options.lineCap);
|
|
path.setAttribute('stroke-linejoin', options.lineJoin);
|
|
|
|
if (options.dashArray) {
|
|
path.setAttribute('stroke-dasharray', options.dashArray);
|
|
} else {
|
|
path.removeAttribute('stroke-dasharray');
|
|
}
|
|
|
|
if (options.dashOffset) {
|
|
path.setAttribute('stroke-dashoffset', options.dashOffset);
|
|
} else {
|
|
path.removeAttribute('stroke-dashoffset');
|
|
}
|
|
} else {
|
|
path.setAttribute('stroke', 'none');
|
|
}
|
|
|
|
if (options.fill) {
|
|
path.setAttribute('fill', options.fillColor || options.color);
|
|
path.setAttribute('fill-opacity', options.fillOpacity);
|
|
path.setAttribute('fill-rule', options.fillRule || 'evenodd');
|
|
} else {
|
|
path.setAttribute('fill', 'none');
|
|
}
|
|
}
|
|
|
|
_updatePoly(layer, closed) {
|
|
this._setPath(layer, pointsToPath(layer._parts, closed));
|
|
}
|
|
|
|
_updateCircle(layer) {
|
|
const p = layer._point,
|
|
r = Math.max(Math.round(layer._radius), 1),
|
|
r2 = Math.max(Math.round(layer._radiusY), 1) || r,
|
|
arc = `a${r},${r2} 0 1,0 `;
|
|
|
|
// drawing a circle with two half-arcs
|
|
const d = layer._empty() ? 'M0 0' :
|
|
`M${p.x - r},${p.y
|
|
}${arc}${r * 2},0 ${
|
|
arc}${-r * 2},0 `;
|
|
|
|
this._setPath(layer, d);
|
|
}
|
|
|
|
_setPath(layer, path) {
|
|
layer._path.setAttribute('d', path);
|
|
}
|
|
|
|
// SVG does not have the concept of zIndex so we resort to changing the DOM order of elements
|
|
_bringToFront(layer) {
|
|
toFront(layer._path);
|
|
}
|
|
|
|
_bringToBack(layer) {
|
|
toBack(layer._path);
|
|
}
|
|
}
|
|
|
|
Map$1.include({
|
|
// @namespace Map; @method getRenderer(layer: Path): Renderer
|
|
// Returns the instance of `Renderer` that should be used to render the given
|
|
// `Path`. It will ensure that the `renderer` options of the map and paths
|
|
// are respected, and that the renderers do exist on the map.
|
|
getRenderer(layer) {
|
|
// @namespace Path; @option renderer: Renderer
|
|
// Use this specific instance of `Renderer` for this path. Takes
|
|
// precedence over the map's [default renderer](#map-renderer).
|
|
// If set, it will override the `pane` option of the path.
|
|
let renderer = layer.options.renderer ?? this._getPaneRenderer(layer.options.pane) ?? this.options.renderer ?? this._renderer;
|
|
|
|
if (!renderer) {
|
|
renderer = this._renderer = this._createRenderer();
|
|
}
|
|
|
|
if (!this.hasLayer(renderer)) {
|
|
this.addLayer(renderer);
|
|
}
|
|
return renderer;
|
|
},
|
|
|
|
_getPaneRenderer(name) {
|
|
if (name === 'overlayPane' || name === undefined) {
|
|
return;
|
|
}
|
|
|
|
let renderer = this._paneRenderers[name];
|
|
if (renderer === undefined) {
|
|
renderer = this._createRenderer({pane: name});
|
|
this._paneRenderers[name] = renderer;
|
|
}
|
|
return renderer;
|
|
},
|
|
|
|
_createRenderer(options) {
|
|
// @namespace Map; @option preferCanvas: Boolean = false
|
|
// Whether `Path`s should be rendered on a `Canvas` renderer.
|
|
// By default, all `Path`s are rendered in a `SVG` renderer.
|
|
return (this.options.preferCanvas && new Canvas(options)) || new SVG(options);
|
|
}
|
|
});
|
|
|
|
/*
|
|
* Rectangle extends Polygon and creates a rectangle when passed a LatLngBounds object.
|
|
*/
|
|
|
|
/*
|
|
* @class Rectangle
|
|
* @inherits Polygon
|
|
*
|
|
* A class for drawing rectangle overlays on a map. Extends `Polygon`.
|
|
*
|
|
* @example
|
|
*
|
|
* ```js
|
|
* // define rectangle geographical bounds
|
|
* const bounds = [[54.559322, -5.767822], [56.1210604, -3.021240]];
|
|
*
|
|
* // create an orange rectangle
|
|
* new Rectangle(bounds, {color: "#ff7800", weight: 1}).addTo(map);
|
|
*
|
|
* // zoom the map to the rectangle bounds
|
|
* map.fitBounds(bounds);
|
|
* ```
|
|
*
|
|
*/
|
|
|
|
// @constructor Rectangle(latLngBounds: LatLngBounds, options?: Polyline options)
|
|
class Rectangle extends Polygon {
|
|
initialize(latLngBounds, options) {
|
|
Polygon.prototype.initialize.call(this, this._boundsToLatLngs(latLngBounds), options);
|
|
}
|
|
|
|
// @method setBounds(latLngBounds: LatLngBounds): this
|
|
// Redraws the rectangle with the passed bounds.
|
|
setBounds(latLngBounds) {
|
|
return this.setLatLngs(this._boundsToLatLngs(latLngBounds));
|
|
}
|
|
|
|
_boundsToLatLngs(latLngBounds) {
|
|
latLngBounds = new LatLngBounds(latLngBounds);
|
|
return [
|
|
latLngBounds.getSouthWest(),
|
|
latLngBounds.getNorthWest(),
|
|
latLngBounds.getNorthEast(),
|
|
latLngBounds.getSouthEast()
|
|
];
|
|
}
|
|
}
|
|
|
|
SVG.create = create;
|
|
SVG.pointsToPath = pointsToPath;
|
|
|
|
// TODO: can they be static functions in the GeoJSON Class?
|
|
GeoJSON.geometryToLayer = geometryToLayer;
|
|
GeoJSON.coordsToLatLng = coordsToLatLng;
|
|
GeoJSON.coordsToLatLngs = coordsToLatLngs;
|
|
GeoJSON.latLngToCoords = latLngToCoords;
|
|
GeoJSON.latLngsToCoords = latLngsToCoords;
|
|
GeoJSON.getFeature = getFeature;
|
|
GeoJSON.asFeature = asFeature;
|
|
|
|
/*
|
|
* Handler.BoxZoom is used to add shift-drag zoom interaction to the map
|
|
* (zoom to a selected bounding box), enabled by default.
|
|
*/
|
|
|
|
// @namespace Map
|
|
// @section Interaction Options
|
|
Map$1.mergeOptions({
|
|
// @option boxZoom: Boolean = true
|
|
// Whether the map can be zoomed to a rectangular area specified by
|
|
// dragging the pointer while pressing the shift key.
|
|
boxZoom: true
|
|
});
|
|
|
|
class BoxZoom extends Handler {
|
|
initialize(map) {
|
|
this._map = map;
|
|
this._container = map._container;
|
|
this._pane = map._panes.overlayPane;
|
|
this._resetStateTimeout = 0;
|
|
map.on('unload', this._destroy, this);
|
|
}
|
|
|
|
addHooks() {
|
|
on(this._container, 'pointerdown', this._onPointerDown, this);
|
|
}
|
|
|
|
removeHooks() {
|
|
off(this._container, 'pointerdown', this._onPointerDown, this);
|
|
}
|
|
|
|
moved() {
|
|
return this._moved;
|
|
}
|
|
|
|
_destroy() {
|
|
this._pane.remove();
|
|
delete this._pane;
|
|
}
|
|
|
|
_resetState() {
|
|
this._resetStateTimeout = 0;
|
|
this._moved = false;
|
|
}
|
|
|
|
_clearDeferredResetState() {
|
|
if (this._resetStateTimeout !== 0) {
|
|
clearTimeout(this._resetStateTimeout);
|
|
this._resetStateTimeout = 0;
|
|
}
|
|
}
|
|
|
|
_onPointerDown(e) {
|
|
if (!e.shiftKey || (e.button !== 0)) { return false; }
|
|
|
|
// Clear the deferred resetState if it hasn't executed yet, otherwise it
|
|
// will interrupt the interaction and orphan a box element in the container.
|
|
this._clearDeferredResetState();
|
|
this._resetState();
|
|
|
|
disableTextSelection();
|
|
disableImageDrag();
|
|
|
|
this._startPoint = this._map.pointerEventToContainerPoint(e);
|
|
|
|
on(document, {
|
|
contextmenu: stop,
|
|
pointermove: this._onPointerMove,
|
|
pointerup: this._onPointerUp,
|
|
keydown: this._onKeyDown
|
|
}, this);
|
|
}
|
|
|
|
_onPointerMove(e) {
|
|
if (!this._moved) {
|
|
this._moved = true;
|
|
|
|
this._box = create$1('div', 'leaflet-zoom-box', this._container);
|
|
this._container.classList.add('leaflet-crosshair');
|
|
|
|
this._map.fire('boxzoomstart');
|
|
}
|
|
|
|
this._point = this._map.pointerEventToContainerPoint(e);
|
|
|
|
const bounds = new Bounds(this._point, this._startPoint),
|
|
size = bounds.getSize();
|
|
|
|
setPosition(this._box, bounds.min);
|
|
|
|
this._box.style.width = `${size.x}px`;
|
|
this._box.style.height = `${size.y}px`;
|
|
}
|
|
|
|
_finish() {
|
|
if (this._moved) {
|
|
this._box.remove();
|
|
this._container.classList.remove('leaflet-crosshair');
|
|
}
|
|
|
|
enableTextSelection();
|
|
enableImageDrag();
|
|
|
|
off(document, {
|
|
contextmenu: stop,
|
|
pointermove: this._onPointerMove,
|
|
pointerup: this._onPointerUp,
|
|
keydown: this._onKeyDown
|
|
}, this);
|
|
}
|
|
|
|
_onPointerUp(e) {
|
|
if (e.button !== 0) { return; }
|
|
|
|
this._finish();
|
|
|
|
if (!this._moved) { return; }
|
|
// Postpone to next JS tick so internal click event handling
|
|
// still see it as "moved".
|
|
this._clearDeferredResetState();
|
|
this._resetStateTimeout = setTimeout(this._resetState.bind(this), 0);
|
|
|
|
const bounds = new LatLngBounds(
|
|
this._map.containerPointToLatLng(this._startPoint),
|
|
this._map.containerPointToLatLng(this._point));
|
|
|
|
this._map
|
|
.fitBounds(bounds)
|
|
.fire('boxzoomend', {boxZoomBounds: bounds});
|
|
}
|
|
|
|
_onKeyDown(e) {
|
|
if (e.code === 'Escape') {
|
|
this._finish();
|
|
this._clearDeferredResetState();
|
|
this._resetState();
|
|
}
|
|
}
|
|
}
|
|
|
|
// @section Handlers
|
|
// @property boxZoom: Handler
|
|
// Box (shift-drag with pointer) zoom handler.
|
|
Map$1.addInitHook('addHandler', 'boxZoom', BoxZoom);
|
|
|
|
/*
|
|
* Handler.DoubleClickZoom is used to handle double-click zoom on the map, enabled by default.
|
|
*/
|
|
|
|
// @namespace Map
|
|
// @section Interaction Options
|
|
|
|
Map$1.mergeOptions({
|
|
// @option doubleClickZoom: Boolean|String = true
|
|
// Whether the map can be zoomed in by double clicking on it and
|
|
// zoomed out by double clicking while holding shift. If passed
|
|
// `'center'`, double-click zoom will zoom to the center of the
|
|
// view regardless of where the pointer was.
|
|
doubleClickZoom: true
|
|
});
|
|
|
|
class DoubleClickZoom extends Handler {
|
|
addHooks() {
|
|
this._map.on('dblclick', this._onDoubleClick, this);
|
|
}
|
|
|
|
removeHooks() {
|
|
this._map.off('dblclick', this._onDoubleClick, this);
|
|
}
|
|
|
|
_onDoubleClick(e) {
|
|
const map = this._map,
|
|
oldZoom = map.getZoom(),
|
|
delta = map.options.zoomDelta,
|
|
zoom = e.originalEvent.shiftKey ? oldZoom - delta : oldZoom + delta;
|
|
|
|
if (map.options.doubleClickZoom === 'center') {
|
|
map.setZoom(zoom);
|
|
} else {
|
|
map.setZoomAround(e.containerPoint, zoom);
|
|
}
|
|
}
|
|
}
|
|
|
|
// @section Handlers
|
|
//
|
|
// Map properties include interaction handlers that allow you to control
|
|
// interaction behavior in runtime, enabling or disabling certain features such
|
|
// as dragging or touch zoom (see `Handler` methods). For example:
|
|
//
|
|
// ```js
|
|
// map.doubleClickZoom.disable();
|
|
// ```
|
|
//
|
|
// @property doubleClickZoom: Handler
|
|
// Double click zoom handler.
|
|
Map$1.addInitHook('addHandler', 'doubleClickZoom', DoubleClickZoom);
|
|
|
|
/*
|
|
* Handler.MapDrag is used to make the map draggable (with panning inertia), enabled by default.
|
|
*/
|
|
|
|
// @namespace Map
|
|
// @section Interaction Options
|
|
Map$1.mergeOptions({
|
|
// @option dragging: Boolean = true
|
|
// Whether the map is draggable with pointer or not.
|
|
dragging: true,
|
|
|
|
// @section Panning Inertia Options
|
|
// @option inertia: Boolean = *
|
|
// If enabled, panning of the map will have an inertia effect where
|
|
// the map builds momentum while dragging and continues moving in
|
|
// the same direction for some time. Feels especially nice on touch
|
|
// devices. Enabled by default.
|
|
inertia: true,
|
|
|
|
// @option inertiaDeceleration: Number = 3000
|
|
// The rate with which the inertial movement slows down, in pixels/second².
|
|
inertiaDeceleration: 3400, // px/s^2
|
|
|
|
// @option inertiaMaxSpeed: Number = Infinity
|
|
// Max speed of the inertial movement, in pixels/second.
|
|
inertiaMaxSpeed: Infinity, // px/s
|
|
|
|
// @option easeLinearity: Number = 0.2
|
|
easeLinearity: 0.2,
|
|
|
|
// TODO refactor, move to CRS
|
|
// @option worldCopyJump: Boolean = false
|
|
// With this option enabled, the map tracks when you pan to another "copy"
|
|
// of the world and seamlessly jumps to the original one so that all overlays
|
|
// like markers and vector layers are still visible.
|
|
worldCopyJump: false,
|
|
|
|
// @option maxBoundsViscosity: Number = 0.0
|
|
// If `maxBounds` is set, this option will control how solid the bounds
|
|
// are when dragging the map around. The default value of `0.0` allows the
|
|
// user to drag outside the bounds at normal speed, higher values will
|
|
// slow down map dragging outside bounds, and `1.0` makes the bounds fully
|
|
// solid, preventing the user from dragging outside the bounds.
|
|
maxBoundsViscosity: 0.0
|
|
});
|
|
|
|
class Drag extends Handler {
|
|
addHooks() {
|
|
if (!this._draggable) {
|
|
const map = this._map;
|
|
|
|
this._draggable = new Draggable(map._mapPane, map._container);
|
|
|
|
this._draggable.on({
|
|
dragstart: this._onDragStart,
|
|
drag: this._onDrag,
|
|
dragend: this._onDragEnd
|
|
}, this);
|
|
|
|
this._draggable.on('predrag', this._onPreDragLimit, this);
|
|
if (map.options.worldCopyJump) {
|
|
this._draggable.on('predrag', this._onPreDragWrap, this);
|
|
map.on('zoomend', this._onZoomEnd, this);
|
|
|
|
map.whenReady(this._onZoomEnd, this);
|
|
}
|
|
}
|
|
this._map._container.classList.add('leaflet-grab', 'leaflet-touch-drag');
|
|
this._draggable.enable();
|
|
this._positions = [];
|
|
this._times = [];
|
|
}
|
|
|
|
removeHooks() {
|
|
this._map._container.classList.remove('leaflet-grab', 'leaflet-touch-drag');
|
|
this._draggable.disable();
|
|
}
|
|
|
|
moved() {
|
|
return this._draggable?._moved;
|
|
}
|
|
|
|
moving() {
|
|
return this._draggable?._moving;
|
|
}
|
|
|
|
_onDragStart() {
|
|
const map = this._map;
|
|
|
|
map._stop();
|
|
if (this._map.options.maxBounds && this._map.options.maxBoundsViscosity) {
|
|
const bounds = new LatLngBounds(this._map.options.maxBounds);
|
|
|
|
this._offsetLimit = new Bounds(
|
|
this._map.latLngToContainerPoint(bounds.getNorthWest()).multiplyBy(-1),
|
|
this._map.latLngToContainerPoint(bounds.getSouthEast()).multiplyBy(-1)
|
|
.add(this._map.getSize()));
|
|
|
|
this._viscosity = Math.min(1.0, Math.max(0.0, this._map.options.maxBoundsViscosity));
|
|
} else {
|
|
this._offsetLimit = null;
|
|
}
|
|
|
|
map
|
|
.fire('movestart')
|
|
.fire('dragstart');
|
|
|
|
if (map.options.inertia) {
|
|
this._positions = [];
|
|
this._times = [];
|
|
}
|
|
}
|
|
|
|
_onDrag(e) {
|
|
if (this._map.options.inertia) {
|
|
const time = this._lastTime = +new Date(),
|
|
pos = this._lastPos = this._draggable._absPos || this._draggable._newPos;
|
|
|
|
this._positions.push(pos);
|
|
this._times.push(time);
|
|
|
|
this._prunePositions(time);
|
|
}
|
|
|
|
this._map
|
|
.fire('move', e)
|
|
.fire('drag', e);
|
|
}
|
|
|
|
_prunePositions(time) {
|
|
while (this._positions.length > 1 && time - this._times[0] > 50) {
|
|
this._positions.shift();
|
|
this._times.shift();
|
|
}
|
|
}
|
|
|
|
_onZoomEnd() {
|
|
const pxCenter = this._map.getSize().divideBy(2),
|
|
pxWorldCenter = this._map.latLngToLayerPoint([0, 0]);
|
|
|
|
this._initialWorldOffset = pxWorldCenter.subtract(pxCenter).x;
|
|
this._worldWidth = this._map.getPixelWorldBounds().getSize().x;
|
|
}
|
|
|
|
_viscousLimit(value, threshold) {
|
|
return value - (value - threshold) * this._viscosity;
|
|
}
|
|
|
|
_onPreDragLimit() {
|
|
if (!this._viscosity || !this._offsetLimit) { return; }
|
|
|
|
const offset = this._draggable._newPos.subtract(this._draggable._startPos);
|
|
|
|
const limit = this._offsetLimit;
|
|
if (offset.x < limit.min.x) { offset.x = this._viscousLimit(offset.x, limit.min.x); }
|
|
if (offset.y < limit.min.y) { offset.y = this._viscousLimit(offset.y, limit.min.y); }
|
|
if (offset.x > limit.max.x) { offset.x = this._viscousLimit(offset.x, limit.max.x); }
|
|
if (offset.y > limit.max.y) { offset.y = this._viscousLimit(offset.y, limit.max.y); }
|
|
|
|
this._draggable._newPos = this._draggable._startPos.add(offset);
|
|
}
|
|
|
|
_onPreDragWrap() {
|
|
// TODO refactor to be able to adjust map pane position after zoom
|
|
const worldWidth = this._worldWidth,
|
|
halfWidth = Math.round(worldWidth / 2),
|
|
dx = this._initialWorldOffset,
|
|
x = this._draggable._newPos.x,
|
|
newX1 = (x - halfWidth + dx) % worldWidth + halfWidth - dx,
|
|
newX2 = (x + halfWidth + dx) % worldWidth - halfWidth - dx,
|
|
newX = Math.abs(newX1 + dx) < Math.abs(newX2 + dx) ? newX1 : newX2;
|
|
|
|
this._draggable._absPos = this._draggable._newPos.clone();
|
|
this._draggable._newPos.x = newX;
|
|
}
|
|
|
|
_onDragEnd(e) {
|
|
const map = this._map,
|
|
options = map.options,
|
|
|
|
noInertia = !options.inertia || e.noInertia || this._times.length < 2;
|
|
|
|
map.fire('dragend', e);
|
|
|
|
if (noInertia) {
|
|
map.fire('moveend');
|
|
|
|
} else {
|
|
this._prunePositions(+new Date());
|
|
|
|
const direction = this._lastPos.subtract(this._positions[0]),
|
|
duration = (this._lastTime - this._times[0]) / 1000,
|
|
ease = options.easeLinearity,
|
|
|
|
speedVector = direction.multiplyBy(ease / duration),
|
|
speed = speedVector.distanceTo([0, 0]),
|
|
|
|
limitedSpeed = Math.min(options.inertiaMaxSpeed, speed),
|
|
limitedSpeedVector = speedVector.multiplyBy(limitedSpeed / speed),
|
|
|
|
decelerationDuration = limitedSpeed / (options.inertiaDeceleration * ease);
|
|
let offset = limitedSpeedVector.multiplyBy(-decelerationDuration / 2).round();
|
|
|
|
if (!offset.x && !offset.y) {
|
|
map.fire('moveend');
|
|
|
|
} else {
|
|
offset = map._limitOffset(offset, map.options.maxBounds);
|
|
|
|
requestAnimationFrame(() => {
|
|
map.panBy(offset, {
|
|
duration: decelerationDuration,
|
|
easeLinearity: ease,
|
|
noMoveStart: true,
|
|
animate: true
|
|
});
|
|
});
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// @section Handlers
|
|
// @property dragging: Handler
|
|
// Map dragging handler.
|
|
Map$1.addInitHook('addHandler', 'dragging', Drag);
|
|
|
|
/*
|
|
* Map.Keyboard is handling keyboard interaction with the map, enabled by default.
|
|
*/
|
|
|
|
// @namespace Map
|
|
// @section Keyboard Navigation Options
|
|
Map$1.mergeOptions({
|
|
// @option keyboard: Boolean = true
|
|
// Makes the map focusable and allows users to navigate the map with keyboard
|
|
// arrows and `+`/`-` keys.
|
|
keyboard: true,
|
|
|
|
// @option keyboardPanDelta: Number = 80
|
|
// Amount of pixels to pan when pressing an arrow key.
|
|
keyboardPanDelta: 80
|
|
});
|
|
|
|
class Keyboard extends Handler {
|
|
|
|
static keyCodes = {
|
|
left: ['ArrowLeft'],
|
|
right: ['ArrowRight'],
|
|
down: ['ArrowDown'],
|
|
up: ['ArrowUp'],
|
|
zoomIn: ['Equal', 'NumpadAdd', 'BracketRight'],
|
|
zoomOut: ['Minus', 'NumpadSubtract', 'Digit6', 'Slash']
|
|
};
|
|
|
|
initialize(map) {
|
|
this._map = map;
|
|
|
|
this._setPanDelta(map.options.keyboardPanDelta);
|
|
this._setZoomDelta(map.options.zoomDelta);
|
|
}
|
|
|
|
addHooks() {
|
|
const container = this._map._container;
|
|
|
|
// make the container focusable by tabbing
|
|
if (container.tabIndex <= 0) {
|
|
container.tabIndex = '0';
|
|
}
|
|
|
|
// add aria-attribute for keyboard shortcuts to the container
|
|
container.ariaKeyShortcuts = Object.values(Keyboard.keyCodes).flat().join(' ');
|
|
|
|
on(container, {
|
|
focus: this._onFocus,
|
|
blur: this._onBlur,
|
|
pointerdown: this._onPointerDown
|
|
}, this);
|
|
|
|
this._map.on({
|
|
focus: this._addHooks,
|
|
blur: this._removeHooks
|
|
}, this);
|
|
}
|
|
|
|
removeHooks() {
|
|
this._removeHooks();
|
|
|
|
off(this._map._container, {
|
|
focus: this._onFocus,
|
|
blur: this._onBlur,
|
|
pointerdown: this._onPointerDown
|
|
}, this);
|
|
|
|
this._map.off({
|
|
focus: this._addHooks,
|
|
blur: this._removeHooks
|
|
}, this);
|
|
}
|
|
|
|
// acquire/lose focus #594, #1228, #1540
|
|
_onPointerDown() {
|
|
if (this._focused) { return; }
|
|
|
|
const body = document.body,
|
|
docEl = document.documentElement,
|
|
top = body.scrollTop || docEl.scrollTop,
|
|
left = body.scrollLeft || docEl.scrollLeft;
|
|
|
|
this._map._container.focus();
|
|
|
|
window.scrollTo(left, top);
|
|
}
|
|
|
|
_onFocus() {
|
|
this._focused = true;
|
|
this._map.fire('focus');
|
|
}
|
|
|
|
_onBlur() {
|
|
this._focused = false;
|
|
this._map.fire('blur');
|
|
}
|
|
|
|
_setPanDelta(panDelta) {
|
|
const keys = this._panKeys = {},
|
|
codes = Keyboard.keyCodes;
|
|
|
|
for (const code of codes.left) {
|
|
keys[code] = [-1 * panDelta, 0];
|
|
}
|
|
for (const code of codes.right) {
|
|
keys[code] = [panDelta, 0];
|
|
}
|
|
for (const code of codes.down) {
|
|
keys[code] = [0, panDelta];
|
|
}
|
|
for (const code of codes.up) {
|
|
keys[code] = [0, -1 * panDelta];
|
|
}
|
|
}
|
|
|
|
_setZoomDelta(zoomDelta) {
|
|
const keys = this._zoomKeys = {},
|
|
codes = Keyboard.keyCodes;
|
|
|
|
for (const code of codes.zoomIn) {
|
|
keys[code] = zoomDelta;
|
|
}
|
|
for (const code of codes.zoomOut) {
|
|
keys[code] = -zoomDelta;
|
|
}
|
|
}
|
|
|
|
_addHooks() {
|
|
on(document, 'keydown', this._onKeyDown, this);
|
|
}
|
|
|
|
_removeHooks() {
|
|
off(document, 'keydown', this._onKeyDown, this);
|
|
}
|
|
|
|
_onKeyDown(e) {
|
|
if (e.altKey || e.ctrlKey || e.metaKey) { return; }
|
|
|
|
const key = e.code,
|
|
map = this._map;
|
|
let offset;
|
|
|
|
if (key in this._panKeys) {
|
|
if (!map._panAnim || !map._panAnim._inProgress) {
|
|
offset = this._panKeys[key];
|
|
if (e.shiftKey) {
|
|
offset = new Point(offset).multiplyBy(3);
|
|
}
|
|
|
|
if (map.options.maxBounds) {
|
|
offset = map._limitOffset(new Point(offset), map.options.maxBounds);
|
|
}
|
|
|
|
if (map.options.worldCopyJump) {
|
|
const newLatLng = map.wrapLatLng(map.unproject(map.project(map.getCenter()).add(offset)));
|
|
map.panTo(newLatLng);
|
|
} else {
|
|
map.panBy(offset);
|
|
}
|
|
}
|
|
} else if (key in this._zoomKeys) {
|
|
map.setZoom(map.getZoom() + (e.shiftKey ? 3 : 1) * this._zoomKeys[key]);
|
|
|
|
} else if (key === 'Escape' && map._popup && map._popup.options.closeOnEscapeKey) {
|
|
map.closePopup();
|
|
|
|
} else {
|
|
return;
|
|
}
|
|
|
|
stop(e);
|
|
}
|
|
}
|
|
|
|
// @section Handlers
|
|
// @section Handlers
|
|
// @property keyboard: Handler
|
|
// Keyboard navigation handler.
|
|
Map$1.addInitHook('addHandler', 'keyboard', Keyboard);
|
|
|
|
/*
|
|
* Handler.ScrollWheelZoom is used by Map to enable mouse scroll wheel zoom on the map.
|
|
*/
|
|
|
|
// @namespace Map
|
|
// @section Interaction Options
|
|
Map$1.mergeOptions({
|
|
// @section Mouse wheel options
|
|
// @option scrollWheelZoom: Boolean|String = true
|
|
// Whether the map can be zoomed by using the mouse wheel. If passed `'center'`,
|
|
// it will zoom to the center of the view regardless of where the pointer was.
|
|
scrollWheelZoom: true,
|
|
|
|
// @option wheelDebounceTime: Number = 40
|
|
// Limits the rate at which a wheel can fire (in milliseconds). By default, the
|
|
// user can't zoom via wheel more often than once per 40 ms.
|
|
wheelDebounceTime: 40,
|
|
|
|
// @option wheelPxPerZoomLevel: Number = 60
|
|
// How many scroll pixels (as reported by [DomEvent.getWheelDelta](#domevent-getwheeldelta))
|
|
// mean a change of one full zoom level. Smaller values will make wheel-zooming
|
|
// faster (and vice versa).
|
|
wheelPxPerZoomLevel: 60
|
|
});
|
|
|
|
class ScrollWheelZoom extends Handler {
|
|
addHooks() {
|
|
on(this._map._container, 'wheel', this._onWheelScroll, this);
|
|
|
|
this._delta = 0;
|
|
}
|
|
|
|
removeHooks() {
|
|
off(this._map._container, 'wheel', this._onWheelScroll, this);
|
|
clearTimeout(this._timer);
|
|
}
|
|
|
|
_onWheelScroll(e) {
|
|
const delta = getWheelDelta(e);
|
|
|
|
const debounce = this._map.options.wheelDebounceTime;
|
|
|
|
this._delta += delta;
|
|
this._lastMousePos = this._map.pointerEventToContainerPoint(e);
|
|
|
|
if (!this._startTime) {
|
|
this._startTime = +new Date();
|
|
}
|
|
|
|
const left = Math.max(debounce - (+new Date() - this._startTime), 0);
|
|
|
|
clearTimeout(this._timer);
|
|
this._timer = setTimeout(this._performZoom.bind(this), left);
|
|
|
|
stop(e);
|
|
}
|
|
|
|
_performZoom() {
|
|
const map = this._map,
|
|
zoom = map.getZoom(),
|
|
snap = this._map.options.zoomSnap ?? 0;
|
|
|
|
map._stop(); // stop panning and fly animations if any
|
|
|
|
// map the delta with a sigmoid function to -4..4 range leaning on -1..1
|
|
const d2 = this._delta / (this._map.options.wheelPxPerZoomLevel * 4),
|
|
d3 = 4 * Math.log(2 / (1 + Math.exp(-Math.abs(d2)))) / Math.LN2,
|
|
d4 = snap ? Math.ceil(d3 / snap) * snap : d3,
|
|
delta = map._limitZoom(zoom + (this._delta > 0 ? d4 : -d4)) - zoom;
|
|
|
|
this._delta = 0;
|
|
this._startTime = null;
|
|
|
|
if (!delta) { return; }
|
|
|
|
if (map.options.scrollWheelZoom === 'center') {
|
|
map.setZoom(zoom + delta);
|
|
} else {
|
|
map.setZoomAround(this._lastMousePos, zoom + delta);
|
|
}
|
|
}
|
|
}
|
|
|
|
// @section Handlers
|
|
// @property scrollWheelZoom: Handler
|
|
// Scroll wheel zoom handler.
|
|
Map$1.addInitHook('addHandler', 'scrollWheelZoom', ScrollWheelZoom);
|
|
|
|
/*
|
|
* Map.TapHold is used to simulate `contextmenu` event on long hold,
|
|
* which otherwise is not fired by mobile Safari.
|
|
*/
|
|
|
|
const tapHoldDelay = 600;
|
|
|
|
// @namespace Map
|
|
// @section Interaction Options
|
|
Map$1.mergeOptions({
|
|
// @section Touch interaction options
|
|
// @option tapHold: Boolean
|
|
// Enables simulation of `contextmenu` event, default is `true` for mobile Safari.
|
|
tapHold: Browser.safari && Browser.mobile,
|
|
|
|
// @option tapTolerance: Number = 15
|
|
// The max number of pixels a user can shift his finger during touch
|
|
// for it to be considered a valid tap.
|
|
tapTolerance: 15
|
|
});
|
|
|
|
class TapHold extends Handler {
|
|
addHooks() {
|
|
on(this._map._container, 'pointerdown', this._onDown, this);
|
|
}
|
|
|
|
removeHooks() {
|
|
off(this._map._container, 'pointerdown', this._onDown, this);
|
|
clearTimeout(this._holdTimeout);
|
|
}
|
|
|
|
_onDown(e) {
|
|
clearTimeout(this._holdTimeout);
|
|
if (getPointers().length !== 1 || e.pointerType === 'mouse') { return; }
|
|
|
|
this._startPos = this._newPos = new Point(e.clientX, e.clientY);
|
|
|
|
this._holdTimeout = setTimeout((() => {
|
|
this._cancel();
|
|
if (!this._isTapValid()) { return; }
|
|
|
|
// prevent simulated mouse events https://w3c.github.io/touch-events/#mouse-events
|
|
on(document, 'pointerup', preventDefault);
|
|
on(document, 'pointerup pointercancel', this._cancelClickPrevent);
|
|
this._simulateEvent('contextmenu', e);
|
|
}), tapHoldDelay);
|
|
|
|
on(document, 'pointerup pointercancel contextmenu', this._cancel, this);
|
|
on(document, 'pointermove', this._onMove, this);
|
|
}
|
|
|
|
_cancelClickPrevent = function _cancelClickPrevent() {
|
|
off(document, 'pointerup', preventDefault);
|
|
off(document, 'pointerup pointercancel', _cancelClickPrevent);
|
|
};
|
|
|
|
_cancel() {
|
|
clearTimeout(this._holdTimeout);
|
|
off(document, 'pointerup pointercancel contextmenu', this._cancel, this);
|
|
off(document, 'pointermove', this._onMove, this);
|
|
}
|
|
|
|
_onMove(e) {
|
|
this._newPos = new Point(e.clientX, e.clientY);
|
|
}
|
|
|
|
_isTapValid() {
|
|
return this._newPos.distanceTo(this._startPos) <= this._map.options.tapTolerance;
|
|
}
|
|
|
|
_simulateEvent(type, e) {
|
|
const simulatedEvent = new MouseEvent(type, {
|
|
bubbles: true,
|
|
cancelable: true,
|
|
view: window,
|
|
// detail: 1,
|
|
screenX: e.screenX,
|
|
screenY: e.screenY,
|
|
clientX: e.clientX,
|
|
clientY: e.clientY,
|
|
// button: 2,
|
|
// buttons: 2
|
|
});
|
|
|
|
simulatedEvent._simulated = true;
|
|
|
|
e.target.dispatchEvent(simulatedEvent);
|
|
}
|
|
}
|
|
|
|
// @section Handlers
|
|
// @property tapHold: Handler
|
|
// Long tap handler to simulate `contextmenu` event (useful in mobile Safari).
|
|
Map$1.addInitHook('addHandler', 'tapHold', TapHold);
|
|
|
|
/*
|
|
* Handler.PinchZoom is used by Map to add pinch zoom on supported mobile browsers.
|
|
*/
|
|
|
|
// @namespace Map
|
|
// @section Interaction Options
|
|
Map$1.mergeOptions({
|
|
// @section Touch interaction options
|
|
// @option pinchZoom: Boolean|String = *
|
|
// Whether the map can be zoomed by touch-dragging with two fingers. If
|
|
// passed `'center'`, it will zoom to the center of the view regardless of
|
|
// where the touch events (fingers) were. Enabled for touch-capable web
|
|
// browsers.
|
|
pinchZoom: true,
|
|
|
|
// @option bounceAtZoomLimits: Boolean = true
|
|
// Set it to false if you don't want the map to zoom beyond min/max zoom
|
|
// and then bounce back when pinch-zooming.
|
|
bounceAtZoomLimits: true
|
|
});
|
|
|
|
class PinchZoom extends Handler {
|
|
addHooks() {
|
|
this._map._container.classList.add('leaflet-touch-zoom');
|
|
on(this._map._container, 'pointerdown', this._onPointerStart, this);
|
|
}
|
|
|
|
removeHooks() {
|
|
this._map._container.classList.remove('leaflet-touch-zoom');
|
|
off(this._map._container, 'pointerdown', this._onPointerStart, this);
|
|
}
|
|
|
|
_onPointerStart(e) {
|
|
const map = this._map;
|
|
|
|
const pointers = getPointers();
|
|
if (pointers.length !== 2 || map._animatingZoom || this._zooming) { return; }
|
|
|
|
const p1 = map.pointerEventToContainerPoint(pointers[0]),
|
|
p2 = map.pointerEventToContainerPoint(pointers[1]);
|
|
|
|
this._centerPoint = map.getSize()._divideBy(2);
|
|
this._startLatLng = map.containerPointToLatLng(this._centerPoint);
|
|
if (map.options.pinchZoom !== 'center') {
|
|
this._pinchStartLatLng = map.containerPointToLatLng(p1.add(p2)._divideBy(2));
|
|
}
|
|
|
|
this._startDist = p1.distanceTo(p2);
|
|
this._startZoom = map.getZoom();
|
|
|
|
this._moved = false;
|
|
this._zooming = true;
|
|
|
|
map._stop();
|
|
|
|
on(document, 'pointermove', this._onPointerMove, this);
|
|
on(document, 'pointerup pointercancel', this._onPointerEnd, this);
|
|
|
|
preventDefault(e);
|
|
}
|
|
|
|
_onPointerMove(e) {
|
|
const pointers = getPointers();
|
|
if (pointers.length !== 2 || !this._zooming) { return; }
|
|
|
|
const map = this._map,
|
|
p1 = map.pointerEventToContainerPoint(pointers[0]),
|
|
p2 = map.pointerEventToContainerPoint(pointers[1]),
|
|
scale = p1.distanceTo(p2) / this._startDist;
|
|
|
|
this._zoom = map.getScaleZoom(scale, this._startZoom);
|
|
|
|
if (!map.options.bounceAtZoomLimits && (
|
|
(this._zoom < map.getMinZoom() && scale < 1) ||
|
|
(this._zoom > map.getMaxZoom() && scale > 1))) {
|
|
this._zoom = map._limitZoom(this._zoom);
|
|
}
|
|
|
|
if (map.options.pinchZoom === 'center') {
|
|
this._center = this._startLatLng;
|
|
if (scale === 1) { return; }
|
|
} else {
|
|
// Get delta from pinch to center, so centerLatLng is delta applied to initial pinchLatLng
|
|
const delta = p1._add(p2)._divideBy(2)._subtract(this._centerPoint);
|
|
if (scale === 1 && delta.x === 0 && delta.y === 0) { return; }
|
|
this._center = map.unproject(map.project(this._pinchStartLatLng, this._zoom).subtract(delta), this._zoom);
|
|
}
|
|
|
|
if (!this._moved) {
|
|
map._moveStart(true, false);
|
|
this._moved = true;
|
|
}
|
|
|
|
cancelAnimationFrame(this._animRequest);
|
|
|
|
const moveFn = map._move.bind(map, this._center, this._zoom, {pinch: true, round: false}, undefined);
|
|
this._animRequest = requestAnimationFrame(moveFn.bind(this));
|
|
|
|
preventDefault(e);
|
|
}
|
|
|
|
_onPointerEnd() {
|
|
if (!this._moved || !this._zooming) {
|
|
this._zooming = false;
|
|
return;
|
|
}
|
|
|
|
this._zooming = false;
|
|
cancelAnimationFrame(this._animRequest);
|
|
|
|
off(document, 'pointermove', this._onPointerMove, this);
|
|
off(document, 'pointerup pointercancel', this._onPointerEnd, this);
|
|
|
|
// Pinch updates GridLayers' levels only when zoomSnap is off, so zoomSnap becomes noUpdate.
|
|
if (this._map.options.zoomAnimation) {
|
|
this._map._animateZoom(this._center, this._map._limitZoom(this._zoom), true, this._map.options.zoomSnap);
|
|
} else {
|
|
this._map._resetView(this._center, this._map._limitZoom(this._zoom));
|
|
}
|
|
}
|
|
}
|
|
|
|
// @section Handlers
|
|
// @property pinchZoom: Handler
|
|
// Pinch zoom handler.
|
|
Map$1.addInitHook('addHandler', 'pinchZoom', PinchZoom);
|
|
|
|
// Deprecated - Backward compatibility touchZoom
|
|
Map$1.addInitHook(function () {
|
|
this.touchZoom = this.pinchZoom;
|
|
|
|
if (this.options.touchZoom !== undefined) {
|
|
console.warn('Map: touchZoom option is deprecated and will be removed in future versions. Use pinchZoom instead.');
|
|
this.options.pinchZoom = this.options.touchZoom;
|
|
delete this.options.touchZoom;
|
|
}
|
|
if (this.options.pinchZoom) {
|
|
this.pinchZoom.enable();
|
|
} else {
|
|
this.pinchZoom.disable();
|
|
}
|
|
});
|
|
|
|
Map$1.BoxZoom = BoxZoom;
|
|
Map$1.DoubleClickZoom = DoubleClickZoom;
|
|
Map$1.Drag = Drag;
|
|
Map$1.Keyboard = Keyboard;
|
|
Map$1.ScrollWheelZoom = ScrollWheelZoom;
|
|
Map$1.TapHold = TapHold;
|
|
Map$1.PinchZoom = PinchZoom;
|
|
Map$1.TouchZoom = PinchZoom; // backward compatibility
|
|
|
|
// !!! NEXT LINE IS AUTO-GENERATED VIA `NPM VERSION` !!!
|
|
const version = '2.0.0-alpha.1';
|
|
|
|
var L = {
|
|
__proto__: null,
|
|
BlanketOverlay: BlanketOverlay,
|
|
Bounds: Bounds,
|
|
Browser: Browser,
|
|
CRS: CRS,
|
|
Canvas: Canvas,
|
|
Circle: Circle,
|
|
CircleMarker: CircleMarker,
|
|
Class: Class,
|
|
Control: Control,
|
|
DivIcon: DivIcon,
|
|
DivOverlay: DivOverlay,
|
|
DomEvent: DomEvent,
|
|
DomUtil: DomUtil,
|
|
Draggable: Draggable,
|
|
Evented: Evented,
|
|
FeatureGroup: FeatureGroup,
|
|
GeoJSON: GeoJSON,
|
|
GridLayer: GridLayer,
|
|
Handler: Handler,
|
|
Icon: Icon,
|
|
ImageOverlay: ImageOverlay,
|
|
LatLng: LatLng,
|
|
LatLngBounds: LatLngBounds,
|
|
Layer: Layer,
|
|
LayerGroup: LayerGroup,
|
|
LeafletMap: LeafletMap,
|
|
LineUtil: LineUtil,
|
|
Map: Map$1,
|
|
Marker: Marker,
|
|
Path: Path,
|
|
Point: Point,
|
|
PolyUtil: PolyUtil,
|
|
Polygon: Polygon,
|
|
Polyline: Polyline,
|
|
Popup: Popup,
|
|
PosAnimation: PosAnimation,
|
|
Projection: index,
|
|
Rectangle: Rectangle,
|
|
Renderer: Renderer,
|
|
SVG: SVG,
|
|
SVGOverlay: SVGOverlay,
|
|
TileLayer: TileLayer,
|
|
Tooltip: Tooltip,
|
|
Transformation: Transformation,
|
|
Util: Util,
|
|
VideoOverlay: VideoOverlay,
|
|
version: version
|
|
};
|
|
|
|
const oldL = getGlobalObject().L;
|
|
getGlobalObject().L = L;
|
|
getGlobalObject().L.noConflict = function () {
|
|
getGlobalObject().L = oldL;
|
|
return this;
|
|
};
|
|
|
|
function getGlobalObject() {
|
|
if (typeof globalThis !== 'undefined') { return globalThis; }
|
|
if (typeof self !== 'undefined') { return self; }
|
|
if (typeof window !== 'undefined') { return window; }
|
|
if (typeof global !== 'undefined') { return global; }
|
|
|
|
throw new Error('Unable to locate global object.');
|
|
}
|
|
|
|
exports.BlanketOverlay = BlanketOverlay;
|
|
exports.Bounds = Bounds;
|
|
exports.Browser = Browser;
|
|
exports.CRS = CRS;
|
|
exports.Canvas = Canvas;
|
|
exports.Circle = Circle;
|
|
exports.CircleMarker = CircleMarker;
|
|
exports.Class = Class;
|
|
exports.Control = Control;
|
|
exports.DivIcon = DivIcon;
|
|
exports.DivOverlay = DivOverlay;
|
|
exports.DomEvent = DomEvent;
|
|
exports.DomUtil = DomUtil;
|
|
exports.Draggable = Draggable;
|
|
exports.Evented = Evented;
|
|
exports.FeatureGroup = FeatureGroup;
|
|
exports.GeoJSON = GeoJSON;
|
|
exports.GridLayer = GridLayer;
|
|
exports.Handler = Handler;
|
|
exports.Icon = Icon;
|
|
exports.ImageOverlay = ImageOverlay;
|
|
exports.LatLng = LatLng;
|
|
exports.LatLngBounds = LatLngBounds;
|
|
exports.Layer = Layer;
|
|
exports.LayerGroup = LayerGroup;
|
|
exports.LeafletMap = LeafletMap;
|
|
exports.LineUtil = LineUtil;
|
|
exports.Map = Map$1;
|
|
exports.Marker = Marker;
|
|
exports.Path = Path;
|
|
exports.Point = Point;
|
|
exports.PolyUtil = PolyUtil;
|
|
exports.Polygon = Polygon;
|
|
exports.Polyline = Polyline;
|
|
exports.Popup = Popup;
|
|
exports.PosAnimation = PosAnimation;
|
|
exports.Projection = index;
|
|
exports.Rectangle = Rectangle;
|
|
exports.Renderer = Renderer;
|
|
exports.SVG = SVG;
|
|
exports.SVGOverlay = SVGOverlay;
|
|
exports.TileLayer = TileLayer;
|
|
exports.Tooltip = Tooltip;
|
|
exports.Transformation = Transformation;
|
|
exports.Util = Util;
|
|
exports.VideoOverlay = VideoOverlay;
|
|
exports.default = L;
|
|
exports.version = version;
|
|
|
|
}));
|
|
//# sourceMappingURL=leaflet-global-src.js.map
|