Preskočiť na obsah
Overené

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 je zastaraný príznak, nie živá vlastnosť

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.

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

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.

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

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": [] }
  ]
}