DevStateIcon: Unterschied zwischen den Versionen

Aktuelle Version vom 22. Oktober 2019, 14:04 Uhr

Das Attribut devStateIcon dient dazu, das anzuzeigende Icon eines Devices in Abhängigkeit vom Device-Status (STATE) in der Raumübersicht (room) festzulegen. Zudem kann man einstellen, was bei einem Klick auf das Icon geschieht.

Syntax

Das devStateIcon Attribut kann in 2 verschiedenen Formen spezifiziert werden, die in der commandref/devStateIcon sowie in deviceOverview detaillierter beschrieben werden.

Seit FHEM Version 2019-02-20 gibt es die Möglichkeit mehr als ein Icon pro Device darzustellen: Sobald STATE mehrzeilig ist wird für jede Zeile ein Icon erzeugt und alle Icons nebeneinander dargestellt. Mehrere Zeilen für STATE lassen sich über ein entsprechend gesetztes stateFormat Attribut erreichen. Ein Zeilenumbruch zwischen diesen Icons lässt sich mit <br> erzeugen.

Ein Beispiel findet sich in diesem Forenthread zur Entstehung des Features.

Einschränkungen

In devStateIcon dürfen keine Leerzeichen vorkommen (ausser zur Trennung der unterschiedlichen Zustände).

Da in der ersten Form der erste Teil jedes Tripels eine Regex ist, sind hier die für eine Regex geltenden Regeln zu beachten. Unter anderem sind das:

Leerzeichen durch . oder \s ersetzen
alle Zeichen die in einer Regex eine besondere Bedeutung haben (Klammern, Punkte, Backslash, ...) maskieren.

So müsste z.B. (siehe auch dieses Forenthema)

devStateIcon on-old-for-timer 60:weather_rain_heavy@red:off off:weather_sun@yellow:on-old-for-timer 60

geändert werden auf

devStateIcon on-old-for-timer.60:weather_rain_heavy@red:off off:weather_sun@yellow:on-old-60

wobei in diesem Beispiel zusätzlich der Befehlsteil des off mit der Attributdefinition

eventMap /on-old-for-timer 60:on-old-60/

auf eine "leerzeichenlose" Version umdefiniert werden muss.

Beispiele

Links

Ausführliche Beschreibung (mit Beispielen) zu eventMap, devStateIcon, setList und webCmd in diesem Forenthread oder in DeviceOverview anpassen
Beispiel für FS20 Beitrag

@@ Zeile 1: / Zeile 1: @@
 {{SEITENTITEL:devStateIcon}}  <!-- da richtige Schreibweise kleinen Anfangsbuchstaben hat -->
-<!-- Infobox Attribut sinnvoll? -->
+<!-- Infobox Attribut sinnvoll? Ja, da gerade Syntax mMn sonst in Abschreiben der commandref endet-->
-Das Attribut [[devStateIcon]] dient dazu, ...
+Das Attribut [[devStateIcon]] dient dazu, das anzuzeigende Icon eines Devices in Abhängigkeit vom Device-Status (STATE) in der Raumübersicht (room) festzulegen. Zudem kann man einstellen, was bei einem Klick auf das Icon geschieht.
-{{Todo|Bitte analog zu [[eventMap]] mit Inhalt füllen.}}
+== Syntax ==
+Das ''devStateIcon'' Attribut kann in 2 verschiedenen Formen spezifiziert werden, die in der {{Link2CmdRef|Anker=devStateIcon}} sowie in [[DeviceOverview anpassen#devStateIcon|deviceOverview]] detaillierter beschrieben werden.
+Seit FHEM Version 2019-02-20 gibt es die Möglichkeit mehr als ein Icon pro Device darzustellen: Sobald STATE mehrzeilig ist wird für jede Zeile ein Icon erzeugt und alle Icons nebeneinander
+dargestellt. Mehrere Zeilen für STATE lassen sich über ein entsprechend gesetztes stateFormat Attribut erreichen. Ein Zeilenumbruch zwischen diesen Icons lässt sich mit &lt;br&gt; erzeugen.
-== Syntax ==
+Ein Beispiel findet sich in {{Link2Forum|Topic=97586|LinkText=diesem Forenthread}} zur Entstehung des Features.
-Das ''devStateIcon'' Attribut wird in der folgenden Weise spezifiziert:
+[[Datei:stateFormat-1.png|600px]]
 == Einschränkungen ==
-In ''devStateIcon'' dürfen keine Leerzeichen vorkommen (ausser zur Trennung der unterschiedlichen Zustände). So müsste z.B. (siehe auch {{Link2Forum|Topic=42351|LinkText=dieses Forenthema}}
+In ''devStateIcon'' dürfen keine Leerzeichen vorkommen (ausser zur Trennung der unterschiedlichen Zustände).
+Da in der ersten Form der erste Teil jedes Tripels eine Regex ist, sind hier die für eine Regex geltenden Regeln zu beachten. Unter anderem sind das:
+* Leerzeichen durch . oder \s ersetzen
+* alle Zeichen die in einer Regex eine besondere Bedeutung haben (Klammern, Punkte, Backslash, ...) maskieren.
+So müsste z.B. (siehe auch {{Link2Forum|Topic=42351|LinkText=dieses Forenthema}})
 :<code>devStateIcon on-old-for-timer 60:weather_rain_heavy@red:off off:weather_sun@yellow:on-old-for-timer 60</code>
 geändert werden auf
@@ Zeile 25: / Zeile 37: @@
 == Links ==
-* Ausführliche Beschreibung (mit Beispielen) zu [[eventMap]], devStateIcon, [[setList]] und [[webCmd]] in {{Link2Forum|Topic=12080|LinkText=diesem Forenthread}}
+* Ausführliche Beschreibung (mit Beispielen) zu [[eventMap]], devStateIcon, [[setList]] und [[webCmd]] in {{Link2Forum|Topic=12080|LinkText=diesem Forenthread}} oder in [[DeviceOverview anpassen]]
 * Beispiel für FS20 {{Link2Forum|Topic=26521|Message=197326}}
 [[Kategorie:Attribut (allgemeingültig)]]