Siirry sisältöön
Luonnos

Component

[object Object]

Component on käyttöliittymän yksikkö: elementtipuu, joka on sidottu paikalliseen tilaan, valinnaiseen dataan, elinkaarilogiikkaan sekä syöte- ja tulosterajapintaan. Sivu, kortti, modaali-ikkuna, ponnahdusikkuna ja upotettu osa ovat kaikki Component-ohjelmia. Se on alustan monipuolisin dokumenttityyppi, koska sillä on oma käyttöliittymäpuunsa sekä kentät, tapahtumat ja datasource, jotka se jakaa kaikkien muiden ohjelmatyyppien kanssa.

Ominaisuudet

renderType on vanhentunut lippu, ei käytössä oleva ominaisuus

renderType (form / grid / list) on vanhentunut eikä enää pakollinen. Uudet componentit luodaan ilman sitä. Uusi Component saa sen sijaan pohjavalinnan, single tai multi, joka valitaan kerran New Component -ikkunassa: single luo paljaan xu-template-juuren, johon voi rakentaa suoraan, ja multi luo saman xu-template-juuren, jonka sisään on valmiiksi sijoitettu latausta kuvaava div ja xu-multi-view. xu-single-view on edelleen aito, itse kirjoitettava tagi, mutta tehdas ei aseta sitä puolestasi: vain siirtämätöntä vanhaa dokumenttia (juuri ei vielä xu-template) verrataan siihen, kun sen vanhentunut renderType sanoo yhä form.

progUi, elementtipuu

Juurisolmu on aina läpinäkyvä xu-template, jonka create_progin scaffold_prog_ui luo. Kun valitset multi-pohjan, sen sisään sijoitetaan puolestasi latausta kuvaava div ja xu-multi-view. single-pohja jättää sen tyhjäksi, ja rakennat suoraan sen children-kenttään. Jokaisella solmulla on oltava yksilöllinen id, type: "element", tagName sekä attributes: {} ja children: [] silloinkin, kun ne ovat tyhjiä.

Tavallisten HTML-tagien lisäksi muutama xuda-tagi kirjoitetaan suoraan: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.

Isolla alkukirjaimella kirjoitettu tagName (Button, Dialog) tulkitaan aina käännetyksi design-system-componentiksi, ei koskaan HTML-elementiksi, vaikka kyse olisi kirjoitusvirheestä: se antaa virheen liitettäessä ja nimeää tagin sekä kaikki kokeillut lähteet. Sen tavalliset attribuutit muuttuvat propseiksi, eivät DOM-attribuuteiksi (variant, color ja class saapuvat kaikki muodossa props.<name>), ja toisin kuin xu-panelilla sillä ei ole out-parametreja: componentti-tagi vain lukee sen, mitä sille annat.

Dynaaminen toiminta: xu-*-attribuutit

Kaikki xu-*-attribuutit, jotka Componentin elementtipuu voi sisältää:

Kaksi on helppo sekoittaa: xu-bind ottaa pelkän kentän tunnuksen ilman @-merkkiä, ainoa poikkeus @-sääntöön kaikkialla muualla. Lisäksi xu-exp:class korvaa staattisen class-attribuutin kokonaan, joten asettelun luokat on toistettava lausekkeen sisällä.

progFields, progEvents, progDataSource

Paikallinen tila (progFields, virtual tai table-sidottu), valinnainen upotettu Datasource ja elinkaaritapahtumat. Kolme näistä tapahtumista jakaa työn tavalla, jonka on helppo sekoittaa:

Jos päivitystyö laitetaan screen_ready-tapahtumaan, luontilogiikka ajetaan uudelleen DOM:lle, joka on yhä olemassa, ja toinen widget kasaantuu ensimmäisen päälle.

Toisen ohjelman upottaminen: xu-panel

xu-panel (pienaakkosinen tagName, program-attribuutti) liittää sisään toisen Component-ohjelman omine kenttineen, datasourceineen ja tapahtumineen, toisin kuin isolla alkukirjaimella kirjoitettu design-system-tagi. Välitä arvot sen _in-parametreihin xu-exp:<param>-attribuuteilla. Toisin kuin design-system-tagi, panel voi kirjoittaa arvoja takaisin sinun kenttiisi _out-parametriensa kautta.

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

Esimerkki

Valitse muoto

Valitse single New Component -ikkunassa yhtä tietuetta varten: rakenna suoraan xu-template-juuren sisään. Valitse multi luetteloa varten: se luo juuren sisään xu-multi-viewin puolestasi, ja toistuvaan solmuun lisäät xu-forin (tai .xu-tiedoston for=-oikotien).

Sido data

xu-bind syötteille, xu-exp:xu-content lasketulle tekstille ja progDataSource, jos componentti omistaa oman lukunsa.

Kytke vuorovaikutus

xu-on:click ja työnkulku, tai .xu-tiedostossa nimetty toimintolohko, johon viitataan @clickillä.

Rakenna puu kankaalla: vedä elementtejä, aseta attribuutit ominaisuuspaneelissa ja kytke xu-on:*-käsittelijät työnkulun vaiheisiin työnkuluneditorissa. Tarkista tulos livenä painamalla esikatselun play-painiketta.

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 kääntää <single-view>in muotoon xu-single-view, :contentin xu-exp:xu-content-lausekkeeksi ja paljaan for="@list_v"-attribuutin muotoon 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": [] }
  ]
}

Katso myös