Aller au contenu

Composer des composants UCP

Guide pratique1 min de lecture
Modifier cette page

Vous construirez des composants riches — tables, listes virtuelles, menus déroulants, accès au presse-papiers — via le Universal Component Protocol (UCP), afin que le code de composition reste agnostique vis-à-vis du framework pendant qu’une crate d’adaptateur fournit le rendu natif.

Prérequis : la fonctionnalité ui (incluse par la fonctionnalité gpui) ; pour le rendu GPUI, l’adaptateur embarque quoin-ui-gpui automatiquement.

L’UCP divise les widgets riches en :

  1. Traits dans quoin-ui — contrats abstraits tels que TableAdapter, VirtualListAdapter, ButtonAdapter, TextInputAdapter, DropdownMenuAdapter, TabBarAdapter et Clipboard.
  2. Implémentations d’adaptateur — crates concrètes par framework telles que quoin-ui-gpui qui savent rendre le widget nativement.

Votre code parle aux traits ; la fonctionnalité de framework tire l’implémentation.

ButtonVariant sélectionne l’emphase (primary, ghost, destructive) et la densité (ComponentSize::Small | Medium | Large) :

use quoin_ui::{ButtonAdapter, ButtonVariant, ComponentSize};
let adapter = GpuiButtonAdapter::default();
let button = adapter.render(Some("Click Me".into()), ButtonVariant {
primary: true,
size: ComponentSize::Medium,
..Default::default()
});

À l’intérieur de quoin_render!, l’élément data_table déclare des colonnes avec clés, libellés et fermetures de rendu ; le tri et le zébrage viennent des attributs :

data_table(rows: people, striped: true) {
column(key: "name", label: "Name", render: |p: &Person| p.name.clone())
column(key: "age", label: "Age", render: |p: &Person| p.age.to_string())
}

SortDirection (None | Asc | Desc) modélise l’état de tri par colonne côté TableAdapter.

virtual_list adosse les listes défilables au contrat VirtualListAdapter pour que seules les lignes visibles soient rendues ; la restauration du défilement fait partie du vocabulaire de nœuds (scroll_restoration).

Le trait Clipboard abstrait le presse-papiers système ; l’élément clipboard_button câble un bouton qui copie du texte et rapporte le succès :

clipboard_button(copy_text: "Copied!") { "Copy" }

QuoinTheme résout les jetons de couleur de thème pour les adaptateurs, donc les composants UCP récupèrent des couleurs cohérentes entre apparences claire et sombre sans valeurs hexadécimales codées en dur dans votre code.