Przejdź do treści
Zweryfikowano

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 to starsza flaga, a nie aktywna właściwość

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.

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

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.

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 kompiluje <single-view> do xu-single-view, :content do wyrażenia xu-exp:xu-content, a sam atrybut for="@list_v" do 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": [] }
  ]
}