Formations — 1 037 leçons en français

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>. Un Symbol porteur du type de la valeur fournie, qui relie provide et inject sans 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, inject renvoie undefined et avertit en développement.

Usine de défaut

inject(cle, () => new X(), true) : le troisième argument true indique que le deuxième est une fabrique à appeler, pas la valeur elle-même.

Fournisseur le plus proche

inject remonte 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ù inject est permis. Utile dans un composable qui doit fonctionner hors composant.

Lire l'explication détaillée et faire le quiz →

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.