Saltar al contenido
Verificada

Componente

La unidad de interfaz, un árbol de elementos vinculado al estado local, a los datos y a la lógica de flujo de trabajo que lo conecta todo.

Un Componente es una unidad de interfaz: un árbol de elementos vinculado al estado local, a datos opcionales, a la lógica del ciclo de vida y a una interfaz de entrada y salida. Una página, una tarjeta, un modal, un popover, un fragmento en línea, todos son Componentes, y es el tipo de documento más rico de la plataforma, pues lleva su propio árbol de interfaz junto con los campos, los eventos y la fuente de datos que comparte con todos los demás tipos de programa.

Propiedades

renderType es un indicador heredado, no una propiedad activa

renderType (form / grid / list) está obsoleto y ya no es obligatorio; los componentes nuevos se crean sin él. Lo que obtiene realmente un Componente nuevo es una elección de plantilla, single o multi, que se elige una vez en el cuadro de diálogo de Componente nuevo: single genera una raíz xu-template vacía lista para construir directamente en ella, multi genera la misma raíz xu-template con un div de carga y un xu-multi-view ya anidado dentro. xu-single-view sigue siendo una etiqueta real y utilizable, solo que no una que la fábrica coloque por ti: solo un documento heredado sin migrar (con la raíz aún sin ser xu-template) se comprueba contra ella, cuando su renderType obsoleto todavía dice form.

progUi, el árbol de elementos

El nodo raíz es siempre un xu-template transparente, generado por el scaffold_prog_ui de create_prog. Elegir la plantilla multi anida por ti un div de carga y un xu-multi-view dentro de él; la plantilla single lo deja vacío, construye directamente dentro de sus children. Cada nodo necesita un id único, type: "element", un tagName, y attributes: {} y children: [] aunque estén vacíos.

Además de las etiquetas HTML normales, se escribe directamente un puñado de etiquetas de xuda: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.

Un tagName con inicial mayúscula (Button, Dialog) se reclama siempre como un componente compilado del sistema de diseño, nunca como un elemento HTML, incluso cuando es un error tipográfico: lanza un error al montarse, nombrando la etiqueta y todas las fuentes probadas. Sus atributos normales se convierten en props, no en atributos del DOM (variant, color, class llegan todos como props.<name>), y a diferencia de xu-panel no tiene parámetros de salida, una etiqueta de componente solo lee lo que le pasas.

Comportamiento dinámico: atributos xu-*

Todos los atributos xu-* que puede llevar el árbol de elementos de un Componente:

Dos son fáciles de confundir: xu-bind recibe el id de campo sin más, sin @, la única excepción a la regla de @ en todos los demás sitios; y xu-exp:class sustituye por completo el atributo class estático, así que las clases de disposición hay que repetirlas dentro de la expresión.

progFields, progEvents, progDataSource

Estado local (progFields, virtual o vinculados a una table), una Fuente de datos incrustada opcional y eventos del ciclo de vida. Tres de esos eventos reparten el trabajo de una forma que es fácil de confundir:

Poner el trabajo de actualización en screen_ready vuelve a ejecutar la lógica de creación sobre un DOM que aún existe y apila un segundo widget sobre el primero.

Incrustar otro programa: xu-panel

xu-panel (tagName en minúsculas, atributo program) monta otro programa Componente con sus propios campos, fuente de datos y eventos, en contraste con una etiqueta del sistema de diseño con inicial mayúscula. Pasa valores a sus parámetros _in con atributos xu-exp:<param>; a diferencia de una etiqueta del sistema de diseño, un panel puede escribir valores de vuelta en tus campos mediante sus parámetros _out.

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

Ejemplo práctico

Elige la forma

Elige single en el cuadro de diálogo de Componente nuevo para un registro: construye directamente dentro de la raíz xu-template. Elige multi para una lista: genera por ti un xu-multi-view dentro de esa raíz; añade xu-for (o la abreviatura for= de .xu) en el nodo que se repite.

Vincula los datos

xu-bind para campos de entrada, xu-exp:xu-content para texto calculado, un progDataSource si el componente tiene su propia lectura.

Conecta la interacción

xu-on:click con un flujo de trabajo, o en .xu, un bloque de acción con nombre al que se hace referencia con @click.

Construye el árbol en el lienzo: arrastra elementos, establece atributos en el panel de propiedades, conecta los manejadores xu-on:* a los pasos de flujo de trabajo en el editor de flujos de trabajo. Pulsa el botón reproducir de la vista previa para comprobar el resultado en vivo.

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 compila <single-view> a xu-single-view, :content a una expresión xu-exp:xu-content, y un atributo for="@list_v" sin más a 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": [] }
  ]
}