Component
Unitatea de interfață, un arbore de elemente legat de starea locală, de date și de logica de flux de lucru care le leagă pe toate.
Un Component este o unitate de interfață: un arbore de elemente legat de starea locală, de date opționale, de logica ciclului de viață și de o interfață de intrare și de ieșire. O pagină, un card, un modal, un popover, un fragment inline, toate sunt Componente, iar acesta este cel mai bogat tip de document din platformă: poartă propriul arbore de interfață, alături de câmpurile, evenimentele și datasource-ul comune tuturor celorlalte tipuri de programe.
Proprietăți
renderType (form / grid / list) este depășit și nu mai este necesar; componentele noi se creează fără el. Ce primește de fapt un Component nou este o alegere de schelet, single sau multi, făcută o singură dată în dialogul New Component: single creează o rădăcină xu-template goală, gata de construit direct în ea, iar multi creează aceeași rădăcină xu-template cu un div de încărcare și un xu-multi-view deja imbricat în ea. xu-single-view este în continuare un tag real, care poate fi scris manual, doar că nu este unul pe care îl plasează automat generatorul: doar un document vechi nemigrat (rădăcina încă nu este xu-template) este verificat în raport cu el, când renderType-ul său învechit spune încă form.
progUi, arborele de elemente
Nodul rădăcină este întotdeauna un xu-template transparent, creat de scaffold_prog_ui din create_prog. Dacă alegi scheletul multi, în el sunt imbricate pentru tine un div de încărcare și un xu-multi-view; scheletul single îl lasă gol, iar tu construiești direct în children. Fiecare nod are nevoie de un id unic, type: "element", un tagName, plus attributes: {} și children: [] chiar și când sunt goale.
Pe lângă tagurile HTML obișnuite, câteva taguri xuda se scriu direct: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.
Un tagName cu majusculă (Button, Dialog) este întotdeauna considerat componentă compilată de design system, niciodată element HTML, chiar dacă este o greșeală de scriere: aruncă o eroare la montare, numind tagul și fiecare sursă încercată. Atributele lui simple devin props, nu atribute DOM (variant, color, class ajung toate ca props.<name>) și, spre deosebire de xu-panel, nu are parametri de ieșire: un tag de componentă citește doar ce îi trimiți.
Comportament dinamic: atribute xu-*
Toate atributele xu-* pe care le poate purta arborele de elemente al unui Component:
Două sunt ușor de încurcat: xu-bind primește id-ul simplu al câmpului, fără @, singura excepție de la regula @ valabilă peste tot în rest; iar xu-exp:class înlocuiește complet atributul static class, deci clasele de aranjare trebuie repetate în expresie.
progFields, progEvents, progDataSource
Starea locală (progFields, virtual sau legată de table), un Datasource încorporat opțional și evenimentele ciclului de viață. Trei dintre aceste evenimente împart munca într-un mod ușor de încurcat:
Dacă pui munca de reîmprospătare în screen_ready, logica de creare rulează din nou peste un DOM care încă există și un al doilea widget se suprapune peste primul.
Încorporarea altui program: xu-panel
xu-panel (tagName cu litere mici, atributul program) montează un alt program Component, cu propriile câmpuri, datasource și evenimente, spre deosebire de un tag de design system scris cu majusculă. Trimite valori în parametrii lui _in cu atribute xu-exp:<param>; spre deosebire de un tag de design system, un panel poate scrie valori înapoi în câmpurile tale prin parametrii _out.
Exemplu lucrat
Alege forma
Alege single în dialogul New Component pentru o singură înregistrare: construiești direct în rădăcina xu-template. Alege multi pentru o listă: ea creează pentru tine un xu-multi-view în rădăcină, iar tu adaugi xu-for (sau prescurtarea for= din .xu) pe nodul care se repetă.
Leagă datele
xu-bind pentru câmpuri de intrare, xu-exp:xu-content pentru text calculat, un progDataSource dacă componentul își face singur citirea.
Conectează interacțiunea
xu-on:click cu un flux de lucru sau, în .xu, un bloc de acțiuni denumit, referit cu @click.
Construiește arborele pe canvas: trage elemente, setează atributele în panoul de proprietăți, conectează handlerele xu-on:* la pașii fluxului de lucru în editorul de flux de lucru. Apasă butonul de previzualizare play ca să verifici rezultatul live.
.xu compilează <single-view> în xu-single-view, :content într-o expresie xu-exp:xu-content, iar un atribut simplu for="@list_v" în xu-for.