Schalter
Schaltet einen boolean-Datenpunkt. Wahlweise als Schiebeschalter, Checkbox oder Icon-Taster, mit optionalem Impuls-Modus und Sicherheitsabfrage. Für dimmbare oder farbige Lampen ist das Lampen-Widget besser.
Mögliche Bildquellen (URL, Adapter-Pfad, Datei, Base64): siehe Bildpfade.
Datenpunkt
| Feld | Pflicht | Typ | |
|---|---|---|---|
datapoint | ja | boolean | wird getoggelt, im Taster-Modus gepulst |
Layouts
Default
Titel, Status-Text und Schalter untereinander — für mittlere Zellen.
Card
Vollflächige farbige Karte, im AN-Zustand grün — für prominente Schalter.
Compact
Eine Zeile mit Icon, Titel und Schalter — für Listen mit vielen Schaltern.
Custom
Icon, Titel, Status und Schalter frei in einer Zellenmatrix platzieren — siehe Custom-Layout.
Einstellungen
Alle Optionen werden im Editor unter Widget bearbeiten gesetzt.
Anzeige
| Option | Standard | |
|---|---|---|
showTitle | true | Titel anzeigen |
showLabel | true | AN/AUS-Text anzeigen |
showIcon | true | Icon anzeigen |
icon | Power | Lucide-Icon |
iconSize | 20 | px |
titleAlign | left | left · center · right |
Steuerelement
Schiebeschalter, Checkbox, Icon- oder Bild-Taster — bei controlMode: icon werden onIcon/offIcon und onColor/offColor ausgewertet, bei checkbox färbt onColor das Häkchen-Feld (leer = Theme-Farbe des Schalters).
| Option | Standard | |
|---|---|---|
controlMode | toggle | toggle · checkbox · icon · image |
onIcon / offIcon | Widget-Icon | nur bei icon |
onImage / offImage | — | nur bei image |
onColor | --accent-green | CSS-Farbe oder Variable |
offColor | --text-secondary | CSS-Farbe oder Variable |
controlIconSize | 28 | px, nur bei icon |
Schreibwerte & Status
Geräte, die Schalten und Rückmeldung trennen (Tasmota: cmnd.POWER nimmt nur Befehle an und fällt danach auf null, stat.POWER meldet ON/OFF), bekommen den Status-DP zusätzlich zum Hauptdatenpunkt.
| Option | Standard | |
|---|---|---|
onValue / offValue | true / false | Schreibwerte, z. B. 1 / 0 |
statusDp | — | Status-Datenpunkt: Zustand und Farben kommen von hier, geschrieben wird weiter auf den Hauptdatenpunkt |
stateMode | boolean | boolean = an bei true, Zahlen ≠ 0 und Texten wie ON; condition = Vergleich |
stateOperator / stateValue | > / 0 | Vergleich bei stateMode: condition, z. B. == und ON |
Gilt für alle Layouts (Default, Card, Compact, Custom).
Taster
Statt zu toggeln schreibt der Schalter kurz true und nach momentaryDelay wieder false. Praktisch für Skript-Trigger oder Impuls-Relais.
| Option | Standard | |
|---|---|---|
momentary | false | Impuls statt Toggle |
momentaryDelay | 500 | ms bis Reset |
Sicherheitsabfrage
Kleines Bestätigungs-Popup direkt am Schalter (anchor-positioniert, ohne Backdrop).
| Option | Standard | |
|---|---|---|
confirmAction | false | Bestätigung vor Schalten |
confirmText | — | Anzeigetext im Popup |
