iFrame

Bettet eine externe Webseite oder lokale URL in ein Widget ein. Die URL kann statisch oder aus einem Datenpunkt kommen, optional über einen Proxy geladen, automatisch aktualisiert und per Sandbox abgesichert werden.

Einstellungen

Alle Optionen werden im Editor unter Widget bearbeiten gesetzt.

Quelle

Statische URL oder URL aus einem Datenpunkt. Bei iframeUrlMode: datapoint muss iframeUrlDp eine echte State-ID sein (sonst greift wieder die statische URL).

Option	Standard
iframeUrlMode	static	static · datapoint
iframeUrl	—	statische URL
iframeUrlDp	—	Datenpunkt mit URL (nur bei datapoint)
useProxy	false	URL über /proxy laden (umgeht X-Frame-Options / Mixed-Content)

Verhalten

Option	Standard
interactionMode	content	action · content · contentOnly — siehe unten
keepAlive	false	Seite bleibt beim Tab-/Bereichswechsel geladen; aus: verborgen verworfen, beim Zurückkehren frisch geladen
refreshInterval	0	automatisches Neuladen in Sekunden (0 = aus; bei keepAlive ignoriert)
reloadOnWake	false	nach Display-Standby neu laden (hebt keepAlive auf)
iframeColorScheme	theme	theme · device · neutral — siehe unten
iframeZoom	100	Zoomstufe in % (25–400), gilt auf allen Geräten
iframeZoomControls	false	Zoom-Tasten am Widget; Stufe gilt nur auf dem Gerät
iframeSoundControl	false	Ton-Taste (an/aus) am Widget — siehe unten
iframeMuted	false	Ton beim Laden aus
mobileHeight	aspect	Höhe auf dem Handy: aspect (Desktop-Seitenverhältnis) · rows (Zeilenhöhe, z. B. Grafana) · px
mobileHeightPx	300	feste Höhe in px bei mobileHeight: px

reloadOnWake ist für eingebettete Videos/Streams gedacht: Der Browser bricht sie im Standby ab, und ohne Nutzer-Tipp startet der Player nicht wieder. Für Seiten mit Eingaben ausgelassen lassen — der Reload verwirft deren Zustand.

Neu laden bei Datenpunkt-Änderung: Bedingung mit Effekt Widget neu laden anlegen — siehe Editor. Nötig, sobald sich der Inhalt hinter einer gleichbleibenden URL ändert (z. B. Diagramm eines Skripts, das auf ein Auswahlfeld reagiert): Die Adresse ändert sich nicht, also lädt der iFrame von sich aus nicht neu.

Zoom

iframeZoom verkleinert oder vergrößert die eingebettete Seite. Unter 100 % baut sie sich für eine entsprechend breitere Fläche auf — eine Seite mit eigenen Umbruchpunkten zeigt dann ihre Desktop-Ansicht statt der Handy-Ansicht.

iframeZoomControls blendet Tasten (− · Stufe · +) unten rechts im Widget ein. Die dort eingestellte Stufe gilt nur auf dem Gerät, an dem sie gesetzt wurde, und schlägt iframeZoom dort — für eine Seite, die auf dem Wandtablet und auf dem Handy unterschiedlich viel Platz braucht. Ein Tipp auf die Prozentzahl setzt auf die konfigurierte Stufe zurück.

	Zoom-Tasten	Zwei-Finger-Zoom
interactionMode: action	ja	ja
interactionMode: content / contentOnly	ja	nein

Die Wischgeste erreicht Aura nur, solange die Sperrschicht von action darüber liegt: Eine bedienbare Fremdseite behält ihre Berührungen für sich, davon erfährt das Widget nichts.

Ton

iframeSoundControl blendet unten rechts eine Lautsprecher-Taste ein; sie schaltet alle Videos und Audio-Elemente der Seite stumm bzw. wieder laut. iframeMuted startet stumm.

