Die .xu-Sprache
Das Blockformat, in dem jede .xu-Quelldatei geschrieben ist, und die elf Bausteine, aus denen ein Projekt besteht.
Eine .xu-Datei ist eine Blockdatei, kein JavaScript-Modul. Jeder Block ist ein Anliegen, und die Objektblöcke (<meta>, <params>, <fields>, <actions>, <events>, <datasource>) werden als Literale im JSON5-Stil geparst: Schlüssel ohne Anführungszeichen, Arrays und verschachtelte Objekte sind alle in Ordnung.
Elf Bausteine
Der Ordner, in dem eine Quelldatei liegt, bestimmt, zu welcher Art Einheit sie kompiliert wird. Eine gute Xu-App liest sich meist klarer, wenn jedes Anliegen seine eigene Einheit bekommt, statt dass eine Datei alles tut.
App.xu ist die eine reservierte Datei: Sie ist immer die Stamm-App und kompiliert immer zur Programm-ID app. Bei einer component-Datei wird die ID der Reihe nach aus meta.id, dann mount.id, dann dem eigenen Basisnamen der Datei aufgelöst. Jede andere Einheitenart hat keinen <mount>-Block, ihre ID wird also aus meta.id, dann dem eigenen Basisnamen der Datei aufgelöst. Bei den JSON5-Ressourcen lautet die Reihenfolge id, dann _id, dann Basisname. Doppelte IDs in einem Projekt sind nicht erlaubt.
Blöcke nach Einheitenart
App.xu braucht nie einen <mount>-Block. Eine gewöhnliche Komponente braucht nur dann einen, wenn du sie direkt in eine HTML-Seite einhängen willst, statt sie über <panel program="..."> zu erreichen:
Die Template-Sprache
Innerhalb von <template> kompiliert eine kleine Menge freundlicher Aliase zum eigenen xu-*-Markup der Laufzeit.
Eine Komponente von Anfang bis Ende
<script> kompiliert zu einem clientseitigen Mount-Modul: Der Default-Export erhält ein Kontextobjekt und kann eine Disposer-Funktion zurückgeben, die beim Entladen läuft. <style>-Blöcke werden zu einem ausgelieferten Komponenten-Stylesheet gesammelt.
Datasource-Format
Verwende innerhalb von <datasource lang="json5"> die lesbare Wrapper-Form. type ist eines von none, table, array, json oder csv.
Eine Tabellen-Datasource verwendet table, filter, sort, direction, realtime, limit, skip und output. Eine Array-, JSON- oder CSV-Datasource verwendet source.field oder source.url. Für jeden Datasource-Schlüssel, den die Wrapper-Form nicht bereitstellt, wechsle zu mode="raw" und schreibe die Feldnamen, die das Laufzeitdokument selbst verwendet.
Die anderen zehn Blöcke, kurz
Benannte, wiederverwendbare Lesevorgänge. data/get/LoadStudentClasses.xu kombiniert <params> (deklarierte in/out-Felder) mit einer <datasource>, sodass eine Komponente einen Loader über seinen Namen aufruft, statt die Abfragedetails selbst zu besitzen.
Benannte Schreibvorgänge. data/set/SaveStudentProfile.xu fügt <meta> neben den Parametern und der Datasource crudMode und allowCreate hinzu und gibt der Persistenz damit ein sichtbares, testbares Zuhause im Quelltext.
Datensatzweise Verarbeitung. data/batch/RebuildClassRoster.xu führt einen <events>-Schritt wie before_record für jede Zeile aus, die die <datasource> liefert.
Ein <response>-Block macht aus Parametern, Datasource-Ergebnissen und Events eine Nutzlast im JSON-Stil:
Eine benannte, wiederverwendbare Transformation. <code> läuft als Funktionsrumpf über den deklarierten in-Parametern und gibt den out-Wert zurück:
Eine wiederverwendbare Nachrichtendefinition, auf die ein Workflow verweist, statt dass sie jedes Mal inline geschrieben wird:
Routen beschreiben, wie Komponenten als navigierbare App dargestellt werden; sie ersetzen die Komponenten selbst nicht.
Ein vollständiges Beispiel
xuda-studant-app-example ist ein vollständiger Quellbaum, der alle elf Bausteine abdeckt: einen Login-Ablauf, ein geroutetes Dashboard, Schülerliste, Aufgaben- und Profilbildschirme, tabellengestützte Lese- und Schreibvorgänge und Tailwind-Styling. Entpacke es mit:
Alles oben Beschriebene ist der interpretierte Dialekt, den xuda-cli kompiliert: Blöcke, die beim Speichern zu Laufzeitdokumenten progUi / progFields / progEvents geparst und vom ausdrucksgesteuerten Renderer der Plattform gelesen werden. Ein separater, unveröffentlichter Compiler (@xuda/compiler, verwendet von vite-plugin-xu) liest eine schmalere .xu-Datei, die nur aus <template>, <script> und <style> besteht, ignoriert die oben genannten Blocknamen und gibt vorab ein echtes ES-Modul statt eines JSON-Dokuments aus. Er zielt auf den neueren Signals-basierten Renderer in @xuda/core, dieselbe Engine, die die Plattform als runtime/js/xuda_core.globals.js ausliefert. Siehe vite-plugin-xu und @xuda/core für diesen Weg.