Aktualitäten

Dieses Addon zeigt zu ausgewählten Kartenebenen passende Aktualitäten-Layer in einem frei verschiebbaren Fenster an. Die Layer können dort ein- und ausgeschaltet werden, ohne dass sie im regulären Themenbaum sichtbar sein müssen.

Setup

Fügen Sie das Addon dem addons-Ordner der Kartenviewer API hinzu. Erstellen oder editieren Sie die addonsConf.json und fügen Sie folgenden Eintrag hinzu:

{
    "aktualitaeten": "view.js"
}

Fügen Sie das Addon zur config.js Datei im Abschnitt addons hinzu:

addons: [
    "aktualitaeten"
]

Wenn für das Icon Fontawesome-Klassen verwendet werden, muss zusätzlich das fontawesome-Addon eingebunden sein.

In der config.json wird das Addon im Abschnitt Portalconfig konfiguriert:

"Portalconfig": {
    "aktualitaeten": {
        "name": "Aktualitäten",
        "glyphicon": "fas fa-list-ul fa-lg",
        "isVisible": false,
        "autoToggleVisibility": true,
        "strictMode": true,
        "closeOnMapModes": ["3D"],
        "emptyMessage": "Keine Aktualitäten verfügbar"
    }
}

An den Layern, zu denen Aktualitäten angezeigt werden sollen, wird die Eigenschaft relevantAktualitaetenLayers gesetzt. Sie enthält die IDs der Aktualitäten-Layer:

{
    "id": "536",
    "name": "DOP20c aktuell",
    "relevantAktualitaetenLayers": ["431"]
}

Die Aktualitäten-Layer selbst können aus dem Themenbaum ausgeblendet werden. Dadurch bleiben sie über das Addon bedienbar:

{
    "id": "431",
    "name": "DOP20c 2019-2021",
    "isNeverVisibleInTree": true,
    "type": "layer",
    "typ": "WMS"
}

Konfiguration

Folgende Parameter können im Block Portalconfig.aktualitaeten konfiguriert werden:

Name	Verpflichtend	Typ	Default	Beschreibung	Standard
name	nein	String	`"Aktualitäten"`	Name des Addons. Wird im Fensterkopf sowie als Titel und ARIA-Label des Buttons verwendet.	false
glyphicon	nein	String	`"glyphicon-list"`	Icon-Definition des Buttons. Für Fontawesome-Icons muss die Stilklasse, z.B. `fas`, mit angegeben werden.	false
isVisible	nein	Boolean	`false`	Legt fest, ob das Fenster beim Start geöffnet ist.	false
autoToggleVisibility	nein	Boolean	`false`	Öffnet das Fenster automatisch, sobald ein neu aktivierter Layer über `relevantAktualitaetenLayers` verknüpfte Aktualitäten besitzt. Das Fenster wird wieder geschlossen, wenn kein solcher Layer mehr aktiv ist.	false
strictMode	nein	Boolean	`false`	Hebt die Auswahl ausgeblendeter Aktualitäten-Layer auf, wenn sie nicht mehr zu den aktuell aktiven verknüpften Layern gehören.	false
closeOnMapModes	nein	Array	`["3D"]`	Kartenmodi, in denen das Fenster geschlossen und der Button ausgeblendet wird. Wurde das Fenster durch einen Kartenmodus geschlossen, öffnet es sich beim Wechsel zurück nur wieder, wenn `autoToggleVisibility` aktiv ist und weiterhin ein verknüpfter Layer ausgewählt ist.	false
emptyMessage	nein	String	`"Keine Aktualitäten verfügbar"`	Text, der angezeigt wird, wenn für die aktuelle Auswahl keine Aktualitäten vorhanden sind.	false
closeLabel	nein	String	`"Schließen"`	Beschriftung des Schließen-Buttons für Titel und Barrierefreiheit.	false

Für die Zuordnung der Layer wird zusätzlich folgende Eigenschaft an den jeweiligen Layern in der config.json verwendet:

Name	Verpflichtend	Typ	Default	Beschreibung	Standard
relevantAktualitaetenLayers	nein	Array	-	Liste der Layer-IDs, die im Aktualitäten-Fenster angeboten werden, wenn der jeweilige Layer aktiv ist. Zahlenwerte werden intern wie String-IDs behandelt.	false

Sind mehrere Layer mit Aktualitäten gleichzeitig aktiv, führt das Addon die referenzierten Aktualitäten-Layer zusammen und zeigt jede verknüpfte Aktualität nur einmal an.

Setup​

Konfiguration​

Setup

Konfiguration