.xu-kieli
Lohkomuoto, jolla jokainen .xu-lähdetiedosto kirjoitetaan, ja yksitoista rakennuspalikkaa, joista projekti koostuu.
.xu-tiedosto on lohkotiedosto, ei JavaScript-moduuli. Kukin lohko on yksi asia, ja oliolohkot
(<meta>, <params>, <fields>, <actions>, <events>, <datasource>) jäsennetään
JSON5-tyylisinä literaaleina: lainaukseton avain, taulukot ja sisäkkäiset oliot kelpaavat kaikki.
Yksitoista rakennuspalikkaa
Kansio, jossa lähdetiedosto sijaitsee, määrää, minkälaiseksi yksiköksi se kääntyy. Hyvä Xu-sovellus on yleensä selkeämpi, kun jokainen asia saa oman yksikkönsä sen sijaan, että yksi tiedosto tekisi kaiken.
App.xu on ainoa varattu tiedosto: se on aina juurisovellus ja kääntyy aina ohjelmatunnisteeksi
app. component-tiedostolle tunniste ratkaistaan järjestyksessä arvosta meta.id, sitten
mount.id, sitten tiedoston oma perusnimi. Mikään muu yksikkötyyppi ei sisällä <mount>-lohkoa,
joten sen tunniste ratkaistaan arvosta meta.id ja sitten tiedoston omasta perusnimestä. JSON5-resursseille
järjestys on id, sitten _id, sitten perusnimi. Päällekkäiset tunnisteet projektissa eivät
ole sallittuja.
Lohkot yksikkötyypeittäin
App.xu ei koskaan tarvitse <mount>-lohkoa. Tavallinen komponentti tarvitsee sellaisen vain, kun
haluat liittää sen suoraan HTML-sivulle sen sijaan, että siihen päästäisiin <panel program="...">:n
kautta:
Mallikieli
<template>:n sisällä pieni joukko ystävällisiä aliaksia kääntyy suoritusympäristön omaksi
xu-*-merkinnäksi.
Komponentti alusta loppuun
<script> kääntyy asiakaspuolen liitosmoduuliksi: oletusvienti saa kontekstiolion ja voi palauttaa
hävitysfunktion, joka ajetaan purettaessa. <style>-lohkot kerätään yhdeksi tarjoiltavaksi
komponentin tyylitiedostoksi.
Datalähteen muoto
Käytä luettavaa kääremuotoa <datasource lang="json5">:n sisällä. type on yksi arvoista none,
table, array, json tai csv.
Taulun datalähde käyttää avaimia table, filter, sort, direction, realtime, limit, skip
ja output. Array-, JSON- tai CSV-datalähde käyttää avainta source.field tai source.url. Jos
tarvitset datalähteen avaimen, jota kääre ei tarjoa, siirry tilaan mode="raw" ja kirjoita kenttien
nimet sellaisina kuin suoritusaikainen dokumentti itse niitä käyttää.
Muut kymmenen lohkoa lyhyesti
Nimetyt, uudelleenkäytettävät lukemiset. data/get/LoadStudentClasses.xu yhdistää <params>:n
(ilmoitetut in/out-kentät) ja <datasource>:n, joten komponentti kutsuu lataajaa nimellä sen
sijaan, että omistaisi kyselyn yksityiskohdat itse.
Nimetyt kirjoitukset. data/set/SaveStudentProfile.xu lisää crudMode- ja allowCreate-arvot
<meta>:an parametrien ja datalähteen rinnalle, antaen tallennukselle näkyvän, testattavan kodin
lähteessä.
Tietue kerrallaan -käsittely. data/batch/RebuildClassRoster.xu ajaa <events>-vaiheen, kuten
before_record, jokaiselle riville, jonka <datasource> ratkaisee.
<response>-lohko muuttaa parametrit, datalähteen tulokset ja tapahtumat JSON-tyyliseksi
payloadiksi:
Nimetty, uudelleenkäytettävä muunnos. <code> ajetaan funktion runkona ilmoitettujen in-parametrien
yli ja palauttaa out-arvon:
Uudelleenkäytettävä viestimääritys, johon viitataan työnkulusta sen sijaan, että se kirjoitettaisiin sisäisesti joka kerta:
Reitit kuvaavat, miten komponentit esitetään selattavana sovelluksena. Ne eivät korvaa itse komponentteja.
Täysi esimerkki
xuda-studant-app-example on täydellinen lähdepuu, joka kattaa kaikki yksitoista lohkoa:
kirjautumisvirta, reititetty kojelauta, oppilasluettelo, tehtävä- ja profiilinäkymät,
taulupohjaiset lukemiset ja kirjoitukset sekä Tailwind-tyylit. Pura se komennoilla:
Kaikki yllä oleva on tulkittu murre, jonka xuda-cli kääntää: lohkot jäsennetään tallennettaessa
progUi / progFields / progEvents -suoritusaikaisiksi dokumenteiksi, jotka alustan
lausekeohjattu renderöijä lukee. Erillinen, julkaisematon kääntäjä (@xuda/compiler, jota
vite-plugin-xu käyttää) lukee suppeamman .xu-tiedoston, jossa on vain <template>, <script> ja
<style>, ei huomioi yllä olevia lohkonimiä ja tuottaa JSON-dokumentin sijaan oikean ES-moduulin
etukäteen. Se kohdistuu @xuda/core:n uudempaan signaalipohjaiseen renderöijään, samaan
moottoriin, jonka alusta toimittaa tiedostona runtime/js/xuda_core.globals.js. Katso
vite-plugin-xu ja @xuda/core kyseisestä polusta.