Aller au contenu
Vérifié

Composant

L'unité d'interface : une arborescence d'éléments liée à un état local, à des données et à la logique de workflow qui les relie.

Un Composant est une unité d'interface : une arborescence d'éléments liée à un état local, à des données facultatives, à une logique de cycle de vie et à une interface d'entrée et de sortie. Une page, une carte, une modale, un popover, un fragment en ligne, tous sont des Composants, et c'est le type de document le plus riche de la plateforme : il porte sa propre arborescence d'interface à côté des champs, événements et source de données partagés avec tous les autres types de programme.

Propriétés

renderType est un indicateur hérité, pas une propriété active

renderType (form / grid / list) est obsolète et n'est plus requis ; les nouveaux composants sont créés sans lui. Ce que reçoit réellement un nouveau Composant est un choix de squelette, single ou multi, fait une fois dans la boîte de dialogue Nouveau composant : single crée une racine xu-template vide, prête à être construite directement, multi crée la même racine xu-template avec un div de chargement et un xu-multi-view déjà imbriqué à l'intérieur. xu-single-view reste une balise réelle et utilisable, simplement pas une que la fabrique place pour vous : seul un ancien document non migré (racine pas encore xu-template) est vérifié par rapport à elle, quand son renderType périmé indique encore form.

progUi, l'arborescence d'éléments

Le nœud racine est toujours un xu-template transparent, créé par scaffold_prog_ui de create_prog. Choisir le squelette multi y imbrique pour vous un div de chargement et un xu-multi-view ; le squelette single le laisse vide, construisez directement dans ses children. Chaque nœud a besoin d'un id unique, de type: "element", d'un tagName, et de attributes: {} et children: [] même s'ils sont vides.

Outre les balises HTML ordinaires, quelques balises xuda s'écrivent directement : xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.

Un tagName en majuscule initiale (Button, Dialog) est toujours réclamé comme composant de système de design compilé, jamais comme élément HTML, même en cas de faute de frappe : il lève une erreur au montage, en nommant la balise et chaque source essayée. Ses attributs simples deviennent des props, pas des attributs DOM (variant, color, class arrivent tous sous la forme props.<name>), et contrairement à xu-panel il n'a pas de paramètres de sortie : une balise de composant lit seulement ce que vous lui passez.

Comportement dynamique : attributs xu-*

Tous les attributs xu-* que peut porter l'arborescence d'éléments d'un Composant :

Deux sont faciles à inverser : xu-bind prend l'identifiant de champ nu, sans @, la seule exception à la règle du @ partout ailleurs ; et xu-exp:class remplace entièrement l'attribut class statique, donc les classes de mise en page doivent être répétées à l'intérieur de l'expression.

progFields, progEvents, progDataSource

L'état local (progFields, virtual ou lié à une table), une Source de données intégrée facultative, et les événements de cycle de vie. Trois de ces événements se partagent le travail d'une façon facile à inverser :

Mettre le travail d'actualisation dans screen_ready relance la logique de création sur un DOM qui existe encore, et empile un second widget sur le premier.

Intégrer un autre programme : xu-panel

xu-panel (tagName en minuscules, attribut program) monte un autre programme Composant avec ses propres champs, source de données et événements, par opposition à une balise de système de design en majuscule initiale. Passez des valeurs à ses paramètres _in avec des attributs xu-exp:<param> ; contrairement à une balise de système de design, un panneau peut réécrire des valeurs dans vos champs via ses paramètres _out.

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

Exemple concret

Choisissez la forme

Choisissez single dans la boîte de dialogue Nouveau composant pour un seul enregistrement : construisez directement dans la racine xu-template. Choisissez multi pour une liste : un xu-multi-view est créé pour vous dans cette racine, ajoutez xu-for (ou le raccourci for= de .xu) sur le nœud répété.

Liez les données

xu-bind pour les champs de saisie, xu-exp:xu-content pour du texte calculé, un progDataSource si le composant possède sa propre lecture.

Branchez l'interaction

xu-on:click avec un workflow, ou en .xu, un bloc d'actions nommé référencé avec @click.

Construisez l'arborescence sur le canevas : faites glisser des éléments, définissez des attributs dans le panneau des propriétés, branchez les gestionnaires xu-on:* sur des étapes de workflow dans l'éditeur de workflow. Appuyez sur le bouton lecture de l'aperçu pour vérifier le résultat en direct.

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 compile <single-view> en xu-single-view, :content en expression xu-exp:xu-content, et un attribut nu for="@list_v" en 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": [] }
  ]
}