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
statusDp	nein	beliebig	Status-Datenpunkt: Zustand und Farben kommen von hier, geschrieben wird weiter auf datapoint

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 oder Button — 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 · button
onIcon / offIcon	Widget-Icon	nur bei icon
onImage / offImage	—	nur bei image: URL, Pfad, Base64, Datei vom Server oder Upload vom PC
onColor	--accent-green	CSS-Farbe oder Variable
offColor	--text-secondary	CSS-Farbe oder Variable
controlIconSize	28	px, nur bei icon und image
onText / offText	AN / AUS	Beschriftung, nur bei button
buttonOnColor / buttonOffColor	--accent	Hintergrund, nur bei button
buttonOnTextColor / buttonOffTextColor	#fff	Textfarbe, nur bei button
buttonSize	4	Innenabstand in px, nur bei button; bei 4 so hoch wie der Schiebeschalter

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
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