Komponent
Jednostka interfejsu, drzewo elementów powiązane z lokalnym stanem, danymi i logiką przepływu pracy, która to wszystko łączy.
Komponent to jednostka interfejsu: drzewo elementów powiązane z lokalnym stanem, opcjonalnymi danymi, logiką cyklu życia oraz interfejsem wejścia i wyjścia. Strona, karta, okno modalne, wyskakujące okienko, wbudowany fragment, wszystko to są Komponenty. To najbogatszy typ dokumentu na platformie: niesie własne drzewo interfejsu obok pól, zdarzeń i źródła danych, które dzieli z każdym innym typem programu.
Właściwości
renderType (form / grid / list) jest przestarzałe i nie jest już wymagane; nowe komponenty powstają bez niego. Nowy Komponent dostaje natomiast wybór szkieletu, single lub multi, wskazywany raz w oknie Nowy komponent: single tworzy pusty korzeń xu-template, gotowy do budowania bezpośrednio, a multi tworzy ten sam korzeń xu-template z wczytującym div i już zagnieżdżonym w nim xu-multi-view. xu-single-view nadal jest prawdziwym tagiem, który można pisać samodzielnie, tylko fabryka go nie umieszcza za Ciebie: sprawdzany jest pod jego kątem wyłącznie niezmigrowany stary dokument (korzeń to jeszcze nie xu-template), gdy jego przestarzałe renderType nadal mówi form.
progUi, drzewo elementów
Węzeł główny to zawsze przezroczysty xu-template, tworzony przez scaffold_prog_ui w create_prog. Wybór szkieletu multi zagnieżdża w nim za Ciebie wczytujący div i xu-multi-view; szkielet single zostawia go pustym, więc buduj bezpośrednio w jego children. Każdy węzeł potrzebuje unikalnego id, type: "element", tagName oraz attributes: {} i children: [], nawet gdy są puste.
Oprócz zwykłych tagów HTML kilka tagów xuda pisze się bezpośrednio: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.
tagName pisany wielką literą (Button, Dialog) jest zawsze traktowany jako skompilowany komponent systemu projektowego, nigdy jako element HTML, nawet jeśli to literówka: wtedy rzuca błąd przy montowaniu, podając nazwę tagu i każde źródło, które sprawdzono. Jego zwykłe atrybuty stają się propsami, a nie atrybutami DOM (variant, color, class docierają jako props.<name>), i w przeciwieństwie do xu-panel nie ma parametrów wyjściowych, tag komponentu tylko odczytuje to, co mu przekażesz.
Zachowanie dynamiczne: atrybuty xu-*
Każdy atrybut xu-*, który może nieść drzewo elementów Komponentu:
Dwa z nich łatwo pomylić: xu-bind przyjmuje sam identyfikator pola, bez @, to jedyny wyjątek od reguły @ obowiązującej wszędzie indziej; a xu-exp:class całkowicie zastępuje statyczny atrybut class, więc klasy układu trzeba powtórzyć w wyrażeniu.
progFields, progEvents, progDataSource
Stan lokalny (progFields, virtual lub powiązane z table), opcjonalne wbudowane Źródło danych oraz zdarzenia cyklu życia. Trzy z tych zdarzeń dzielą pracę w sposób, który łatwo odwrócić:
Umieszczenie pracy odświeżającej w screen_ready ponownie uruchamia logikę tworzenia na DOM, który nadal istnieje, i układa drugi widżet na pierwszym.
Osadzanie innego programu: xu-panel
xu-panel (tagName pisany małymi literami, atrybut program) montuje inny program Komponent z własnymi polami, źródłem danych i zdarzeniami, w przeciwieństwie do tagu systemu projektowego pisanego wielką literą. Wartości do jego parametrów _in przekazuj atrybutami xu-exp:<param>; w przeciwieństwie do tagu systemu projektowego panel może zapisywać wartości z powrotem do Twoich pól przez parametry _out.
Przykład krok po kroku
Wybierz kształt
Wybierz single w oknie Nowy komponent dla jednego rekordu: buduj bezpośrednio w korzeniu xu-template. Wybierz multi dla listy: umieści on w tym korzeniu xu-multi-view, a ty dodaj xu-for (lub skrót for= w .xu) na powtarzanym węźle.
Powiąż dane
xu-bind dla pól wprowadzania, xu-exp:xu-content dla obliczanego tekstu, progDataSource, jeśli komponent ma własny odczyt.
Podłącz interakcję
xu-on:click z przepływem pracy lub w .xu nazwany blok akcji wskazany przez @click.
Zbuduj drzewo na kanwie: przeciągaj elementy, ustawiaj atrybuty w panelu właściwości, podłączaj obsługę xu-on:* do kroków przepływu pracy w edytorze przepływu pracy. Naciśnij przycisk odtwarzania podglądu, aby sprawdzić wynik na żywo.
.xu kompiluje <single-view> do xu-single-view, :content do wyrażenia xu-exp:xu-content, a sam atrybut for="@list_v" do xu-for.