@camptocamp/native-map
v0.1.2
Published
A native web component used to render interactive maps
Downloads
6
Keywords
Readme
native-map
A native web component that shows an interactive map based on a given context.
Usage
To use it:
npm install @camptocamp/native-map
<html>
...
<body>
<native-map></native-map>
</body>
</html>
import '@camptocamp/native-map'
const nativeMap = document.getElementById('map');
nativeMap.context = {
view: {
zoom: 3,
center: [4, 45]
},
layers: [
{ url: 'https://my.test.server/wms', type: 'wms', name: 'abcd' }
]
};
The map cannot be modified directly, everything has to be done declaratively using the context
property of the
NativeMapElement
class.
When providing a new context, the component checks which parts of it have changed using reference equality instead of deep equality.
As an example, this will cause the WMS layer to be recreated:
// initial context has only one layer
nativeMap.context = {
layers: [
{ url: 'https://my.test.server/wms', type: 'wms', name: 'abcd' }
]
};
// add a new layer in first position
nativeMap.context = {
layers: [
{ ... },
{ url: 'https://my.test.server/wms', type: 'wms', name: 'abcd' }
]
};
This will not (because the same layer object is used in both contexts):
const wmsLayer = [{ url: 'https://my.test.server/wms', type: 'wms', name: 'abcd' }];
// initial context has only one layer
nativeMap.context = {
layers: [
wmsLayer
]
};
// add a new layer in first position
nativeMap.context = {
layers: [
{ ... },
wmsLayer
]
};
Demo
To run the demo:
npm install
npm run demo