Aller au contenu

Événements typés

Référence1 min de lecture
Modifier cette page

Le module ev (ré-exporté depuis la façade quoin comme quoin::ev) définit des événements typés partagés par chaque backend. Les handlers reçoivent de petits types valeur au lieu d’objets d’événement natifs du framework, donc la même source de handler compile sur les cinq adaptateurs. Chaque adaptateur convertit depuis son propre type d’événement via des implémentations From qui sont #[inline(always)] dans le code généré.

Import : use quoin::ev; (façade) — les types sont des structs de valeur.

Arité du handler Contrat
Zéro paramètre (|| …) Valide sur chaque backend ; l’adaptateur appelle le handler sans charge utile.
Un paramètre Reçoit l’une des structs de charge utile ci-dessous. Pendant la période de transition, () se convertit encore pour les handlers à zéro argument, ce qui garde le code GPUI existant compilant à l’identique.
Type Déclenché par Notes
Click Clic primaire / activation Le décorateur action de Floem et les callbacks de bouton de Xilem déclenchent ceci. C’est une struct de type unité (Click {}) avec un constructeur Click::new(). Les adaptateurs avec des données de pointeur plus riches élargiront la struct dans des jalons ultérieurs sans changer l’arité du handler.
// Handler à zéro paramètre — valide sur chaque backend :
button(class: "px-4 py-2", on_click: || increment())
// Handler à un paramètre recevant la charge utile typée :
button(on_click: |ev: quoin::ev::Click| { /* ... */ })