Skip to content

Widget-Übersicht ​

Der aktuelle Widget-Katalog enthält 47 Einträge in drei Gruppen. Die Namen entsprechen der Palette im Editor. Widgets mit Entitätsbindung lesen in der Runtime den aktuellen Home-Assistant-Zustand; ohne Entität verwenden sie Vorschauwerte. Schreibzugriff ist auf die unten genannten Widgets und Entitätstypen begrenzt. Externe Zustandsänderungen werden derzeit alle fünf Sekunden abgefragt. Eigene Änderungen an einem Regler wirken sofort auf Number und SVG-Line, während der Schreibauftrag an Home Assistant läuft.

Die Namen der VIS2-inspirierten Widgets bleiben auch bei deutscher Oberfläche auf Englisch. Frühere deutsche Palettennamen können weiterhin als Suchbegriffe dienen. Bereits gespeicherte eigene Widget-Namen bleiben unverändert.

Schreibfähige Widgets: Switch, Icon Toggle Button, Bool Checkbox, Bool Select, Bool SVG und Bool HTML (control) schalten gebundene switch-, light- oder input_boolean-Entitäten. Bulb on/off schaltet diese Entitäten oder setzt einen input_number-Helfer auf sein konfiguriertes Minimum/Maximum. Slider schreibt nur input_number; Input val schreibt input_number oder input_text. State Element schreibt im Schaltermodus Ein/Aus und im Buttonmodus den nächsten konfigurierten Wert an eine passende schaltbare Entität oder einen Zahlen-/Texthelfer. Bei einer unpassenden oder nicht verfügbaren Entität ist die Bedienung gesperrt. Die übrigen Widgets schreiben keinen HA-Zustand.

HA Grafik – Basis (44) ​

WidgetAktuelle Funktion
TabsAb Studio 0.1.116: 1–20 horizontale oder vertikale Reiter; horizontal Standard, zentriert oder Gesamtbreite. Pro Tab Titel, Symbol oder Bild, Symbolgröße/-farbe und Überlauf X/Y. Der Inhalt ist eine eigene Widget-Fläche oder eine vorhandene Projektseite. Nur der aktive Inhalt wird in der Runtime eingebettet; die Auswahl bleibt lokal im Browser gespeichert.

Tabs bearbeiten ​

Ab Studio 0.1.122 bietet die Haupteinstellung Tabs den Regler Inaktive Reiter abdunkeln (%) von 0 bis 90. Bei 0 bleiben die Farben unverändert, bei 90 bleiben 10 % Helligkeit. Hintergrund, Text und Symbol der inaktiven Reiter werden gemeinsam abgedunkelt; der aktive Reiter und der Tab-Inhalt bleiben unverändert. Die Einstellung gilt horizontal und vertikal und wird im Projekt gespeichert.

Ab Studio 0.1.121 stellst du in der Haupteinstellung Tabs die Textfarbe aktiv und Textfarbe nicht aktiv getrennt ein. Sie gelten für die Beschriftung aller Reiter, abhängig von der aktuellen Auswahl. Bleibt ein Wert leer, wird die bisherige Tab-Farbe verwendet. Die Symbolfarbe je Tab bleibt unabhängig; die Tab-Farbe bestimmt weiterhin die aktive Markierung.

Überlauf X und Überlauf Y bieten ab Studio 0.1.120 die Auswahl none, visible, hidden, scroll, auto, initial und inherit. none entfernt die eigene CSS-Vorgabe, visible lässt überstehenden Inhalt sichtbar, hidden schneidet ihn ab, scroll aktiviert Scrollleisten und auto zeigt sie bei Bedarf. initial verwendet den CSS-Ausgangswert, inherit übernimmt die Vorgabe des übergeordneten Elements. Ohne gespeicherte Auswahl bleibt auto der Standard. CSS kann die beiden Achsen gemeinsam beeinflussen, insbesondere wenn visible mit einer scrollbaren anderen Achse kombiniert wird.

Ab Studio 0.1.119 kannst du unter jedem Tab [n] die Tab-Hintergrundfarbe unabhängig einstellen. Sie färbt den jeweiligen Reiter in horizontalen und vertikalen Layouts; die Markierung des aktiven Tabs bleibt sichtbar.

