Zum Inhalt springen
Geprüft

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 ist ein Legacy-Flag, keine aktive Eigenschaft

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.

json
{ "id": "ui-…", "type": "element", "tagName": "xu-panel", "attributes": { "program": "392_cmp_child…", "xu-exp:order_id_in": "@selected_order_v" } }

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.

xml
<meta lang="json5">
{
  id: "user_profile_card",
  menuTitle: "User Profile Card",
  uiFramework: "@xuda.io/xuda-framework-plugin-tailwind"
}
</meta>

<params lang="json5">
{
  in: { user_name_in: "string", user_role_in: "string" }
}
</params>

<template>
  <single-view>
    <aside class="user-card">
      <div class="avatar" :content="(@user_name_in || 'A').substring(0, 1)"></div>
      <h3 :content="@user_name_in"></h3>
      <p :content="@user_role_in"></p>
    </aside>
  </single-view>
</template>

<style>
.user-card { display: grid; gap: 0.75rem; padding: 1rem; border-radius: 1.2rem; }
</style>

.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.

json
{
  "properties": { "menuType": "component", "menuName": "Student Card", "rwMode": "U", "allowCreate": false },
  "progUi": [
    { "id": "root", "type": "element", "tagName": "xu-template", "attributes": {}, "children": [] }
  ],
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "STU_Student_Id", "type": "table" }, "props": { "fieldType": "string" } }
  ],
  "progEvents": [
    { "id": "d4e5f6a7-…", "data": { "type": "on_load", "parameters": [], "condition": "" }, "workflow": [] }
  ]
}