Wolkenwald
PurePower Engine · Bauen

XUI-Oberflächen

Mit XUI-Oberflächen beschreiben Plugins ihre Bildschirme, statt sie zu programmieren: Listen, Formulare und Detailseiten stehen als kurze XML-Dateien im Plugin, und die PurePower Engine macht daraus die fertige Oberfläche — mit Suche, Filtern, Blättern, Rechten, Übersetzung, Handy-Ansicht, Themes und dunklem Modus. Das Prinzip: Das Schema (XSD) beschreibt die Daten, XUI die Darstellung, XML die Werte.

XUI-Liste der Ressourcen mit Werkzeugleiste, Filtern und Tabelle

Eine Liste aus der Reservierung: Werkzeugleiste, Suche, Filter, Tabelle und Aktionen — alles aus der XUI-Datei unten, ohne eigenes HTML.

Eine Liste in wenigen Zeilen

So sieht die Beschreibung dieser Liste im Plugin aus (gekürzt):

<view title="@liste.ressourcen" leer="@liste.ressourcen_leer">
  <toolbar>
    <button label="@liste.buchen" href="/admin/reservierung/buchen"
            data-pp-s="986a1b7135f4" data-pp-stil-wert="primary" requires_permission="reservierung:buchen"/>
  </toolbar>
  <filter bind="name" label="@liste.suche" widget="text" column="r.name" operator="LIKE"/>
  <col name="name" label="@feld.name" link="/admin/reservierung/r/{id}" karte="titel"/>
  <col name="art"  label="@feld.art" render="badge"
       werte="raum:@art.raum,fahrzeug:@art.fahrzeug" karte="abzeichen"/>
  <col name="ort"  label="@feld.ort" karte="untertitel"/>
  <actions edit="/admin/reservierung/ressourcen/{id}/edit"/>
</view>

Die Daten kommen aus einer PPQL-Abfrage im Manifest oder direkt vom Plugin, etwa wenn sie nicht aus einer Datenbank stammen. Suche, Sortierung, Zählung und Blättern übernimmt das Rahmenwerk. Texte mit @ sind Schlüssel der Sprachdateien des Plugins; so erscheint dieselbe Liste in jeder Sprache.

Listen

  • Spalten mit Verweis auf die Detailseite, als Abzeichen oder Farbe, mit übersetzten Werten statt Rohwerten; ausgeblendete Spalten lassen sich über „Alle Spalten“ einblenden.
  • Filter und Suche, Wahl der Anzahl je Seite, Umschalten zwischen Tabelle und Karten.
  • Werkzeugleiste und Aktionen mit Rechten: ohne Recht kein Knopf. Bearbeiten und Löschen können je Zeile erlaubt oder gesperrt sein, Löschen fragt nach.
  • Sicht nach Rechten: Das Rahmenwerk filtert nach Projekt- und Rollenzuweisungen, oder das Plugin regelt die Sicht selbst.
Dieselbe Liste am Handy als Karten
Am Handy wird dieselbe Liste zu Karten. Wie eine Karte aussieht, legt das Attribut karte= der Spalten fest.

Formulare und Detailseiten

  • Aufbau aus Abschnitten, Spalten und Reitern; Felder werden an das Schema gebunden, das Eingabeelement folgt aus dem Datentyp oder wird gewählt.
  • Eingabeelemente von Text, Zahl, Datum und Zeit über Auswahl, Mehrfachauswahl, Schalter, Farbe und Datei bis zu Editoren für formatierten Text, Markdown, Code, JSON und XML.
  • Felder vom Plugin: Hängen Felder oder Auswahllisten von Rechten oder anderen Eingaben ab, liefert das Plugin sie zur Laufzeit; gespeichert wird über einen Handler des Plugins. Fehler führen zurück ins Formular, die Eingaben bleiben erhalten.
  • Bedingte Sichtbarkeit und Rechte je Abschnitt oder Feld, auch abhängig vom Zustand eines Workflows.
  • Listen in Seiten: Eine Liste lässt sich mit einer Marke in eine Detailseite oder ein Formular einbetten, voll oder kompakt mit einigen Zeilen und „Mehr“-Verweis.

Widgets aus Plugins

Was über Felder und Listen hinausgeht — Diagramme, Kanban-Tafeln, Kurven, PDF-Anzeige, Bildbearbeitung — kommt als XUI-Widget. Widgets sind Web-Komponenten, die ein Plugin mit ihren Eigenschaften, Aktionen und Dateien im Manifest anmeldet; die Engine lädt sie bei Bedarf und prüft ihre Dateien über Prüfsummen. Die verfügbaren Bausteine stehen unter XUI-Bausteine.

Themes, Kontrast und Anpassung

XUI-Oberflächen verwenden ausschliesslich die Farb- und Grössenwerte des aktiven Designs. Darum passen sie ohne Zutun zu jedem Theme und zum hellen wie dunklen Modus.

Auswahl der Vorlagen klar, kompakt und kontrast in der Theme-Verwaltung
Die Theme-Verwaltung: Vorlagen und eigene Themes, die nur einzelne Werte überschreiben.
  • Drei Vorlagen: klar, kompakt für dichte Arbeitsansichten und kontrast für hohen Kontrast, mit gut lesbaren Schriften (IBM Plex, Atkinson Hyperlegible).
  • Wählbar für die ganze Anlage und je Benutzer, hell, dunkel oder wie das Gerät.
  • Anpassen ohne Code: Im System-UI-Editor der Verwaltung lassen sich die XUI-Beschreibungen von Rahmenwerk und Plugins einsehen und anpassen, global oder je Mandant.

Auch die Formulare für Einreichungen beruhen auf Schemas — mehr dazu unter Formulare und XSD. Zurück zur PurePower Engine.

Kontakt

Fragen zu XUI-Oberflächen?

Wir zeigen es Ihnen gern oder beraten Sie zu Lizenz, Hosting und Betrieb.