Component
Jednotka uživatelského rozhraní, strom prvků svázaný s lokálním stavem, daty a logikou workflow, která je propojuje.
Component je jednotka uživatelského rozhraní: strom prvků svázaný s lokálním stavem, volitelnými daty, logikou životního cyklu a vstupním a výstupním rozhraním. Stránka, karta, modální okno, vyskakovací okno, vložený fragment, to všechno jsou Komponenty, a je to nejbohatší typ dokumentu na platformě: nese vlastní strom UI vedle polí, událostí a datového zdroje, které sdílí každý další typ programu.
Vlastnosti
renderType (form / grid / list) je zastaralý a už se nevyžaduje; nové komponenty se vytvářejí bez něj. Nová Component dostane volbu kostry, single nebo multi, vybranou jednou v dialogu Nová komponenta: single vytvoří holý kořen xu-template, do kterého můžete rovnou stavět, multi vytvoří stejný kořen xu-template s načítacím div a již vnořeným xu-multi-view. xu-single-view je stále skutečný, ručně vytvářený tag, jen ho továrna nevkládá sama: proti němu se kontroluje pouze nemigrovaný starší dokument (kořen ještě není xu-template), když jeho zastaralý renderType stále říká form.
progUi, strom prvků
Kořenovým uzlem je vždy průhledný xu-template, vytvořený pomocí scaffold_prog_ui z create_prog. Zvolíte-li kostru multi, vnoří se do něj načítací div a xu-multi-view za vás; kostra single ho nechá prázdný, stavějte přímo v jeho children. Každý uzel potřebuje jedinečné id, type: "element", tagName a attributes: {} i children: [], i když jsou prázdné.
Kromě běžných HTML tagů se přímo vytváří několik tagů xuda: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.
tagName s velkým počátečním písmenem (Button, Dialog) se vždy bere jako zkompilovaná komponenta designového systému, nikdy jako prvek HTML, i když jde o překlep: při připojení vyhodí chybu, která uvede tag a všechny vyzkoušené zdroje. Jeho běžné atributy se stanou props, ne atributy DOM (variant, color, class všechny dorazí jako props.<name>) a na rozdíl od xu-panel nemá výstupní parametry, tag komponenty pouze čte to, co mu předáte.
Dynamické chování: atributy xu-*
Každý atribut xu-*, který může strom prvků Komponenty nést:
Dva se snadno zaměňují: xu-bind bere holé id pole, bez @, jediná výjimka z pravidla @ všude jinde; a xu-exp:class zcela nahrazuje statický atribut class, takže třídy rozvržení je nutné zopakovat uvnitř výrazu.
progFields, progEvents, progDataSource
Lokální stav (progFields, virtual nebo svázaný s table), volitelný vložený Datasource a události životního cyklu. Tři z těchto událostí dělí práci způsobem, který se snadno splete:
Pokud dáte práci při obnovení do screen_ready, vytvářecí logika se znovu spustí nad DOM, který stále existuje, a druhý widget se naskládá na první.
Vložení jiného programu: xu-panel
xu-panel (tagName malými písmeny, atribut program) připojí jiný program Component s vlastními poli, datovým zdrojem a událostmi, na rozdíl od tagu designového systému s velkým písmenem. Hodnoty do jeho parametrů _in předáte atributy xu-exp:<param>; na rozdíl od tagu designového systému může panel zapisovat hodnoty zpět do vašich polí přes své parametry _out.
Praktický příklad
Zvolte tvar
Vyberte single v dialogu Nová komponenta pro jeden záznam: stavějte přímo uvnitř kořene xu-template. Vyberte multi pro seznam: uvnitř kořene se vytvoří xu-multi-view, na opakující se uzel přidejte xu-for (nebo zkratku for= v .xu).
Svažte data
xu-bind pro vstupy, xu-exp:xu-content pro vypočítaný text, progDataSource, pokud komponenta vlastní čtení dat.
Zapojte interakci
xu-on:click s workflow, nebo v .xu pojmenovaný blok akce, na který se odkazuje pomocí @click.
Strom sestavte na plátně: přetahujte prvky, atributy nastavujte v panelu vlastností a obslužné rutiny xu-on:* propojte s kroky workflow v editoru workflow. Stisknutím tlačítka play náhledu zkontrolujete výsledek naživo.
.xu zkompiluje <single-view> na xu-single-view, :content na výraz xu-exp:xu-content a holý atribut for="@list_v" na xu-for.