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