Wwx Tile Visu
Die Kachel-Visualisierung von Symcon
Mit der Version 7 hat Symcon die Kachel-Visualisierung (TileVisu) eingeführt, seit Version 8.1 ist sie fester Bestandteil und der Nachfolger des WebFront. Herzstück ist das anpassbare Kacheldesign, das Informationen und Steuerungselemente strukturiert und ansprechend darstellt.
Die im WebFront gern genutzten HTML-Boxen werden weiterhin unterstützt. Sie werden jetzt aber als eigenständige iFrames eingebunden, was das CSS-Styling gegen Seiteneffekte (gleiche Namen mit unterschiedlichen Definitionen) wie im alten WebFront wesentlich robuster macht. Darüber hinaus bietet das HTML-SDK den Modulentwicklern eine weitere Möglichkeit, das Kacheldesign via HTML zu gestalten.

Am Beispiel meiner Startseite sieht man sehr gut die Möglichkeiten der TileVisu. Die Kacheln für Wetter und Meldungen sind schöne Beispiele dafür, wie man mit etwas HTML ansprechende Kacheln erstellen kann. Beide sind Bestandteil von Pittis Skript-Bibliothek und auf den Seiten PirateWeather und Dashboard ausführlich beschrieben.
Vom WebFront zur TileVisu
Grundsätzlich lässt sich alles, was bisher im WebFront visualisiert wurde, auch in der TileVisu nutzen. Dennoch unterscheiden sich die beiden Visualisierungen grundlegend – und oft sind es die Details, die den Unterschied ausmachen.
Ein gutes Beispiel sind Tabellen. Mein WwxSkin ermöglichte im WebFront speziell angepasste Tabellenstile wie farbige Tabellenköpfe und Spaltenausrichtungen. In der TileVisu fehlen diese Definitionen, denn dort lassen sich keine eigenen Skins einbinden.


Natürlich könnte man argumentieren: „Selbst schuld, warum keine Inline-Styles?“ Doch genau darin lag der Vorteil eigener Skins – einmal definierte Styles lassen sich überall wiederverwenden. Zwei Versionen des HTML-Codes, eine für das WebFront und eine für die TileVisu, habe ich anfangs auch versucht. Das wurde aber schnell unübersichtlich, weil jede Erweiterung, Fehlerbehebung oder Optimierung doppelt gemacht werden musste.
Es war klar: Eine neue Lösung musste her!


So funktioniert es
Die zentrale Frage war: Wie erkennt man, ob das HTML im WebFront oder in der TileVisu angezeigt wird? In der TileVisu wird das HTML als iFrame geladen, was den Zugriff auf Informationen zusätzlich erschwert. Der entscheidende Unterschied ist das xmlns-Attribut – es wird nur im WebFront am <html>-Tag gesetzt.
Ein kleines JavaScript (wwx.js ) wertet dieses Attribut aus. Fehlt es, lädt das Skript das Stylesheet (wwx.css ) nach. Im WebFront passiert nichts, dort greift weiterhin der WwxSkin. So lässt sich das gleiche HTML in beiden Visualisierungen nutzen.
Damit das JavaScript in die HTML-Box kommt, muss es als erste Zeile vor dem eigentlichen HTML stehen:
// Erste Zeile jeder HTMLBox-Variable
$html = '<script type="application/javascript" src="./tile/wwx.js"></script>';
// Für Nutzer von Pittis Skript-Bibliothek gibt es dafür die globale Konstante
$html = __TILE_VISU_SCRIPT;
Tabellenstile
Das Stylesheet setzt die Seitenränder einer HTML-Box auf 0 Pixel, sorgt für schlanke Scrollbalken im Browser und bringt alle Tabellendefinitionen aus dem WwxSkin mit. Neben den bekannten Kopfvarianten „olive“, „orange“ und „blue“ gibt es zusätzlich „light“, „dark“, „theme“ (Akzentfarbe des eingestellten Themes) und „lines“.

Seit Version 1.4 sind die Zeilen der Standardtabelle abwechselnd hinterlegt statt durch Linien getrennt, die Zellen sind leicht gedimmt und der Tabellenkopf ist abgerundet.
Neu in 1.4: Tabellen im Kachel-Look
Mit dem Tabellenstil tiles sehen Tabellen aus wie die TileVisu selbst: Jede Zeile wird zu einer abgerundeten Kachel, der Kopf ist klein und gedimmt. Die Farben kommen aus den Theme-Variablen der TileVisu (--content-color, --card-color), dadurch passen die Tabellen automatisch zu hellen und dunklen Themes.