Füge Tabs aus der Palette ein und stelle Breite und Höhe einmal am Hauptwidget ein. In Tab [1], Tab [2] usw. wählst du die Inhaltsart. Tabfläche bearbeiten öffnet die eigene Fläche mit der normalen Widget-Palette oder die referenzierte Projektseite. Zurück zum Tabs-Widget führt zum Hauptwidget zurück. Die eigene Inhaltsgröße ergibt sich aus dem Hauptwidget abzüglich 44 px für horizontale Reiter beziehungsweise bis zu 120 px für vertikale Reiter (höchstens die halbe Widget-Breite). Eigene Flächen gehören zum Widget und erscheinen nicht als separate Projektseiten. Vorhandene Seiten bleiben gemeinsam genutzte Referenzen; Änderungen wirken auf alle Einbettungen.

Ab Studio 0.1.124 werden aktive Tab-Inhalte direkt aus dem geöffneten Projekt dargestellt, ohne einen iFrame oder erneutes Laden beim Tabwechsel. Ein Klick auf die Inhaltsfläche öffnet ihre Bearbeitung; nach der Rückkehr sind auch ungespeicherte Änderungen sofort sichtbar. Speichere weiterhin vor dem Öffnen einer separaten Runtime, insbesondere bei deaktiviertem Auto-Save. Die Runtime fragt Entitätswerte auch für die aktiven Tab-Inhalte ab. Größere vorhandene Seiten werden ohne automatische Skalierung angezeigt; Überlauf X/Y steuert die Scrollbarkeit. Bei verringerter Tabanzahl bleiben die ausgeblendeten eigenen Inhalte gespeichert und erscheinen bei erneuter Erhöhung wieder. Kopieren, Gruppieren sowie Export/Import erhalten eigene Inhalte; Kopien bekommen neue Widget- und Gruppen-IDs. Zyklische Seiteneinbettungen werden verhindert. Weitere Tabs-Widgets innerhalb eigener Tabflächen sind zunächst nicht unterstützt. Die Umsetzung ist eigenständig; ein VIS2-Import ist damit nicht verbunden.

Weitere Basis-Widgets ​

