Jazyk .xu
Blokový formát, ve kterém se píše každý zdrojový soubor .xu, a jedenáct stavebních bloků, z nichž se projekt skládá.
Soubor .xu je blokový soubor, ne modul JavaScriptu. Každý blok řeší jednu věc a objektové bloky
(<meta>, <params>, <fields>, <actions>, <events>, <datasource>) se parsují jako
literály ve stylu JSON5: klíče bez uvozovek, pole i vnořené objekty jsou v pořádku.
Jedenáct stavebních bloků
Složka, ve které zdrojový soubor leží, určuje, na jaký druh jednotky se zkompiluje. Aplikace Xu bývá přehlednější, když každá věc dostane vlastní jednotku místo toho, aby jeden soubor dělal všechno.
App.xu je jediný vyhrazený soubor: je vždy kořenovou aplikací a vždy se kompiluje na id programu
app. U souboru typu component se id určí v pořadí z meta.id, pak z mount.id, pak z vlastního
základu názvu souboru. Každý jiný typ jednotky nemá blok <mount>, takže jeho id se určí z meta.id
a poté ze základu názvu souboru. U zdrojů JSON5 je pořadí id, pak _id, pak základ názvu.
Duplicitní id v rámci projektu nejsou povolena.
Bloky podle typu jednotky
App.xu blok <mount> nikdy nepotřebuje. Běžná komponenta ho potřebuje jen tehdy, když ji chcete
připojit přímo do stránky HTML místo dosažení přes <panel program="...">:
Jazyk šablon
Uvnitř <template> se malá sada přívětivých aliasů kompiluje do vlastního značení xu-* runtime.
Komponenta od začátku do konce
<script> se kompiluje do klientského modulu pro připojení: výchozí export dostane objekt
kontextu a může vrátit funkci pro uvolnění, která se spustí při odpojení. Bloky <style> se
sbírají do jednoho servírovaného stylu komponenty.
Formát zdroje dat
Uvnitř <datasource lang="json5"> používejte čitelnou obalovou formu. type je jedno z none,
table, array, json nebo csv.
Zdroj dat typu tabulka používá table, filter, sort, direction, realtime, limit, skip
a output. Zdroj dat typu pole, JSON nebo CSV používá source.field nebo source.url. Pro každý
klíč zdroje dat, který obalová forma nezpřístupňuje, přepněte na mode="raw" a pište názvy polí,
které používá samotný runtime dokument.
Zbývajících deset bloků stručně
Pojmenovaná, opakovaně použitelná čtení. data/get/LoadStudentClasses.xu spojuje <params>
(deklarovaná pole in/out) s <datasource>, takže komponenta volá načítač jménem a sama
nevlastní podrobnosti dotazu.
Pojmenované zápisy. data/set/SaveStudentProfile.xu přidává do <meta> crudMode
a allowCreate vedle parametrů a zdroje dat, čímž dává ukládání viditelné a testovatelné místo
ve zdroji.
Zpracování záznam po záznamu. data/batch/RebuildClassRoster.xu spouští krok <events>, například
before_record, na každém řádku, který <datasource> vrátí.
Blok <response> mění parametry, výsledky zdroje dat a události v datovou strukturu ve stylu JSON:
Pojmenovaná, opakovaně použitelná transformace. <code> běží jako tělo funkce nad deklarovanými
parametry in a vrací hodnotu out:
Opakovaně použitelná definice zprávy, na kterou se odkazuje z workflow, místo aby se pokaždé psala přímo:
Trasy popisují, jak se komponenty prezentují jako navigovatelná aplikace; samotné komponenty nenahrazují.
Úplný příklad
xuda-studant-app-example je kompletní zdrojový strom pokrývající všech jedenáct bloků: tok
přihlášení, směrovaný přehled, seznam studentů, obrazovky úkolů a profilu, čtení a zápisy nad
tabulkami a styly Tailwind. Rozbalte ho takto:
Vše výše je interpretovaný dialekt, který kompiluje xuda-cli: bloky parsované při uložení do
runtime dokumentů progUi / progFields / progEvents, které čte renderer platformy řízený
výrazy. Samostatný, nepublikovaný kompilátor (@xuda/compiler, používaný vite-plugin-xu) čte
užší soubor .xu složený jen z <template>, <script> a <style>, názvy bloků výše ignoruje
a místo dokumentu JSON předem vytváří skutečný modul ES. Míří na novější renderer založený na
signálech v @xuda/core, tentýž engine, který platforma dodává jako
runtime/js/xuda_core.globals.js. Pro tuto cestu viz vite-plugin-xu
a @xuda/core.