Język .xu
Format blokowy, w którym pisany jest każdy plik źródłowy .xu, i jedenaście elementów składowych projektu.
Plik .xu to plik blokowy, a nie moduł JavaScript. Każdy blok to jedna sprawa, a bloki obiektowe
(<meta>, <params>, <fields>, <actions>, <events>, <datasource>) są parsowane jako literały
w stylu JSON5: klucze bez cudzysłowów, tablice i zagnieżdżone obiekty są w porządku.
Jedenaście elementów składowych
Folder, w którym leży plik źródłowy, decyduje o tym, do jakiego rodzaju jednostki się skompiluje. Aplikacja Xu zwykle czyta się lepiej, gdy każda sprawa ma własną jednostkę, a nie jeden plik robi wszystko.
App.xu to jedyny zarezerwowany plik: zawsze jest główną aplikacją i zawsze kompiluje się do
identyfikatora programu app. Dla pliku component identyfikator jest ustalany kolejno z meta.id,
potem z mount.id, a potem z nazwy bazowej samego pliku. Każdy inny typ jednostki nie ma bloku
<mount>, więc jego identyfikator wynika z meta.id, a potem z nazwy bazowej pliku. W zasobach JSON5
kolejność to id, potem _id, potem nazwa bazowa. Duplikaty identyfikatorów w projekcie są
niedozwolone.
Bloki według typu jednostki
App.xu nigdy nie potrzebuje bloku <mount>. Zwykły komponent potrzebuje go tylko wtedy, gdy chcesz
zamontować go bezpośrednio na stronie HTML, a nie docierać do niego przez <panel program="...">:
Język szablonów
Wewnątrz <template> niewielki zestaw przyjaznych aliasów kompiluje się do własnego znacznika
xu-* środowiska uruchomieniowego.
Komponent od początku do końca
<script> kompiluje się do modułu montowania po stronie klienta: eksport domyślny otrzymuje obiekt
kontekstu i może zwrócić funkcję zwalniającą, uruchamianą przy zwolnieniu. Bloki <style> są zbierane
w jeden serwowany arkusz stylów komponentu.
Format źródła danych
Używaj czytelnej formy z opakowaniem wewnątrz <datasource lang="json5">. type to jedno z none,
table, array, json lub csv.
Źródło danych typu tabela używa table, filter, sort, direction, realtime, limit, skip i
output. Źródło danych typu tablica, JSON lub CSV używa source.field lub source.url. Dla każdego
klucza źródła danych, którego forma z opakowaniem nie udostępnia, przejdź na mode="raw" i zapisz
nazwy pól, których używa sam dokument uruchomieniowy.
Pozostałe dziesięć bloków w skrócie
Nazwane odczyty wielokrotnego użytku. data/get/LoadStudentClasses.xu łączy <params> (zadeklarowane
pola in/out) z <datasource>, więc komponent wywołuje loader po nazwie, a nie sam zarządza
szczegółami zapytania.
Nazwane zapisy. data/set/SaveStudentProfile.xu dodaje crudMode i allowCreate do <meta> obok
parametrów i źródła danych, dając trwałemu zapisowi widoczne, testowalne miejsce w kodzie źródłowym.
Przetwarzanie rekord po rekordzie. data/batch/RebuildClassRoster.xu uruchamia krok <events>, taki
jak before_record, dla każdego wiersza, który zwraca <datasource>.
Blok <response> zamienia parametry, wyniki źródła danych i zdarzenia w ładunek w stylu JSON:
Nazwane przekształcenie wielokrotnego użytku. <code> działa jako ciało funkcji na zadeklarowanych
parametrach in i zwraca wartość out:
Definicja komunikatu wielokrotnego użytku, przywoływana z przepływu pracy zamiast pisania jej za każdym razem w treści:
Trasy opisują, jak komponenty są prezentowane jako aplikacja z nawigacją; nie zastępują samych komponentów.
Pełny przykład
xuda-studant-app-example to kompletne drzewo źródeł obejmujące wszystkie jedenaście bloków: przepływ
logowania, pulpit z trasami, listę studentów, ekrany zadań i profilu, odczyty i zapisy oparte na
tabelach oraz stylowanie Tailwind. Rozpakuj go poleceniami:
Wszystko powyżej to dialekt interpretowany, który kompiluje xuda-cli: bloki parsowane przy zapisie do
dokumentów uruchomieniowych progUi / progFields / progEvents, czytanych przez renderer
platformy sterowany wyrażeniami. Osobny, nieopublikowany kompilator (@xuda/compiler, używany przez
vite-plugin-xu) czyta węższy plik .xu złożony wyłącznie z <template>, <script> i <style>,
ignoruje nazwy bloków podane wyżej i z wyprzedzeniem emituje prawdziwy moduł ES zamiast dokumentu
JSON. Jest przeznaczony dla nowszego renderera opartego na sygnałach w @xuda/core, tym samym
silniku, który platforma dostarcza jako runtime/js/xuda_core.globals.js. Zobacz
vite-plugin-xu i @xuda/core, żeby poznać tę ścieżkę.