Naar de inhoud springen
Geverifieerd

Component

De eenheid van UI, een elementenboom gekoppeld aan lokale status, data en de workflowlogica die alles verbindt.

Een Component is een UI-eenheid: een elementenboom gekoppeld aan lokale status, optionele data, lifecycle-logica en een invoer- en uitvoerinterface. Een pagina, een kaart, een modal, een popover, een inline fragment: het zijn allemaal Components. Het is het rijkste documenttype van het platform, met een eigen UI-boom naast de velden, events en datasource die elk programmatype deelt.

Eigenschappen

renderType is een verouderde vlag, geen actieve eigenschap

renderType (form / grid / list) is deprecated en niet meer nodig. Nieuwe components worden zonder aangemaakt. Wat een nieuwe Component wel krijgt, is een scaffold-keuze, single of multi, die je één keer maakt in het dialoogvenster Nieuwe Component: single zet een kale xu-template-root neer waarin je direct kunt bouwen, multi zet dezelfde xu-template-root neer met een laad-div en een xu-multi-view er al in genest. xu-single-view is nog steeds een echte tag die je zelf kunt gebruiken, alleen plaatst de factory hem niet voor je: alleen een niet-gemigreerd verouderd document (root nog geen xu-template) wordt ertegen gecontroleerd, wanneer de verouderde renderType nog form zegt.

progUi, de elementenboom

De rootnode is altijd een transparante xu-template, aangemaakt door scaffold_prog_ui van create_prog. Met de multi-scaffold worden een laad-div en een xu-multi-view voor je in de root genest. De single-scaffold laat hem leeg, bouw dan direct in zijn children. Elke node heeft een unieke id, type: "element", een tagName, en attributes: {} en children: [], ook als ze leeg zijn.

Naast gewone HTML-tags worden enkele xuda-tags direct gebruikt: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.

Een tagName met een hoofdletter (Button, Dialog) wordt altijd opgevat als een gecompileerde designsysteem-component, nooit als HTML-element, ook als het een typfout is: dan volgt er een fout bij het mounten, met de tag en elke geprobeerde bron erbij. De gewone attributen worden props, geen DOM-attributen (variant, color, class komen allemaal aan als props.<name>) en anders dan xu-panel heeft zo'n tag geen out-params: een componenttag leest alleen wat je meegeeft.

Dynamisch gedrag: xu-*-attributen

Elk xu-*-attribuut dat de elementenboom van een Component kan hebben:

Twee zijn makkelijk te verwisselen: xu-bind neemt de kale veld-id, zonder @, de enige uitzondering op de @-regel die overal elders geldt. En xu-exp:class vervangt het statische class-attribuut helemaal, dus layoutklassen moeten in de expressie worden herhaald.

progFields, progEvents, progDataSource

Lokale status (progFields, virtual of gekoppeld aan een table), een optionele ingebedde Datasource en lifecycle-events. Drie van die events verdelen het werk op een manier die makkelijk door elkaar te halen is:

Als je verversingswerk in screen_ready zet, draait de aanmaaklogica opnieuw op DOM die nog bestaat en komt er een tweede widget bovenop de eerste.

Een ander programma insluiten: xu-panel

xu-panel (tagName in kleine letters, attribuut program) mount een ander Component-programma met eigen velden, datasource en events, in tegenstelling tot een designsysteemtag met hoofdletter. Geef waarden door aan de _in-params met xu-exp:<param>-attributen. Anders dan een designsysteemtag kan een panel via zijn _out-params waarden terugschrijven naar jouw velden.

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

Uitgewerkt voorbeeld

Kies de vorm

Kies single in het dialoogvenster Nieuwe Component voor één record: bouw direct in de xu-template-root. Kies multi voor een lijst: dat zet een xu-multi-view in die root voor je neer, voeg xu-for (of de for=-afkorting van .xu) toe aan het herhalende node.

Koppel de data

xu-bind voor invoer, xu-exp:xu-content voor berekende tekst, een progDataSource als de component zelf zijn leesactie heeft.

Verbind de interactie

xu-on:click met een workflow, of in .xu een benoemd actieblok waarnaar je met @click verwijst.

Bouw de boom op het canvas: sleep elementen, stel attributen in via het eigenschappenpaneel en koppel xu-on:*-handlers aan workflowstappen in de workflow-editor. Druk op de play-knop van de voorvertoning om het resultaat live te bekijken.

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 compileert <single-view> naar xu-single-view, :content naar een xu-exp:xu-content-expressie en een kaal for="@list_v"-attribuut naar 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": [] }
  ]
}