Ugrás a tartalomhoz
Ellenőrizve

Komponens

A felhasználói felület egysége, helyi állapothoz, adatokhoz és az őket összekötő munkafolyamat-logikához kötött elemfa.

A Komponens egy felhasználói felületi egység: helyi állapothoz, opcionális adatokhoz, életciklus-logikához, valamint bemeneti és kimeneti felülethez kötött elemfa. Egy oldal, egy kártya, egy modális ablak, egy felugró panel, egy beágyazott részlet, mind Komponens, és ez a platform leggazdagabb dokumentumtípusa: saját felületi fát hordoz, a többi programtípussal közös mezők, események és adatforrás mellett.

Tulajdonságok

A renderType régi jelző, nem élő tulajdonság

A renderType (form / grid / list) elavult és már nem kötelező; az új komponensek nélküle jönnek létre. Egy új Komponens valójában egy vázválasztást kap, single vagy multi értékkel, amelyet egyszer, az Új komponens párbeszédablakban kell kiválasztani: a single egy üres xu-template gyökeret hoz létre, amelyben közvetlenül lehet építkezni, a multi ugyanazt az xu-template gyökeret hozza létre egy betöltést jelző div elemmel és egy benne már elhelyezett xu-multi-view elemmel. Az xu-single-view továbbra is valódi, szerkeszthető címke, csak nem olyan, amelyet a gyár elhelyez Önnek: csak egy át nem telepített régi dokumentumot (amelynek gyökere még nem xu-template) ellenőriz vele a rendszer, ha elavult renderType értéke még form.

progUi, az elemfa

A gyökércsomópont mindig egy átlátszó xu-template, amelyet a create_prog scaffold_prog_ui lépése hoz létre. A multi váz választásakor egy betöltést jelző div és egy xu-multi-view kerül bele Ön helyett; a single váz üresen hagyja, ilyenkor közvetlenül a children mezőben építkezzen. Minden csomópontnak egyedi id, type: "element", tagName, valamint attributes: {} és children: [] kell, még akkor is, ha üresek.

A szokásos HTML-címkék mellett néhány xuda-címke közvetlenül szerkeszthető: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.

A nagybetűvel kezdődő tagName (Button, Dialog) mindig lefordított designrendszer-komponensként értelmeződik, soha nem HTML-elemként, akkor sem, ha elírás: csatolásakor hibát dob, megnevezve a címkét és az összes kipróbált forrást. Az egyszerű attribútumai prop értékek lesznek, nem DOM-attribútumok (a variant, color és class mind props.<name> néven érkezik), és az xu-panel elemmel ellentétben nincsenek kimeneti paraméterei: a komponenscímke csak azt olvassa, amit átad neki.

Dinamikus viselkedés: xu-* attribútumok

Minden xu-* attribútum, amelyet egy Komponens elemfája hordozhat:

Kettőt könnyű felcserélni: az xu-bind a puszta mezőazonosítót várja, @ nélkül, ez az egyetlen kivétel az egyébként mindenhol érvényes @ szabály alól; az xu-exp:class pedig teljesen felváltja a statikus class attribútumot, ezért az elrendezési osztályokat meg kell ismételni a kifejezésben.

progFields, progEvents, progDataSource

Helyi állapot (progFields, virtual vagy table típusú kötéssel), egy opcionális beágyazott Adatforrás és életciklus-események. Ezek közül három esemény úgy osztja meg a munkát, hogy könnyű felcserélni őket:

Ha a frissítési munkát a screen_ready eseménybe teszi, a létrehozási logika újra lefut az még létező DOM-on, és egy második widget kerül az első fölé.

Másik program beágyazása: xu-panel

Az xu-panel (kisbetűs tagName, program attribútum) egy másik Komponens programot csatol a saját mezőivel, adatforrásával és eseményeivel, szemben a nagybetűs designrendszer-címkével. A _in paraméterekbe az xu-exp:<param> attribútumokkal adhat át értékeket; a designrendszer-címkével ellentétben a panel a _out paramétereken keresztül vissza tud írni értékeket az Ön mezőibe.

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

Példa lépésről lépésre

Válassza ki az alakot

Válassza a single lehetőséget az Új komponens párbeszédablakban egyetlen rekordhoz: közvetlenül az xu-template gyökérben építkezzen. Válassza a multi lehetőséget listához: ez egy xu-multi-view elemet hoz létre a gyökérben, az ismétlődő csomóponthoz adja hozzá az xu-for attribútumot (vagy a .xu for= rövidítést).

Kösse az adatokat

xu-bind a beviteli mezőkhöz, xu-exp:xu-content a számított szöveghez, egy progDataSource, ha a komponens saját olvasást végez.

Kösse be az interakciót

xu-on:click munkafolyamattal, vagy .xu formátumban egy elnevezett műveletblokk, amelyre a @click hivatkozik.

Építse fel a fát a vásznon: húzza az elemeket, állítsa be az attribútumokat a tulajdonságok panelen, kösse az xu-on:* kezelőket a munkafolyamat-lépésekhez a munkafolyamat-szerkesztőben. Az eredmény élő ellenőrzéséhez nyomja meg az előnézet lejátszás gombját.

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>

A .xu a <single-view> elemet xu-single-view címkévé, a :content attribútumot xu-exp:xu-content kifejezéssé, a puszta for="@list_v" attribútumot pedig xu-for attribútummá fordítja.

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