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 (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.
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.
.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.