Limbajul .xu
Formatul de blocuri în care este scris fiecare fișier sursă .xu și cele unsprezece elemente de bază din care este făcut un proiect.
Un fișier .xu este un fișier de blocuri, nu un modul JavaScript. Fiecare bloc se ocupă de un singur aspect, iar
blocurile de tip obiect (<meta>, <params>, <fields>, <actions>, <events>, <datasource>) sunt parsate ca
literali în stil JSON5: chei fără ghilimele, array-uri și obiecte imbricate sunt toate în regulă.
Unsprezece elemente de bază
Folderul în care se află un fișier sursă decide în ce fel de unitate se compilează. O aplicație Xu bună se citește de obicei mai clar când fiecare aspect are propria unitate, în loc să facă un singur fișier totul.
App.xu este singurul fișier rezervat: este întotdeauna aplicația rădăcină și se compilează întotdeauna la id-ul de program
app. Pentru un fișier component, id-ul se rezolvă în ordine din meta.id, apoi mount.id, apoi
numele de bază al fișierului. Orice alt tip de unitate nu are bloc <mount>, deci id-ul ei se rezolvă din
meta.id, apoi din numele de bază al fișierului. Pentru resursele JSON5 ordinea este id, apoi _id, apoi
numele de bază. Id-urile duplicate într-un proiect nu sunt permise.
Blocuri pe tip de unitate
App.xu nu are niciodată nevoie de un bloc <mount>. O componentă obișnuită are nevoie de unul doar când vrei ca ea să fie
montată direct într-o pagină HTML, în loc să fie accesată prin <panel program="...">:
Limbajul de template
În interiorul <template>, un mic set de alias-uri prietenoase se compilează în markup-ul xu-* propriu al
runtime-ului.
O componentă, de la cap la coadă
<script> se compilează într-un modul de montare pe client: exportul implicit primește un obiect de context
și poate returna o funcție de eliberare, care rulează la descărcare. Blocurile <style> sunt colectate într-un singur
stylesheet servit al componentei.
Formatul datasource
Folosește forma de wrapper lizibilă în interiorul <datasource lang="json5">. type este una dintre none, table,
array, json sau csv.
Un datasource de tip tabel folosește table, filter, sort, direction, realtime, limit, skip și
output. Un datasource de tip array, JSON sau CSV folosește source.field sau source.url. Pentru orice cheie
de datasource pe care forma wrapper nu o expune, treci la mode="raw" și scrie numele de câmp pe care le folosește
chiar documentul de runtime.
Celelalte zece blocuri, pe scurt
Citiri cu nume, reutilizabile. data/get/LoadStudentClasses.xu asociază <params> (câmpuri in/out
declarate) cu un <datasource>, așa că o componentă apelează un încărcător pe nume, în loc să dețină ea
detaliile interogării.
Scrieri cu nume. data/set/SaveStudentProfile.xu adaugă crudMode și allowCreate la <meta>,
alături de params și datasource, oferind persistenței un loc vizibil și testabil în sursă.
Procesare înregistrare cu înregistrare. data/batch/RebuildClassRoster.xu rulează un pas <events>, cum ar fi
before_record, pe fiecare rând pe care îl rezolvă <datasource>.
Un bloc <response> transformă params, rezultatele datasource și evenimentele într-un payload în stil JSON:
O transformare cu nume, reutilizabilă. <code> rulează ca un corp de funcție peste parametrii in declarați și
returnează valoarea out:
O definiție de mesaj reutilizabilă, referențiată dintr-un flux de lucru în loc să fie scrisă inline de fiecare dată:
Rutele descriu cum sunt prezentate componentele ca aplicație navigabilă; nu înlocuiesc componentele în sine.
Un exemplu complet
xuda-studant-app-example este un arbore sursă complet care acoperă toate cele unsprezece blocuri: un flux de conectare, un
tablou de bord cu rute, ecrane de listă de studenți, sarcini și profil, citiri și scrieri pe tabele și
stilizare Tailwind. Despachetează-l cu:
Tot ce este mai sus este dialectul interpretat pe care îl compilează xuda-cli: blocuri parsate la salvare în
documente de runtime progUi / progFields / progEvents, citite de renderer-ul platformei, condus de expresii. Un
compilator separat, nepublicat (@xuda/compiler, folosit de vite-plugin-xu), citește un fișier .xu mai
restrâns, format doar din <template>, <script> și <style>, ignoră numele de blocuri de mai
sus și emite din timp un modul ES real, în loc de un document JSON. Vizează renderer-ul mai nou bazat pe
semnale din @xuda/core, același motor pe care platforma îl livrează ca
runtime/js/xuda_core.globals.js. Vezi vite-plugin-xu și
@xuda/core pentru acea cale.