Toute l’analyse et la génération de code vivent dans quoin-macros-core ; la crate quoin-macros est la frontière proc_macro. La distribution par backend sélectionne exactement un framework — activer deux fonctionnalités de framework est une erreur de compilation, par conception.
Import : use quoin_macros::{component, effect, quoin_element, quoin_render, run_app}; (ré-exporté à travers la façade quoin quand une fonctionnalité de framework est activée).
component
Section intitulée « component »Définit un composant réactif agnostique vis-à-vis du framework. Blocs reconnus :
| Bloc | Contenu |
|---|---|
props |
Champs d’entrée typés avec défauts, par ex. initial_count: u32 = 0. |
state |
Champs réactifs avec valeurs initiales ; chacun devient un signal. |
globals |
Valeurs globales récupérées du contexte ; suffixe observe pour suivre les changements. |
on_mount / on_unmount |
Hooks de cycle de vie exécutés au montage / démontage. |
fn … |
Actions — fonctions ordinaires sur les signaux d’état. |
render |
L’arbre de vue ; s’exécute à chaque passe de rendu. |
Sortie par framework : une struct avec une implémentation Render (GPUI), #[component] fn … -> impl IntoView (Leptos), #[component] fn … -> Element (Dioxus).
quoin_render
Section intitulée « quoin_render »UI déclarative de type JSX avec transpilation de classes Tailwind.
| Syntaxe | Signification |
|---|---|
div(class: "…") { … } |
Élément avec classes et enfants. |
if[cond] { … } |
Sous-arbre conditionnel. |
for[item in items] { … } |
Répétition sur un itérable. |
attr: value |
Attribut nommé (classes, handlers, configuration). |
on_click: |ev| … |
Handler recevant un événement typé. |
Le vocabulaire d’éléments inclut div, button, tabs/tab, data_table/column, virtual_list, dropdown_menu, input, checkbox, radio, switch, slider, icon, badge, tooltip, progress, skeleton, scroll_area, separator, styled_text et clipboard_button.
quoin_element
Section intitulée « quoin_element »Déclare un élément personnalisé nommé avec props typées et une fermeture de rendu :
quoin_element!("my-widget", { width: u32 }, |props| quoin_render! { div { "w" } });Exécute des effets de bord réactivement. Deux syntaxes :
| Forme | Structure |
|---|---|
| Historique | effect! { watch: [signal], || … } |
| Structurée | effect! { deps: […], run: || …, cleanup: || … } — cleanup optionnel |
Expansion par framework : create_effect + on_cleanup (Leptos), use_effect + use_drop (Dioxus), run-on-execute + cleanup-on-drop (GPUI).
Amorce l’application en une seule ligne.
| Forme | Comportement |
|---|---|
run_app!(MyComponent) |
GPUI avec options de fenêtre par défaut ; Leptos/Dioxus montent sur body. |
run_app!(MyComponent, window_opts: custom_opts) |
GPUI avec options de fenêtre personnalisées. |
Étapes suivantes
Section intitulée « Étapes suivantes »-
Macros UI déclarativesExemples travaillés pour chaque macro.
-
Styliser avec des classes TailwindComment les chaînes de classe compilent en style natif.