WidgetAktuelle Funktion
linkFormatierbarer HTML-Inhalt als Link zu einer URL.
NoteNotizzettel mit Text beziehungsweise HTML und optional ausgeblendeter Ecke.
Screen ResolutionZeigt die aktuelle Fensterauflösung an.
Red NumberZahlenwert als farbiger Kreis oder Pin mit anpassbarem Radius.
Bool SVGWählt nach dem aktuellen Zustand eines von zwei SVG-Motiven; kann eine schaltbare Entität steuern.
SVG shapeZeichnet eine geometrische SVG-Form mit Farbe, Strichbreite, Rotation und Skalierung.
Input valUmrandetes Text- oder Zahlen-Eingabefeld. Liest und schreibt in der Runtime einen gewählten input_number- oder input_text-Helfer; ohne Entität bleibt die Eingabe lokal. „Auto-setzen“ schreibt nach einer kurzen Eingabepause, „withEnter“ nur bei Enter.
View in widgetBettet eine Projektseite ein; rekursive Einbettung wird verhindert.
View in widget 8Wählt eine von bis zu 50 Seiten anhand des Indexzustands.
iFrameBettet eine URL ein, sofern die Zielseite dies erlaubt; mit Rahmen-, Scroll- und Aktualisierungsoptionen.
iFrame 8Wählt anhand des Indexzustands einen von bis zu 20 konfigurierten Frames.
Image 8Wählt anhand des Indexzustands eines von bis zu 50 Bildern.
AckFlag HTMLZeigt zwei konfigurierbare HTML-Zustände; Home Assistant hat kein natives ioBroker-ack-Flag.
Icon Toggle ButtonSchaltfläche mit getrennten Bildern für Ein und Aus; kann eine schaltbare Entität steuern.
SwitchGrafischer Ein/Aus-Schalter; kann eine schaltbare Entität steuern.
Bool CheckboxEin/Aus-Auswahl; kann eine schaltbare Entität steuern.
Bulb on/offLampensymbol mit getrennten Ein-/Aus-Bildern; steuert eine schaltbare Entität oder einen Zahlenhelfer.
SliderRegler mit Minimum, Maximum und Schrittweite; Min-/Max-Beschriftungen sind per Checkbox zuschaltbar. Die Grenzen sollten zum Helfer passen, etwa -200 bis 200. Ein gewählter input_number-Helfer liefert den aktuellen Wert; beim Ziehen aktualisiert der Regler abhängige Number- und SVG-Line-Widgets sofort und schreibt beim Loslassen nach Home Assistant. Ohne Entität bleibt die Änderung lokal. Ab Studio 0.1.114 sind Schienenfarbe, aktive Farbe, Schienenstärke und Rundung sowie Reglerfarbe, Größe und Rundung getrennt einstellbar. Der Spurtyp bietet Normal (Minimum bis Wert), Umgekehrt (Wert bis Maximum) oder keine aktive Spur. Schiene und Regler haben eigene Schatten mit X/Y-Versatz, Unschärfe, Ausdehnung und CSS-/RGBA-Farbe. Rundung: 0 % eckig, 100 % vollständig gerundet; Schatten mit allen Größenwerten 0 sind aus. Skalenmarkierungen bleiben oben/unten mit optionalen Zahlen verfügbar.
NumberZeigt den formatierten Zahlenwert mit Multiplikator und Nachkommastellen, bei fehlendem Entitätswert --. Ab Studio 0.1.125 werden HTML voranstellen und HTML anhängen (Singular/Plural) auch bei gebundener HA-Entität im Editor und in der Runtime angezeigt und bei Sofortaktualisierungen erhalten. Singular gilt für den mit dem Multiplikator berechneten Wert 1, sonst Plural; ohne HTML-Nachtext dient die konfigurierte Einheit als Ersatz. Der Vorschautitel wird ohne Entität angezeigt. Getrennt vom grafischen Widget „Red Number“.
StringTextwert mit optionalem Icon und HTML vor oder nach dem Wert.
String (unescaped)Stellt einen HTML-Wert mit Vor- und Nachsatz dar.
String img srcZeigt ein Bild aus einer URL im Zustand.
TimesValueFormatiert einen Zeitwert aus dem Zustand.
Timestamp ValueFormatiert einen Zeitstempel aus dem Zustand.
TimestampFormatiert den Zeitpunkt der letzten HA-Aktualisierung.
Last change TimestampFormatiert den Zeitpunkt der letzten HA-Zustandsänderung.
ValueList TextZeigt einen über den Indexzustand ausgewählten Listeneintrag als Text.
ValueList HTMLZeigt einen über den Indexzustand ausgewählten Listeneintrag als HTML.
ValueList HTML StyleZeigt einen HTML-Listeneintrag mit zugeordnetem CSS-Stil.
Bool HTMLZeigt je nach Zustand einen von zwei HTML-Inhalten.
Bool SelectEin/Aus-Auswahl mit anpassbaren Beschriftungen; kann eine schaltbare Entität steuern.
Bool HTML (control)Anklickbare Ein/Aus-HTML-Anzeige; kann eine schaltbare Entität steuern.
HTML StateEigener HTML-Inhalt mit optionalem Klick-Link und Wertplatzhalter.
TableTabelle aus JSON-Daten mit Zeilenauswahl und Druckoption; ein gebundener HA-Zustand muss JSON-Zeilen enthalten.
Full ScreenSchaltfläche für den Vollbildmodus der Oberfläche.
BarHorizontaler oder vertikaler Balken für einen Zahlenwert.
HTMLFrei konfigurierbarer HTML-Inhalt.
HTML navigationSchaltfläche oder Link zu einer Projektseite, URL oder einem HA-Pfad.
filter - dropdownFiltert Runtime-Widgets anhand des in „Generell“ gesetzten Filterworts.
TextFreies Textfeld ohne Entitätsbindung.
BorderRahmen mit Titel, Titelposition, Kopfbereich und Farben.
GaugeEinfache Messwertanzeige mit Einheit.
ImageZeigt eine konfigurierbare Bildquelle oder eine URL aus dem Entitätszustand; noch keine Live-Kamera-Anbindung.

HA Grafik – Interaktiv (1) ​

WidgetAktuelle Funktion
State ElementBis zu fünf Zustände mit jeweils Icon, Bild, Text oder HTML; Schalter-, Button-, Nur-Anzeige- und Navigationsmodus. Liest eine gebundene Entität und kann im Schalter-/Buttonmodus passende Entitäten schreiben.

HA Grafik – Spezial (2) ​

WidgetAktuelle Funktion
SVG-LineZeichnet und animiert Verbindungen zwischen Widgets, mit Andockpunkten, manuellem Mehrpunktpfad und gezielter Kopplung über Sammelpunkte.
SVG LineBoxIm Editor sichtbarer Verteiler: Zahlenwerte eingehender Linien summieren und an Ausgangslinien sowie optional an einen HA-Zahlenhelfer weitergeben. Ein einstellbarer Kreis verdeckt in der Runtime die verbundenen Linienenden.