Component
Jednotka UI, strom prvkov viazaný na lokálny stav, dáta a logiku workflow, ktorá ich spája.
Component je jednotka UI: strom prvkov viazaný na lokálny stav, voliteľné dáta, logiku životného cyklu a vstupné a výstupné rozhranie. Stránka, karta, modálne okno, vyskakovacie okno, vložený fragment, to všetko sú komponenty a je to najbohatší typ dokumentu na platforme, ktorý nesie vlastný strom UI popri poliach, udalostiach a zdroji dát spoločných pre každý iný typ programu.
Vlastnosti
renderType (form / grid / list) je zastaraný a už sa nevyžaduje, nové komponenty sa vytvárajú bez neho. Nový Component v skutočnosti dostane voľbu kostry, single alebo multi, vyberanú raz v dialógu New Component: single vytvorí holý koreň xu-template pripravený na priame budovanie, multi vytvorí ten istý koreň xu-template s načítavacím div a už vnoreným xu-multi-view. xu-single-view je stále skutočný, ručne použiteľný tag, len ho továreň nevkladá za vás: proti nemu sa kontroluje iba nemigrovaný starší dokument (koreň ešte nie je xu-template), keď jeho zastaraný renderType stále hovorí form.
progUi, strom prvkov
Koreňový uzol je vždy priehľadný xu-template, vytvorený cez scaffold_prog_ui v create_prog. Voľba kostry multi do neho vnorí načítavací div a xu-multi-view; kostra single ho nechá prázdny, budujte priamo v jeho children. Každý uzol potrebuje jedinečné id, type: "element", tagName a attributes: {} a children: [], aj keď sú prázdne.
Okrem bežných HTML tagov sa priamo používa niekoľko tagov xuda: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.
tagName začínajúci veľkým písmenom (Button, Dialog) sa vždy berie ako skompilovaný komponent dizajnového systému, nikdy ako prvok HTML, aj keď ide o preklep: pri pripojení vyhodí chybu s uvedením tagu a každého vyskúšaného zdroja. Jeho obyčajné atribúty sa stávajú props, nie atribútmi DOM (variant, color, class všetky prídu ako props.<name>) a na rozdiel od xu-panel nemá výstupné parametre, tag komponentu iba číta to, čo mu odovzdáte.
Dynamické správanie: atribúty xu-*
Každý atribút xu-*, ktorý môže strom prvkov komponentu niesť:
Dva sa ľahko zamenia: xu-bind berie holé id poľa, bez @, jediná výnimka z pravidla @ všade inde; a xu-exp:class úplne nahrádza statický atribút class, takže rozloženie tried treba zopakovať vo výraze.
progFields, progEvents, progDataSource
Lokálny stav (progFields, virtual alebo viazaný na table), voliteľný vložený Datasource a udalosti životného cyklu. Tri z týchto udalostí delia prácu spôsobom, ktorý sa ľahko zamení:
Ak sa práca pri obnovení umiestni do screen_ready, vytváracia logika sa znova spustí nad DOM, ktorý ešte existuje, a na prvý widget sa navrství druhý.
Vloženie iného programu: xu-panel
xu-panel (tagName malými písmenami, atribút program) pripojí iný program Component s vlastnými poľami, zdrojom dát a udalosťami, na rozdiel od tagu dizajnového systému začínajúceho veľkým písmenom. Hodnoty do jeho parametrov _in odovzdajte atribútmi xu-exp:<param>; na rozdiel od tagu dizajnového systému môže panel zapisovať hodnoty späť do vašich polí cez parametre _out.
Ukážkový príklad
Zvoľte tvar
Vyberte single v dialógu New Component pre jeden záznam: budujte priamo v koreni xu-template. Vyberte multi pre zoznam: vytvorí v ňom xu-multi-view, na opakujúci sa uzol pridajte xu-for (alebo skratku for= v .xu).
Pripojte dáta
xu-bind pre vstupy, xu-exp:xu-content pre vypočítaný text, progDataSource, ak komponent vlastní vlastné čítanie.
Zapojte interakciu
xu-on:click s workflow, alebo v .xu pomenovaný blok akcie odkazovaný cez @click.
Strom zostavte na plátne: presúvajte prvky, atribúty nastavujte v paneli vlastností a obsluhy xu-on:* pripájajte ku krokom workflow v editore workflow. Výsledok si živo skontrolujte tlačidlom play náhľadu.
.xu skompiluje <single-view> na xu-single-view, :content na výraz xu-exp:xu-content a holý atribút for="@list_v" na xu-for.