Saltar para o conteúdo
Verificado

Componente

A unidade de interface, uma árvore de elementos associada a estado local, dados e à lógica de fluxo de trabalho que a liga.

Um Componente é uma unidade de interface: uma árvore de elementos associada a estado local, dados opcionais, lógica de ciclo de vida e uma interface de entrada e saída. Uma página, um cartão, um modal, um popover, um fragmento em linha, são todos Componentes, e é o tipo de documento mais rico da plataforma, com a sua própria árvore de interface a par dos campos, eventos e fonte de dados partilhados com todos os outros tipos de programa.

Propriedades

renderType é um indicador antigo, não uma propriedade ativa

renderType (form / grid / list) está obsoleto e já não é necessário; os novos componentes são criados sem ele. O que um novo Componente realmente recebe é uma escolha de estrutura, single ou multi, escolhida uma só vez na caixa de diálogo Novo Componente: single cria uma raiz xu-template simples, pronta para construir diretamente, multi cria a mesma raiz xu-template com um div de carregamento e um xu-multi-view já aninhado dentro dela. xu-single-view continua a ser uma etiqueta real e utilizável, apenas não é uma que a fábrica coloque por si: só um documento antigo não migrado (raiz ainda não xu-template) é verificado face a ela, quando o seu renderType obsoleto ainda diz form.

progUi, a árvore de elementos

O nó raiz é sempre um xu-template transparente, criado pelo scaffold_prog_ui de create_prog. Escolher a estrutura multi aninha por si um div de carregamento e um xu-multi-view lá dentro; a estrutura single deixa-o vazio, construa diretamente dentro dos seus children. Cada nó precisa de um id único, type: "element", um tagName e attributes: {} e children: [] mesmo quando vazios.

Além das etiquetas HTML simples, algumas etiquetas da xuda são escritas diretamente: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.

Um tagName com maiúscula inicial (Button, Dialog) é sempre reivindicado como um componente compilado do sistema de design, nunca como um elemento HTML, mesmo quando é um erro de escrita: lança um erro na montagem, indicando a etiqueta e todas as origens tentadas. Os seus atributos simples tornam-se props, não atributos do DOM (variant, color, class chegam todos como props.<name>), e, ao contrário do xu-panel, não tem parâmetros de saída, uma etiqueta de componente só lê o que lhe passa.

Comportamento dinâmico: atributos xu-*

Todos os atributos xu-* que a árvore de elementos de um Componente pode ter:

Dois são fáceis de trocar: xu-bind recebe o id de campo simples, sem @, a única exceção à regra do @ em todo o lado; e xu-exp:class substitui por completo o atributo class estático, pelo que as classes de esquema têm de ser repetidas dentro da expressão.

progFields, progEvents, progDataSource

Estado local (progFields, virtual ou associado a table), uma Fonte de dados incorporada opcional e eventos de ciclo de vida. Três desses eventos dividem o trabalho de uma forma fácil de trocar:

Colocar trabalho de atualização em screen_ready volta a executar a lógica de criação sobre um DOM que ainda existe e empilha um segundo widget sobre o primeiro.

Incorporar outro programa: xu-panel

xu-panel (tagName em minúsculas, atributo program) monta outro programa Componente com os seus próprios campos, fonte de dados e eventos, em contraste com uma etiqueta de sistema de design com maiúscula inicial. Passe valores para os seus parâmetros _in com atributos xu-exp:<param>; ao contrário de uma etiqueta de sistema de design, um painel pode escrever valores de volta nos seus campos através dos parâmetros _out.

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

Exemplo prático

Escolha a forma

Escolha single na caixa de diálogo Novo Componente para um só registo: construa diretamente dentro da raiz xu-template. Escolha multi para uma lista: cria por si um xu-multi-view dentro dessa raiz, adicione xu-for (ou a abreviatura for= do .xu) no nó repetido.

Associe os dados

xu-bind para campos de entrada, xu-exp:xu-content para texto calculado, um progDataSource se o componente tiver a sua própria leitura.

Ligue a interação

xu-on:click com um fluxo de trabalho ou, em .xu, um bloco de ação nomeado referenciado com @click.

Construa a árvore na tela: arraste elementos, defina atributos no painel de propriedades, ligue handlers xu-on:* a passos de fluxo de trabalho no editor de fluxos de trabalho. Prima o botão de reprodução da pré-visualização para verificar o resultado em direto.

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>

O .xu compila <single-view> para xu-single-view, :content para uma expressão xu-exp:xu-content e um atributo simples for="@list_v" para 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": [] }
  ]
}