Dashboard¶

Diese Seite beschreibt alle dashboard-weiten Konfigurationsobjekte.

DashboardConfig¶

DashboardMetaConfig¶

Hinweis:

• die App zeigt im Kopfbereich aktuell den Titel und direkt darunter eine kompakte Statuszeile
• diese Statuszeile enthält Datum + Uhrzeit der letzten Aktualisierung sowie Online oder die aktuelle Fehleranzahl

DashboardLayoutConfig¶

Hinweis:

• die Spaltenzahl wird zur Laufzeit mindestens auf 1 begrenzt
• der Zellwert wird aus Bildschirmbreite, Spaltenzahl und spacingDp berechnet
• im Reiter Optik können portraitColumns und landscapeColumns lokal pro Gerät überschrieben werden
• bleibt ein Override leer, verwendet die App wieder den Wert aus der geladenen JSON

DashboardGroupConfig¶

Validierungsregeln:

• id darf nicht leer sein
• widthColumns muss mindestens 1 sein, wenn gesetzt
• highlightColor muss ein gültiger Hex-Farbwert wie #RRGGBB oder #AARRGGBB sein, wenn gesetzt
• borderColor muss ein gültiger Hex-Farbwert wie #RRGGBB oder #AARRGGBB sein, wenn gesetzt
• widgetIds darf nicht leer sein
• valueWidgetId muss, wenn gesetzt, auf ein Widget innerhalb derselben Gruppe zeigen
• alle in valuePattern referenzierten Widget-IDs müssen, wenn gesetzt, auf Widgets innerhalb derselben Gruppe zeigen
• Widgets dürfen nicht in mehreren Gruppen auftauchen

Kompatibilität:

• das alte Feld maxWidthDp wird beim Einlesen weiterhin akzeptiert
• für neu Konfigurationen sollte widthColumns verwendet werden
• wenn borderColor fehlt, verwendet die App zuerst highlightColor und danach die globale Theme-Farbe groupHighlight
• bei expandable: true erscheint die Gruppe im Haupt-Dashboard immer als 1/1 Kachel; das Popup nutzt dieselbe Widgetgrösse wie das Haupt-Grid und höchstens fünf Spalten
• ist bei einer expandierbaren Gruppe widthColumns explizit gesetzt, begrenzt dieser Wert das Popup zusätzlich
• wenn valueWidgetId gesetzt ist, rendert die eingeklappte Kachel den bereits aufgelösten value dieses Widgets unter dem Gruppen-Icon
• wenn valuePattern gesetzt ist, rendert die eingeklappte Kachel dieses Template mit den aufgelösten value-Texten der darin referenzierten Widget-IDs; die benötigten IDs werden direkt aus den Platzhaltern extrahiert

DashboardGroupIconConfig¶

Editor-Hinweise¶

Für Gruppen und Reiter bietet die App zusätzlich Wizard-Schritte mit strukturierter Bearbeitung:

• Grunddaten und Inhalt sind auf Karten aufgeteilt
• Icon-Felder besitzen eine suchbare Iconauswahl
• Farbfelder besitzen einen Color-Picker mit optionaler Rückkehr zum Standardwert
• im ersten Schritt können Gruppen und Reiter direkt mit Bestätigungsdialog gelöscht werden

DashboardTabConfig¶

Verhalten:

• wenn groupIds und widgetIds beide leer sind, zeigt der Tab automatisch alle ungruppierten Widgets und alle Gruppen
• Tabs werden nach order, danach nach title, danach nach id sortiert
• innerhalb eines Tabs darf ein Widget nicht gleichzeitig direkt und über eine Gruppe referenziert sein

DashboardDefaultsConfig¶

SharedStatusRequestConfig¶

Laufzeitverhalten:

• pro Aktualisierungszyklus wird jeder referenzierte Shared-Request genau einmal ausgeführt
• alle Widgets mit derselben sharedRequestId lesen anschliessend aus derselben Antwort

RequestDefaultsConfig¶

Merge-Regel:

• die finalen Header ergeben sich aus defaults.request.headers + request.headers
• falls kein Accept gesetzt ist, fügt die App automatisch application/json, image/png, image/jpeg hinzu

Beispiel¶

{
  "dashboard": {
    "title": "Mein Smart Home",
    "defaultTabId": "home",
    "layout": {
      "portraitColumns": 4,
      "landscapeColumns": 6,
      "spacingDp": 14,
      "contentPaddingDp": 16,
      "cornerRadiusDp": 26
    },
    "groups": [
      {
        "id": "living-room-controls",
        "title": "Wohnzimmer",
        "order": 14,
        "expandable": true,
        "icon": {
          "name": "light",
          "sizeDp": 28
        },
        "valueWidgetId": "living-room-light",
        "highlightColor": "#C88A43",
        "borderColor": "#8A4A17",
        "widgetIds": [
          "living-room-light",
          "living-room-dimmer"
        ]
      }
    ],
    "tabs": [
      {
        "id": "home",
        "title": "Zuhause",
        "order": 10,
        "groupIds": [
          "living-room-controls"
        ]
      }
    ]
  }
}

Siehe auch¶

• Tabs, Gruppen und Grid
• Status und Requests