Komponente
Die UI-Einheit, ein Elementbaum, gebunden an lokalen Zustand, Daten und die Workflow-Logik, die alles verbindet.
Eine Komponente ist eine UI-Einheit: ein Elementbaum, gebunden an lokalen Zustand, optionale Daten, Lebenszyklus-Logik und eine Eingabe- und Ausgabeschnittstelle. Eine Seite, eine Karte, ein Modal, ein Popover, ein Inline-Fragment, alles sind Komponenten, und sie ist der reichhaltigste Dokumenttyp der Plattform: Sie trägt ihren eigenen UI-Baum neben den Feldern, Ereignissen und der Datenquelle, die sie mit jedem anderen Programmtyp teilt.
Eigenschaften
renderType (form / grid / list) ist veraltet und nicht mehr erforderlich; neue Komponenten werden ohne es erstellt. Was eine neue Komponente tatsächlich bekommt, ist eine Gerüstwahl, single oder multi, einmal im Dialog Neue Komponente getroffen: single legt eine leere Wurzel xu-template an, bereit zum direkten Hineinbauen, multi legt dieselbe Wurzel xu-template mit einem Lade-div und einem bereits darin verschachtelten xu-multi-view an. xu-single-view ist weiterhin ein echtes, verfassbares Tag, nur keines, das die Factory für dich platziert: Nur ein nicht migriertes Legacy-Dokument (Wurzel noch nicht xu-template) wird dagegen geprüft, wenn sein veraltetes renderType noch form sagt.
progUi, der Elementbaum
Der Wurzelknoten ist immer ein transparentes xu-template, angelegt durch scaffold_prog_ui von create_prog. Die Gerüstwahl multi verschachtelt ein Lade-div und ein xu-multi-view für dich darin; das Gerüst single lässt es leer, baue direkt in seinen children. Jeder Knoten braucht eine eindeutige id, type: "element", einen tagName sowie attributes: {} und children: [], auch wenn sie leer sind.
Neben einfachen HTML-Tags werden einige xuda-Tags direkt verfasst: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.
Ein großgeschriebener tagName (Button, Dialog) wird immer als kompilierte Design-System-Komponente beansprucht, nie als HTML-Element, selbst wenn es ein Tippfehler ist: Er löst beim Einhängen einen Fehler aus, der das Tag und jede versuchte Quelle nennt. Seine einfachen Attribute werden zu Props, nicht zu DOM-Attributen (variant, color, class kommen alle als props.<name> an), und anders als xu-panel hat er keine Out-Parameter, ein Komponenten-Tag liest nur, was du ihm übergibst.
Dynamisches Verhalten: xu-*-Attribute
Jedes xu-*-Attribut, das der Elementbaum einer Komponente tragen kann:
Zwei lassen sich leicht verwechseln: xu-bind nimmt die nackte Feld-ID, ohne @, die eine Ausnahme von der @-Regel überall sonst; und xu-exp:class ersetzt das statische Attribut class vollständig, Layout-Klassen müssen also innerhalb des Ausdrucks wiederholt werden.
progFields, progEvents, progDataSource
Lokaler Zustand (progFields, virtual oder an table gebunden), eine optionale eingebettete Datenquelle und Lebenszyklus-Ereignisse. Drei dieser Ereignisse teilen die Arbeit so auf, dass man sie leicht verwechselt:
Aktualisierungsarbeit in screen_ready zu legen, führt die Erstellungslogik erneut gegen DOM aus, das noch existiert, und stapelt ein zweites Widget auf das erste.
Ein anderes Programm einbetten: xu-panel
xu-panel (kleingeschriebener tagName, Attribut program) hängt ein anderes Komponenten-Programm mit eigenen Feldern, eigener Datenquelle und eigenen Ereignissen ein, im Gegensatz zu einem großgeschriebenen Design-System-Tag. Übergib Werte an seine _in-Parameter mit xu-exp:<param>-Attributen; anders als ein Design-System-Tag kann ein Panel über seine _out-Parameter Werte in deine Felder zurückschreiben.
Praxisbeispiel
Die Form wählen
Wähle single im Dialog Neue Komponente für einen Datensatz: baue direkt in die Wurzel xu-template. Wähle multi für eine Liste: Es legt ein xu-multi-view in dieser Wurzel für dich an, füge xu-for (oder die .xu-Kurzform for=) am sich wiederholenden Knoten hinzu.
Die Daten binden
xu-bind für Eingaben, xu-exp:xu-content für berechneten Text, ein progDataSource, wenn die Komponente ihren eigenen Lesezugriff besitzt.
Die Interaktion verdrahten
xu-on:click mit einem Workflow oder in .xu ein benannter Aktionsblock, der mit @click referenziert wird.
Baue den Baum auf der Arbeitsfläche: Ziehe Elemente, setze Attribute im Eigenschaften-Panel, verdrahte xu-on:*-Handler im Workflow-Editor mit Workflow-Schritten. Drücke die Play-Schaltfläche der Vorschau, um das Ergebnis live zu prüfen.
.xu kompiliert <single-view> zu xu-single-view, :content zu einem Ausdruck xu-exp:xu-content und ein nacktes Attribut for="@list_v" zu xu-for.