Xu-språket
Blokkformatet hver .xu-kildefil er skrevet i, og de elleve byggeklossene et prosjekt er laget av.
En .xu-fil er en blokkfil, ikke en JavaScript-modul. Hver blokk er ett ansvarsområde, og
objektblokkene (<meta>, <params>, <fields>, <actions>, <events>, <datasource>) tolkes som
JSON5-lignende literaler: nøkler uten anførselstegn, matriser og nøstede objekter er alle greit.
Elleve byggeklosser
Mappen en kildefil ligger i avgjør hvilken type enhet den kompileres til. En god Xu-app er ofte tydeligere når hvert ansvarsområde får sin egen enhet i stedet for at én fil gjør alt.
App.xu er den ene reserverte filen: den er alltid rotappen og kompileres alltid til program-ID-en
app. For en component-fil løses ID-en i rekkefølge fra meta.id, så mount.id, så filens eget
basisnavn. Alle andre enhetstyper har ingen <mount>-blokk, så ID-en deres løses fra meta.id, så
filens eget basisnavn. For JSON5-ressursene er rekkefølgen id, så _id, så basisnavn. Like ID-er
i samme prosjekt er ikke tillatt.
Blokker per enhetstype
App.xu trenger aldri en <mount>-blokk. En vanlig komponent trenger bare en når du vil at den
skal monteres direkte i en HTML-side i stedet for å nås gjennom <panel program="...">:
Malspråket
Inne i <template> kompileres et lite sett med vennlige aliaser ned til kjøretidens egen
xu-*-markup.
En komponent fra start til slutt
<script> kompileres til en monteringsmodul på klientsiden: standard-eksporten får et kontekstobjekt
og kan returnere en funksjon som rydder opp når siden lukkes. <style>-blokker samles i ett
stilark som serveres for komponenten.
Datakildeformat
Bruk den lesbare innpakningsformen inne i <datasource lang="json5">. type er én av none,
table, array, json eller csv.
En tabelldatakilde bruker table, filter, sort, direction, realtime, limit, skip og
output. En matrise-, JSON- eller CSV-datakilde bruker source.field eller source.url. For
datakildenøkler innpakningsformen ikke viser, bytt til mode="raw" og skriv feltnavnene som
kjøretidsdokumentet selv bruker.
De ti andre blokkene, kort fortalt
Navngitte, gjenbrukbare lesinger. data/get/LoadStudentClasses.xu kombinerer <params> (deklarerte
in/out-felt) med en <datasource>, så en komponent kaller en laster ved navn i stedet for å
eie spørringsdetaljene selv.
Navngitte skrivinger. data/set/SaveStudentProfile.xu legger crudMode og allowCreate til i
<meta> ved siden av parameterne og datakilden, og gir lagring et synlig, testbart hjem i
kilden.
Behandling post for post. data/batch/RebuildClassRoster.xu kjører et <events>-trinn som
before_record mot hver rad <datasource> gir.
En <response>-blokk gjør parametere, datakilderesultater og hendelser om til en nyttelast i
JSON-stil:
En navngitt, gjenbrukbar transformasjon. <code> kjører som en funksjonskropp over de deklarerte
in-parameterne og returnerer out-verdien:
En gjenbrukbar meldingsdefinisjon som refereres fra en arbeidsflyt i stedet for å skrives inline hver gang:
Ruter beskriver hvordan komponenter presenteres som en app man kan navigere i; de erstatter ikke selve komponentene.
Et fullstendig eksempel
xuda-studant-app-example er et komplett kildetre som dekker alle elleve blokkene: en påloggingsflyt,
et rutet dashbord, studentliste, oppgaver og profilskjermer, tabellbaserte lesinger og skrivinger,
og Tailwind-stil. Pakk det ut med:
Alt ovenfor er den tolkede dialekten xuda-cli kompilerer: blokker som tolkes ved lagring til
progUi / progFields / progEvents-kjøretidsdokumenter, lest av plattformens uttrykksdrevne
renderer. En separat, upublisert kompilator (@xuda/compiler, brukt av vite-plugin-xu) leser en
smalere .xu-fil som bare består av <template>, <script> og <style>, ignorerer blokknavnene
ovenfor, og sender ut en ekte ES-modul på forhånd i stedet for et JSON-dokument. Den retter seg mot
den nyere signalbaserte rendereren i @xuda/core, den samme motoren som plattformen leverer som
runtime/js/xuda_core.globals.js. Se vite-plugin-xu og
@xuda/core for den veien.