Formations — 1 037 leçons en français

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 :

  1. L'injection remonte la chaîne des ancêtres et s'arrête au premier fournisseur. Le plus proche gagne.
  2. Pour rester réactif, on fournit le ref, pas sa valeur.
  3. Un second argument d'inject sert de valeur par défaut. Sans lui, l'absence de fournisseur donne undefined et 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 / inject ré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 renvoie undefined.

Couplage implicite

La contrepartie de provide / inject : rien dans la signature du descendant ne dit de quel ancêtre il dépend.

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.