native-map
A native web component that shows an interactive map based on a given context.
DISCLAIMER: not yet published on NPM!!
Live demo here!
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:
nativeMap.context = {
layers: [
{ url: 'https://my.test.server/wms', type: 'wms', name: 'abcd' }
]
};
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' }];
nativeMap.context = {
layers: [
wmsLayer
]
};
nativeMap.context = {
layers: [
{ ... },
wmsLayer
]
};
Demo
To run the demo:
npm install
npm run demo