Accueil › Vue.js › `provide` et `inject`, et leur juste place
`provide` et `inject`, et leur juste place
Composants et propsdebutant
provide et inject relient un ancêtre à ses descendants sans passer par les
composants intermédiaires. C'est la réponse au forage de props : une donnée
qui traverse quatre composants dont trois ne s'en servent pas.
<!-- Application.vue -->
<script setup lang="ts">
import { provide, ref, readonly } from 'vue'
const theme = ref<'clair' | 'sombre'>('clair')
function basculer() {
theme.value = theme.value === 'clair' ? 'sombre' : 'clair'
}
provide('theme', { theme: readonly(theme), basculer })
</script>
<!-- Bouton.vue, à n'importe quelle profondeur -->
<script setup lang="ts">
import { inject } from 'vue'
const { theme } = inject('theme', { theme: ref('clair') })
</script>
Trois règles :
- L'injection remonte la chaîne des ancêtres et s'arrête au premier fournisseur. Le plus proche gagne.
- Pour rester réactif, on fournit le
ref, pas sa valeur. - Un second argument d'
injectsert de valeur par défaut. Sans lui, l'absence de fournisseur donneundefinedet un avertissement.
Ce mécanisme a un coût : rien dans la signature du descendant ne dit de quel ancêtre il dépend. Extrait de son arbre, il cesse de fonctionner sans erreur de compilation. On l'utilise donc pour ce qui est ambiant — thème, locale, instance de formulaire — et pas pour une donnée métier qu'une prop transporterait aussi bien.
Les termes à connaître
- `provide`
Dépose une valeur sous une clé dans un composant. Tous ses descendants, à n'importe quelle profondeur, peuvent la demander.
- `inject`
Récupère dans un descendant la valeur fournie par l'ancêtre le plus proche pour une clé donnée.
- Forage de props
Le fait de faire traverser une donnée à des composants intermédiaires qui ne s'en servent pas. Le problème que
provide/injectrésout.- `InjectionKey`
Un symbole typé (
Symbol() as InjectionKey<T>) qui relie la valeur fournie et la valeur injectée par le type, et évite les collisions de noms.- Valeur par défaut
Le second argument d'
inject, utilisé quand aucun ancêtre ne fournit la clé. Sans lui, Vue avertit et renvoieundefined.- Couplage implicite
La contrepartie de
provide/inject: rien dans la signature du descendant ne dit de quel ancêtre il dépend.
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.