Aller au contenu

Partager l'état global

Guide pratique2 min de lecture
Modifier cette page

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).

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.

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);

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.

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.