Il linguaggio .xu
Il formato a blocchi in cui è scritto ogni file sorgente .xu, e gli undici elementi di base di cui è fatto un progetto.
Un file .xu è un file a blocchi, non un modulo JavaScript. Ogni blocco è un singolo aspetto, e i blocchi oggetto (<meta>, <params>, <fields>, <actions>, <events>, <datasource>) vengono interpretati come letterali in stile JSON5: chiavi senza virgolette, array e oggetti annidati vanno tutti bene.
Undici elementi di base
La cartella in cui si trova un file sorgente decide in quale tipo di unità si compila. Un'app Xu ben fatta di solito è più chiara quando ogni aspetto ha la propria unità invece di un solo file che fa tutto.
App.xu è l'unico file riservato: è sempre l'app radice e si compila sempre nell'id di programma app. Per un file component l'id viene risolto in ordine da meta.id, poi da mount.id, poi dal nome base del file stesso. Ogni altro tipo di unità non ha un blocco <mount>, quindi il suo id viene risolto da meta.id, poi dal nome base del file stesso. Per le risorse JSON5 l'ordine è id, poi _id, poi il nome base. Gli id duplicati in un progetto non sono ammessi.
Blocchi per tipo di unità
App.xu non ha mai bisogno di un blocco <mount>. Un componente normale ne ha bisogno solo quando vuoi montarlo direttamente in una pagina HTML invece di raggiungerlo tramite <panel program="...">:
Il linguaggio dei template
Dentro <template>, un piccolo insieme di alias semplici si compila nel markup xu-* del runtime stesso.
Un componente, dall'inizio alla fine
<script> si compila in un modulo di montaggio lato client: l'export predefinito riceve un oggetto di contesto e può restituire una funzione di rimozione da eseguire allo scaricamento. I blocchi <style> vengono raccolti in un unico foglio di stile del componente che viene servito.
Formato del datasource
Usa la forma con wrapper leggibile dentro <datasource lang="json5">. type è uno tra none, table, array, json o csv.
Un datasource di tipo table usa table, filter, sort, direction, realtime, limit, skip e output. Un datasource di tipo array, JSON o CSV usa source.field o source.url. Per qualsiasi chiave del datasource che la forma con wrapper non espone, passa a mode="raw" e scrivi i nomi dei campi usati dal documento di runtime stesso.
Gli altri dieci blocchi, in breve
Letture con nome e riutilizzabili. data/get/LoadStudentClasses.xu abbina <params> (campi in/out dichiarati) a un <datasource>, così un componente chiama un loader per nome invece di occuparsi lui stesso dei dettagli della query.
Scritture con nome. data/set/SaveStudentProfile.xu aggiunge crudMode e allowCreate a <meta> insieme ai parametri e al datasource, dando alla persistenza una casa visibile e testabile nel sorgente.
Elaborazione record per record. data/batch/RebuildClassRoster.xu esegue un passaggio di <events> come before_record su ogni riga che il <datasource> risolve.
Un blocco <response> trasforma parametri, risultati del datasource ed eventi in un payload in stile JSON:
Una trasformazione con nome e riutilizzabile. <code> viene eseguito come corpo di funzione sui parametri in dichiarati e restituisce il valore out:
Una definizione di messaggio riutilizzabile, richiamata da un flusso di lavoro invece di essere scritta inline ogni volta:
Le route descrivono come i componenti vengono presentati come app navigabile; non sostituiscono i componenti stessi.
Un esempio completo
xuda-studant-app-example è un albero di sorgenti completo che copre tutti gli undici blocchi: un flusso di login, una dashboard con route, schermate di elenco studenti, attività e profilo, letture e scritture su tabelle e stile Tailwind. Estrailo con:
Tutto quanto sopra è il dialetto interpretato che xuda-cli compila: blocchi analizzati al salvataggio in documenti di runtime progUi / progFields / progEvents, letti dal renderer della piattaforma guidato dalle espressioni. Un compilatore separato e non pubblicato (@xuda/compiler, usato da vite-plugin-xu) legge un file .xu più ristretto composto solo da <template>, <script> e <style>, ignora i nomi dei blocchi sopra e produce in anticipo un vero modulo ES invece di un documento JSON. Ha come obiettivo il renderer più recente basato sui signal in @xuda/core, lo stesso motore che la piattaforma distribuisce come runtime/js/xuda_core.globals.js. Vedi vite-plugin-xu e @xuda/core per quel percorso.