Die sortierte Spalte wird mit <th class="sel"> hervorgehoben und bekommt einen Pfeil nach unten, mit <th class="sel asc"> einen Pfeil nach oben. Eine einzelne Zeile lässt sich mit <tr class="sel"> markieren.
<table class="wwx tiles">
<thead>
<tr><th class="sel">Raum</th><th>Gerät</th><th class="fit">Laufzeit</th></tr>
</thead>
<tbody>
<tr>
<td>AG: Balkon<span class="wwx-sub">0011</span></td>
<td>Feuchtigkeit (01)</td>
<td class="fit"><span class="wwx-badge fixed">222 Tage</span></td>
</tr>
</tbody>
</table>
<div class="wwx-time">Stand 04.11. 09:33 Uhr</div>
Badges und Hilfsklassen
Für Status, Kategorien und Kennzeichen gibt es Badges in den Farben der Meldungs-Badges der TileVisu. Ohne Farbangabe ist ein Badge neutral, fixed gibt allen Badges einer Spalte die gleiche Breite, small macht daraus ein kleines Kennzeichen.


Dazu kommen Hilfsklassen für Unterzeilen, Hinweise und den Zeitstempel unter der Tabelle. Sie funktionieren auch ohne Tabelle, zum Beispiel für kompakte Statuskacheln:

Wer bisher eigenes CSS für solche Tabellen geschrieben hat, kann es jetzt durch die Klassen von WwxTileVisu ersetzen:

Klassenübersicht
| Klasse | Element | Wirkung |
|---|---|---|
wwx | <table> | Grundstil, Voraussetzung für alle weiteren Klassen |
olive, blue, orange, light, dark, theme, lines | <thead> | Farbe bzw. Stil des Tabellenkopfs |
tiles | <table> | Zeilen als Kacheln, kleiner gedimmter Kopf (ab 1.4) |
sel, sel asc | <th> | Sortierte Spalte mit Pfeil ab bzw. auf (ab 1.4) |
sel | <tr> | Markierte Zeile (ab 1.4) |
tc1 … tc10, tr1 … tr10 | <table> | Spalte zentriert bzw. rechtsbündig |
fit | <th>, <td> | Spalte so schmal wie ihr Inhalt (ab 1.4) |
wwx-sub | <span> | Unterzeile in kleinerer, gedimmter Schrift (ab 1.4) |
wwx-dim, wwx-nowrap, wwx-alert | beliebig | Gedimmt, ohne Umbruch, rote Hervorhebung (ab 1.4) |
wwx-note | beliebig | Zentrierter Hinweis, z. B. bei leerer Tabelle (ab 1.4) |
wwx-time | beliebig | Stand bzw. Fußzeile, klein und rechtsbündig (ab 1.4) |
wwx-badge | <span> | Badge, mit green, blue, yellow, orange, red, fixed, small (ab 1.4) |
Die Klassen ab Version 1.4 gibt es nur in der TileVisu, der WwxSkin im WebFront kennt sie nicht.
Voraussetzungen
- Symcon ab Version 8.1
- Für
tiles, Hilfsklassen und Badges: ein aktueller Browser bzw. eine aktuelle App mit Unterstützung relativer CSS-Farben (rgb(from …)), z. B. iOS/Safari ab 16.4 oder Chrome/Android WebView ab 119
Installation
Die beiden Dateien wwx.js und wwx.css gehören in das Tile-Verzeichnis der Symcon-Installation, unter Linux ist das /usr/share/symcon/tile:
git clone https://github.com/Wilkware/WwxTileVisu.git
sudo cp WwxTileVisu/wwx.* /usr/share/symcon/tile/
Danach in jeder HTML-Box die Skriptzeile voranstellen (siehe oben).
Tipp gegen den Browser-Cache: Hängt man eine Version an das Skript, z. B. src="./tile/wwx.js?v=1.4.20261104", lädt wwx.js das Stylesheet mit derselben Version (wwx.css?v=…). Nach Änderungen am Stylesheet muss dann nur die Version hochgezählt werden.
Das Verzeichnis /usr/share/symcon/ gehört zur Symcon-Installation. Nach einem Symcon-Update sollte man prüfen, ob die beiden Dateien noch vorhanden sind.
Versionshistorie
- 1.4 (04.11.2026): Tabellenstil
tiles, Badges, Hilfsklassen und Spaltenklassefit; Standardtabelle mit abwechselnd hinterlegten Zeilen; Version auswwx.js?v=…wird anwwx.cssweitergegeben - 1.3 (29.08.2025): Kleine Anpassung am Tabellenkopf
lines - 1.2 (21.07.2025): Seit Symcon 8.1 liegen die Dateien nicht mehr unter
preview, sondern untertile - 1.1 (21.12.2024): Kopfstil
theme, stehender (sticky) Tabellenkopf - 1.0 (02.07.2024): Erste Version