De .xu-taal
Het blokformaat waarin elk .xu-bronbestand is geschreven, en de elf bouwstenen waaruit een project bestaat.
Een .xu-bestand is een blokbestand, geen JavaScript-module. Elk blok is één onderwerp, en de
objectblokken (<meta>, <params>, <fields>, <actions>, <events>, <datasource>) worden
geparsed als literals in JSON5-stijl: ongequote sleutels, arrays en geneste objecten zijn allemaal
prima.
Elf bouwstenen
De map waarin een bronbestand staat, bepaalt naar welk soort eenheid het compileert. Een goede Xu-app leest meestal duidelijker als elk onderwerp een eigen eenheid krijgt in plaats van één bestand dat alles doet.
App.xu is het enige gereserveerde bestand: het is altijd de root-app en compileert altijd naar
de programma-id app. Voor een component-bestand wordt de id opgelost in deze volgorde: eerst
meta.id, dan mount.id, dan de eigen bestandsnaam zonder extensie. Elk ander eenheidstype heeft
geen <mount>-blok, dus de id komt van meta.id en daarna van de eigen bestandsnaam zonder
extensie. Voor de JSON5-resources is de volgorde id, dan _id, dan de bestandsnaam zonder
extensie. Dubbele id's binnen een project zijn niet toegestaan.
Blokken per eenheidstype
App.xu heeft nooit een <mount>-blok nodig. Een gewone component heeft er alleen een nodig als
je hem rechtstreeks in een HTML-pagina wilt mounten in plaats van hem te bereiken via
<panel program="...">:
De templatetaal
Binnen <template> compileert een kleine set handige aliassen naar de eigen xu-*-markup van de
runtime.
Een component, van begin tot eind
<script> compileert naar een client-side mountmodule: de default export krijgt een contextobject
en mag een disposer-functie teruggeven die bij het verwijderen wordt uitgevoerd. <style>-blokken
worden verzameld in één geserveerde componentstylesheet.
Datasource-formaat
Gebruik de leesbare wrapper-vorm binnen <datasource lang="json5">. type is none, table,
array, json of csv.
Een tabeldatasource gebruikt table, filter, sort, direction, realtime, limit, skip en
output. Een array-, JSON- of CSV-datasource gebruikt source.field of source.url. Voor een
datasource-sleutel die de wrapper-vorm niet aanbiedt, schakel je over naar mode="raw" en schrijf
je de veldnamen die het runtimedocument zelf gebruikt.
De andere tien blokken, in het kort
Benoemde, herbruikbare leesacties. data/get/LoadStudentClasses.xu koppelt <params> (gedeclareerde
in/out-velden) aan een <datasource>, zodat een component een loader bij naam aanroept in
plaats van zelf de querydetails te beheren.
Benoemde schrijfacties. data/set/SaveStudentProfile.xu voegt crudMode en allowCreate toe aan
<meta>, naast de params en de datasource, zodat persistentie een zichtbare, testbare plek in de
broncode krijgt.
Verwerking record voor record. data/batch/RebuildClassRoster.xu voert een <events>-stap zoals
before_record uit voor elke rij die de <datasource> oplevert.
Een <response>-blok maakt van params, datasource-resultaten en events een payload in JSON-stijl:
Een benoemde, herbruikbare transformatie. <code> wordt uitgevoerd als functiebody over de
gedeclareerde in-params en geeft de out-waarde terug:
Een herbruikbare berichtdefinitie, waarnaar een workflow verwijst in plaats van dat je hem elke keer inline schrijft:
Routes beschrijven hoe componenten worden gepresenteerd als een navigeerbare app; ze vervangen de componenten zelf niet.
Een volledig voorbeeld
xuda-studant-app-example is een complete bronboom die alle elf bouwstenen dekt: een loginflow,
een dashboard met routes, studentenlijst, taken- en profielschermen, lees- en schrijfacties op
tabellen en Tailwind-styling. Pak hem uit met:
Alles hierboven is het geïnterpreteerde dialect dat xuda-cli compileert: blokken die bij het
opslaan worden geparsed tot runtimedocumenten progUi / progFields / progEvents, gelezen door
de expressiegedreven renderer van het platform. Een aparte, niet gepubliceerde compiler
(@xuda/compiler, gebruikt door vite-plugin-xu) leest een smaller .xu-bestand dat alleen uit
<template>, <script> en <style> bestaat, negeert de bloknamen hierboven en levert vooraf een
echte ES-module op in plaats van een JSON-document. Hij richt zich op de nieuwere, op signals
gebaseerde renderer in @xuda/core, dezelfde engine die het platform meelevert als
runtime/js/xuda_core.globals.js. Zie vite-plugin-xu en
@xuda/core voor dat pad.