Aller au contenu

Styliser avec des classes Tailwind

Guide pratique2 min de lecture
Modifier cette page

Vous stylerez des composants déclaratifs avec des classes utilitaires Tailwind. Les chaînes de classe sont analysées à la compilation en l’IR de style typé de Quoin et abaissées en appels de builder natifs au framework — il n’y a aucune analyse de classe à l’exécution et aucune recherche de chaîne dans le code émis.

Prérequis : la fonctionnalité macros (impliquée par toute fonctionnalité de framework).

quoin_render! {
div(class: "flex flex-col gap-4 p-4 bg-gray-900 text-white h-full") {
div(class: "text-2xl font-bold hover:text-blue-400") { "Hello" }
button(class: "px-4 py-2 bg-blue-600 rounded-md", on_click: move |_| increment()) {
"Increment"
}
}
}

Sur GPUI cela compile en chaînes de méthodes :

.flex().flex_col().gap(px(16.0)).p(px(16.0)).bg(rgb(0x111827))
.hover(|s| s.text_color(rgb(0x60a5fa)))

La même chaîne de classe s’abaisse au mécanisme de style natif de chaque backend, donc une seule source sert tous les frameworks.

L’analyseur intégré (quoin-style) modélise ce sous-ensemble de Tailwind :

  • Direction, enroulement et alignement Flexbox
  • Gap, padding, margin
  • Largeur/hauteur (valeurs de longueur)
  • Couleurs d’arrière-plan et de bordure (y compris les jetons de thème), largeurs de bordure, rayons d’angle
  • Opacité, curseur, décalages de position, débordement, ombres
  • Couleur, taille, graisse, alignement et famille du texte
  • La variante d’état hover:

Les classes inconnues sont une erreur de compilation. L’analyseur ne retire jamais silencieusement une classe qu’il ne reconnaît pas ; chaque backend doit transformer une classe non reconnue en compile_error! avec une suggestion did-you-mean.

Les noms de classe qui se mappent aux jetons de thème shadcn (17 noms de jetons) se résolvent en couleurs fixes — dans le moteur par défaut, les valeurs hexadécimales du thème sombre shadcn. Les jetons gardent le style des composants cohérent avec la résolution QuoinTheme de l’UCP.

Non publié

La fonctionnalité gpui-rsx-classes (activée automatiquement par la fonctionnalité gpui) fait passer les classes que Quoin ne connaît pas par le moteur de classes gpui-rsx, qui débloque :

  • La palette complète Tailwind à l’échelle 4 px, les fractions, les valeurs arbitraires et les utilitaires négatifs
  • Des variantes d’état supplémentaires : focus:, focus-visible:, active:, group-hover:, group-active:
  • Des expressions class: dynamiques résolues au moment du rendu (les classes dynamiques inconnues paniquent en mode strict)
  • Un vocabulaire personnalisé via un fichier rsx.toml à côté du Cargo.toml de votre crate, avec un suivi de reconstruction

Les classes que Quoin connaît déjà conservent leur abaissement octet pour octet sous ce drapeau, vérifié par les tests de parité.

Quand vous avez besoin de la machinerie gpui-rsx brute à l’intérieur d’un arbre quoin_render! — par exemple pour insérer un composant gpui-kit — la fonctionnalité rsx (impliquée par gpui) ré-exporte rsx!, rsx_strict!, rsx_permissive!, rsx_tw!, rsx_fragment!, rsx_expand!, rsx_runtime! et #[component] depuis la façade quoin.