@eox/layercontrol
v0.28.0
Published
## Usage
Downloads
715
Keywords
Readme
Layer control
Usage
npm install @eox/layercontrol
// for setups with bundlers e.g. Vite
import "@eox/layercontrol"
// or, for e.g. single HTML files without bundler
import "@eox/layercontrol/dist/eox-layercontrol.js"
<eox-layercontrol for="eox-map"></eox-layercontrol>
Attributes
for: string = "eox-map"
The query selector of the eox-map
you wish to attach the layer control to.
<eox-map .layers="[...]"></eox-map>
<eox-layercontrol for="eox-map"></eox-layercontrol>
When used with a vanilla OpenLayer map, you need to reference the JS map object in the DOM, such as:
const olMap = new Map({
...
target: "map-div"
})
document.querySelector("map-div").map = olMap
<eox-layercontrol for="#map-div"></eox-layercontrol>
idProperty: string = "id"
The layer identifier property of the layers. Fallback is set automatically based on ol_uid
if not provided.
titleProperty: string = "title"
The layer title property of the layers. "title" by default, fallback is set automatically based on "layer" + ol_uid
if not provided.
unstyled: Boolean
Display the unstyled version of the layer control.
Layer properties
In order to be displayed correctly, the OpenLayers map layers need some custom properties (using e.g. layer.set(property, value)
).
id?: string
The layer id. Not required but recommended (see automatic fallback).
title?: string
The title of the layer displayed in the layer control. Not required (see automatic fallback), but recommended in order to display human-readable layer titles.
layerControlHide?: Boolean
Completely hide a layer from the layer control.
layerControlOptional?: Boolean
Initially hide a layer from the layer control, but make it available as an optional layer. If the layer is selected and added, it will be set to visible and pushed to the top of the layer list or (if originally configured within a layer group) to the top of the layer group.
layerControlExclusive?: Boolean
Make layers mutually exclusive. If two or more layers (on the same level, i.e. at root or inside a layer group) have this property, then only one of them can be visualized at a time.
layerControlExpand?: Boolean
Pre-expand a layer dropdown so that it is always open when the component initializes.
Contribute
Setup
npm install
npm start
npm run format
npm version <new version>
npm run build
npm publish (requires OTP)
Testing
This element includes components tests and is part of e2e tests. Please refer to the root README for more details.
Changelog
Created automatically here