Vai al contenuto
Verificata

Componente

L'unità di interfaccia, un albero di elementi associato a stato locale, dati e alla logica di workflow che li collega.

Un Componente è un'unità di interfaccia: un albero di elementi associato a stato locale, dati facoltativi, logica del ciclo di vita e un'interfaccia di input e output. Una pagina, una scheda, una modale, un popover, un frammento in linea: sono tutti Componenti, ed è il tipo di documento più ricco della piattaforma, perché porta un proprio albero UI insieme ai campi, agli eventi e all'origine dati condivisi con ogni altro tipo di programma.

Proprietà

renderType è un flag legacy, non una proprietà attiva

renderType (form / grid / list) è deprecato e non più richiesto; i nuovi componenti vengono creati senza di esso. Ciò che un nuovo Componente ottiene davvero è una scelta di scaffold, single o multi, scelta una sola volta nella finestra Nuovo componente: single crea una radice xu-template vuota pronta per costruirci direttamente, multi crea la stessa radice xu-template con un div di caricamento e un xu-multi-view già annidato al suo interno. xu-single-view è ancora un tag reale e utilizzabile, solo che non è uno di quelli che la factory inserisce per te: solo un documento legacy non migrato (radice non ancora xu-template) viene controllato rispetto ad esso, quando il suo renderType obsoleto dice ancora form.

progUi, l'albero degli elementi

Il nodo radice è sempre un xu-template trasparente, creato da scaffold_prog_ui di create_prog. Scegliere lo scaffold multi annida per te un div di caricamento e un xu-multi-view al suo interno; lo scaffold single lo lascia vuoto, costruisci direttamente dentro i suoi children. Ogni nodo ha bisogno di un id univoco, type: "element", un tagName e attributes: {} e children: [] anche quando sono vuoti.

Oltre ai normali tag HTML, alcuni tag xuda si scrivono direttamente: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.

Un tagName con l'iniziale maiuscola (Button, Dialog) viene sempre considerato un componente compilato del design system, mai un elemento HTML, anche quando è un errore di battitura: genera un errore al montaggio, indicando il tag e ogni sorgente provata. I suoi attributi semplici diventano props, non attributi DOM (variant, color, class arrivano tutti come props.<name>) e, a differenza di xu-panel, non ha parametri di output: un tag di componente legge solo ciò che gli passi.

Comportamento dinamico: gli attributi xu-*

Ogni attributo xu-* che l'albero di elementi di un Componente può avere:

Due sono facili da invertire: xu-bind accetta l'id di campo semplice, senza @, l'unica eccezione alla regola della @ ovunque altrove; e xu-exp:class sostituisce del tutto l'attributo class statico, quindi le classi di layout vanno ripetute dentro l'espressione.

progFields, progEvents, progDataSource

Stato locale (progFields, virtual o associati a table), un'Origine dati incorporata facoltativa ed eventi del ciclo di vita. Tre di questi eventi si dividono il lavoro in un modo facile da invertire:

Mettere il lavoro di aggiornamento in screen_ready riesegue la logica di creazione su un DOM che esiste ancora e impila un secondo widget sul primo.

Incorporare un altro programma: xu-panel

xu-panel (tagName minuscolo, attributo program) monta un altro programma Componente con i propri campi, la propria origine dati e i propri eventi, a differenza di un tag del design system con l'iniziale maiuscola. Passa i valori ai suoi parametri _in con attributi xu-exp:<param>; a differenza di un tag del design system, un pannello può riscrivere valori nei tuoi campi tramite i suoi parametri _out.

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

Esempio pratico

Scegli la forma

Scegli single nella finestra Nuovo componente per un solo record: costruisci direttamente dentro la radice xu-template. Scegli multi per un elenco: crea per te un xu-multi-view dentro quella radice, aggiungi xu-for (o la scorciatoia for= di .xu) sul nodo che si ripete.

Associa i dati

xu-bind per gli input, xu-exp:xu-content per il testo calcolato, un progDataSource se il componente possiede una propria lettura.

Collega l'interazione

xu-on:click con un workflow, oppure in .xu, un blocco di azione con nome referenziato con @click.

Costruisci l'albero sulla tela: trascina gli elementi, imposta gli attributi nel pannello delle proprietà, collega i gestori xu-on:* ai passi del workflow nell'editor di workflow. Premi il pulsante play dell'anteprima per controllare il risultato dal vivo.

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 compila <single-view> in xu-single-view, :content in un'espressione xu-exp:xu-content e un attributo semplice for="@list_v" in 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": [] }
  ]
}