Přeskočit na obsah
Ověřeno

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 je zastaralý příznak, ne živá vlastnost

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.

json
{ "id": "ui-…", "type": "element", "tagName": "xu-panel", "attributes": { "program": "392_cmp_child…", "xu-exp:order_id_in": "@selected_order_v" } }

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.

xml
<meta lang="json5">
{
  id: "user_profile_card",
  menuTitle: "User Profile Card",
  uiFramework: "@xuda.io/xuda-framework-plugin-tailwind"
}
</meta>

<params lang="json5">
{
  in: { user_name_in: "string", user_role_in: "string" }
}
</params>

<template>
  <single-view>
    <aside class="user-card">
      <div class="avatar" :content="(@user_name_in || 'A').substring(0, 1)"></div>
      <h3 :content="@user_name_in"></h3>
      <p :content="@user_role_in"></p>
    </aside>
  </single-view>
</template>

<style>
.user-card { display: grid; gap: 0.75rem; padding: 1rem; border-radius: 1.2rem; }
</style>

.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.

json
{
  "properties": { "menuType": "component", "menuName": "Student Card", "rwMode": "U", "allowCreate": false },
  "progUi": [
    { "id": "root", "type": "element", "tagName": "xu-template", "attributes": {}, "children": [] }
  ],
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "STU_Student_Id", "type": "table" }, "props": { "fieldType": "string" } }
  ],
  "progEvents": [
    { "id": "d4e5f6a7-…", "data": { "type": "on_load", "parameters": [], "condition": "" }, "workflow": [] }
  ]
}