Vous stockerez des valeurs à l’échelle de l’application — thème, paramètres, état de routeur — hors de tout composant unique et les accéderez depuis n’importe quel hook ou vue.
Prérequis : un contexte implémentant ReactiveContext (voir Écrire des hooks portables).
Fournir et lire un global
Section intitulée « Fournir et lire un global »provide_global stocke une valeur indexée par son type ; use_global la récupère comme handle de signal réactif :
cx.provide_global(Theme::Dark);
if let Some(theme) = cx.use_global::<Theme>() { // theme est un handle de signal — lisez-le ou observez-le. let current = theme.get();}Stockez une valeur par type et par contexte. Deux adaptateurs tournant sur le même thread n’entrent jamais en collision : le magasin sous-jacent indexe les entrées par le type de contexte et le type de valeur.
Mettre à jour un global en place
Section intitulée « Mettre à jour un global en place »update_global (de ReactiveContextExt, dans le prelude) mute la valeur stockée via une fermeture. Le paramètre de type après la struct est votre type d’erreur — renvoyez Err pour rejeter la mise à jour :
cx.update_global::<Settings, ()>(|s| s.theme = Theme::Dark);Initialiser à la première utilisation
Section intitulée « Initialiser à la première utilisation »use_global_or_init insère un défaut quand aucune valeur n’existe encore et renvoie le handle dans tous les cas :
let settings = cx.use_global_or_init(Settings::default);Cela remplace la danse fournir-puis-lire pour les globals qui existent toujours.
Sémantique sur chaque adaptateur
Section intitulée « Sémantique sur chaque adaptateur »Les cinq adaptateurs partagent une sémantique : chaque appel à use_global renvoie un handle vers la même cellule partagée, donc une mutation effectuée via un handle est visible via tous les autres. Les adaptateurs à tirage (GPUI, Xilem, Floem) adossent cela à une carte thread-locale à clé TypeId, correspondant aux hypothèses de thread principal de chaque framework :
- Les globals sont visibles sur le thread qui les a enregistrés.
- GPUI, Xilem et Floem partagent la même machinerie thread-locale de
quoin_core::globals; les adaptateurs à grain fin se mappent sur leurs propres magasins avec un comportement observable identique.
Étapes suivantes
Section intitulée « Étapes suivantes »-
Référence du contexte réactifLa surface complète de ReactiveContext et ReactiveContextExt, y compris les méthodes de global.
-
Le modèle de réactivitéComment signaux, batching et globals interagissent sous le capot.
