Accueil › Vue.js › Injection typée et clés d'injection
Injection typée et clés d'injection
Patterns de compositionavance
provide et inject franchissent les niveaux sans props intermédiaires. Le
problème qu'ils posent est ailleurs : une clé en chaîne ne dit rien du type de
la valeur, et rien n'empêche deux bibliothèques d'utiliser 'config'.
InjectionKey<T> règle les deux d'un coup.
// cles.ts
import type { InjectionKey, Ref } from 'vue'
export interface Panier {
lignes: Ref<Ligne[]>
ajouter: (produit: Produit) => void
}
export const clePanier = Symbol('panier') as InjectionKey<Panier>
<!-- Fournisseur -->
<script setup lang="ts">
import { provide, readonly, ref } from 'vue'
import { clePanier } from './cles'
const lignes = ref<Ligne[]>([])
function ajouter(p: Produit) { lignes.value.push({ produit: p, quantite: 1 }) }
provide(clePanier, { lignes: readonly(lignes), ajouter })
</script>
<!-- Consommateur, à n'importe quelle profondeur -->
<script setup lang="ts">
const panier = inject(clePanier) // Panier | undefined
</script>
Le symbole est unique, donc sans collision possible. Le type voyage avec la
clé : provide refuse une valeur mal formée, inject renvoie le bon type.
Reste undefined, qui apparaît quand aucun ancêtre ne fournit — et qu'il faut
traiter, pas ignorer.
Les termes à connaître
- InjectionKey
Type générique de Vue,
InjectionKey<T>. UnSymbolporteur du type de la valeur fournie, qui relieprovideetinjectsans annotation manuelle.- Clé symbole
Une clé d'injection déclarée avec
Symbol(). Elle ne peut pas entrer en collision avec une autre clé, contrairement à une chaîne.- Valeur par défaut
Deuxième argument d'
inject. Elle est renvoyée quand aucun ancêtre ne fournit la clé. Sans elle,injectrenvoieundefinedet avertit en développement.- Usine de défaut
inject(cle, () => new X(), true): le troisième argumenttrueindique que le deuxième est une fabrique à appeler, pas la valeur elle-même.- Fournisseur le plus proche
injectremonte la chaîne des ancêtres et s'arrête au premier qui fournit la clé. Un descendant peut donc réécrire ce que sa branche reçoit.- Injection en lecture seule
Fournir
readonly(etat)avec une fonction de mise à jour, plutôt que l'état brut. Le consommateur lit, mais ne peut écrire que par le canal prévu.- hasInjectionContext
Fonction de Vue qui indique si l'on se trouve dans un contexte où
injectest permis. Utile dans un composable qui doit fonctionner hors composant.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.