Seite	Ton steuerbar
über useProxy geladen	ja
Datei von Aura (/webfs/…)	ja
direkter Video-Link (.mp4, .webm) mit useProxy	ja
fremde Seite ohne Proxy (YouTube, Kamera-Weboberfläche …)	nein — Taste ausgegraut

Der Browser lässt Aura nur in Seiten der eigenen Adresse hineinsehen. Ein .mpg (MPEG-1/2) spielt kein Browser ab, unabhängig von der Taste.

Farbschema der Seite

Die eingebettete Seite entscheidet selbst, ob sie hell oder dunkel erscheint — meist anhand der Systemeinstellung des Geräts. Aura kann ihr stattdessen die eigene Helligkeit vorgeben; der Wechsel wirkt ohne Neuladen.

Wert	Die Seite folgt	Hintergrund
theme	dem Aura-Theme	die Seite bringt ihren eigenen mit
device	der Systemeinstellung des Geräts	die Seite bringt ihren eigenen mit
neutral	bleibt hell	die Widget-Karte scheint durch

neutral ist für Seiten ohne eigenen Hintergrund: ohne diese Einstellung malt der Browser dahinter eine weiße Fläche.

Energiefluss-erweitert

URL	https://<iobroker>:8082/energiefluss-erweitert/index.html?instance=0
Farbschema	automatisch neutral, solange nichts gewählt ist
Diagramme	eines pro Adapter-Instanz — weiteres Diagramm = weitere Instanz, ?instance=1
Farben	im Energiefluss-Editor, Hintergrund dort transparent lassen
Proxy	aus — die Seite braucht den Web-Adapter (Port 8082)

Nur Safari und Firefox geben die Helligkeit an eingebettete Seiten weiter. Chrome, Edge und die Android-WebView ignorieren sie — dort entscheidet immer das Gerät, in jedem der drei Werte.

Interaktion vs. Klick-Aktion

Ein Klick in die eingebettete Seite erreicht Aura nicht — das Fremd-Dokument behält das Ereignis. Bedienbarer Inhalt und Klick-Aktion auf derselben Fläche sind darum nicht möglich; interactionMode legt fest, was gilt.

Wert	Inhalt bedienbar	Klick-Aktion	Scrollleiste der Seite
action	nein (transparente Sperrschicht)	Klick aufs Widget	aus
content	ja	Aktions-Button oben rechts	an
contentOnly (veraltet)	ja	wirkungslos	an

contentOnly steht im Editor nur noch für Widgets zur Auswahl, die es schon nutzen — ohne Klick-Aktion reicht content mit Klick-Aktion Aus.

Die Scrollleiste gehört der eingebetteten Seite, nicht Aura: Passt sie nicht exakt in das Widget, zeigt der Desktop-Browser sie dauerhaft (Tablets blenden sie als Overlay aus). Bei action ist die Seite ohnehin gesperrt — dort wird sie unterdrückt.

Der Aktions-Button erscheint nur, wenn eine Klick-Aktion konfiguriert ist — auch bei den anderen Widgets mit eingebettetem Dokument (HTML, eCharts-Preset, Kamera mit .html-Stream).

Anzeige

Option	Standard
showTitle	true	Titel anzeigen
showIcon	true	Icon anzeigen
icon	MonitorDot	Lucide-Icon
iconSize	20	px
titleAlign	left	left · center · right

Höhe auf dem Handy

In der Einspaltenansicht übernimmt das Widget das Seitenverhältnis aus dem Raster statt der gespeicherten Zeilenzahl — die eingebettete Seite skaliert mit der Breite und stünde sonst klein und mittig in einer sehr hohen Box. Die Box wird dabei nie höher als im Raster und nicht flacher als 120 px. Gilt ebenso für das HTML-Widget.

Sandbox

Schränkt die Berechtigungen des eingebetteten Inhalts ein.

Option	Standard
sandbox	false	Sandbox aktivieren (Fallback extended, sonst off)
sandboxPreset	—	off · minimal · standard · extended · full · custom
sandboxCustom	—	eigene Flags bei custom, z. B. allow-scripts allow-forms