Vorsicht

Dies ist die Dokumentation des aktuellen Entwicklungszweigs der CometVisu. Es besteht daher die Möglichkeit, dass einige der hier beschriebenen Features mit dem aktuellsten Release der CometVisu nicht genutzt werden können.

Plugin

Die Plugin-Komponente bindet kompatible CometVisu-Plugins innerhalb der Tile-Struktur ein. Der Wrapper lädt den Plugin-Code und rendert dessen Ausgabe direkt an der Stelle des <cv-plugin>-Elements. Das ist besonders nützlich für Inhalte, die bereits als Plugin existieren, zum Beispiel Wetterinformationen in einem Popup.

Innerhalb des Tile-Schemas wird <cv-plugin> derzeit vor allem mit dem OpenWeatherMap-Plugin verwendet. Weitere Plugins können auf die gleiche Weise eingebunden werden, wenn das Konfigurationsschema entsprechend erweitert wird.

<cv-small-status value-format="%d°" styling="">
    <label slot="value" style="font-size: 32px"/>
    <label slot="label" class="secondary">Außen</label>
    <cv-address slot="address" transform="DPT:5.010" mode="read">1/4/2</cv-address>
    <cv-popup slot="popup" modal="true">
        <cv-plugin>
            <openweathermap q="Irgendwo" owID="12345677" appid="123456789" lang="de"/>
        </cv-plugin>
    </cv-popup>
</cv-small-status>

Erlaubte Attribute

Element	Attribut
	Name	Inhalt	Beschreibung
cv-plugin	name	Text
	visible-on	mobile oder desktop	Steuert die Sichtbarkeit dieses Elements anhand der Bildschirmgröße.
	class	Text	Füge dieses Attribut der CSS Klasse hinzu, so dass das Widget durch ein eigenes Stylesheet zusätzlich formatiert werden kann.
	style	Text	Individuelle CSS style Regeln für dieses Widget.
	row	1, 2, 3, first, middle oder last	Zeilennummer oder Position (first, middle, last)
	column	1, 2, 3, first, middle oder last	Spaltennummer oder Position (first, middle, last)
	rowspan	integer	Anzahl der Zeilen die dieses Element belegt
	colspan	integer	Anzahl der Spalten die dieses Element belegt

Erlaubte Kind-Elemente und deren Attribute

Element	Attribut
Struktur	Name	Inhalt	Beschreibung
cv-plugin openweathermap	lang	en, de oder fr	Sprache / Datum-Formatierung
	appid	Text	Persönlicher Zugriffsschlüssel von https://openweathermap.org/
	description	Text	Beschreibungstext, zeigt den Ortsnamen an, wenn leer gelassen. „false“ deaktiviert Anzeige
	detailItems	integer	Anzeige von Details, wenn Wert 1 ist (Voreinstellung). 0 deaktiviert Anzeige
	forecast24hItems	integer	Anzahl der Einträge (0…8)
	forecastDailyItems	integer	Anzahl der Einträge (0…4)
	showSunrise	true oder false	Sonnen Auf- und Untergang anzeigen
	owID	Text	OpenWeatherMap City ID aus https://bulk.openweathermap.org/sample/city.list.json.gz
	q	Text	Wenn owID nicht verwendet wird: Ortsname und ISO 3166 Ländercode, durch Komma getrennt
	lat	Text	Wenn owID oder q nicht verwendet wird: Geografische Breite des Ortes
	lon	Text	Wenn owID oder q nicht verwendet wird: Geografische Länge des Ortes
	refresh	integer	Aktualisierungsintervall in Minuten
	class	Text	Füge dieses Attribut der CSS Klasse hinzu, so dass das Widget durch ein eigenes Stylesheet zusätzlich formatiert werden kann.