Formations — 1 037 leçons en français

Accueil › Vue.js › Arguments réactifs et nettoyage

Arguments réactifs et nettoyage

Les composablesintermediaire

Un composable est appelé une seule fois, pendant la mise en place. Un argument passé en valeur nue est donc figé à cet instant.

const { resultats } = useRecherche(props.terme)  // la valeur du moment, et c'est tout

La solution est d'accepter une source relisable : une ref, ou une fonction d'accès. toValue normalise les trois formes.

import { toValue, watchEffect, ref } from 'vue'
import type { MaybeRefOrGetter } from 'vue'

export function useRecherche(terme: MaybeRefOrGetter<string>) {
  const resultats = ref<string[]>([])

  watchEffect(() => {
    const t = toValue(terme)          // valeur nue, ref ou fonction : peu importe
    resultats.value = chercher(t)
  })

  return { resultats }
}

Les trois appels suivants fonctionnent, et les deux derniers restent vivants.

useRecherche('vue')            // figé, mais accepté
useRecherche(termeRef)         // suivi
useRecherche(() => props.q)    // suivi

Pour le nettoyage, la règle est double. Ce que Vue a créé pendant la mise en place — watch, watchEffect, computed — est arrêté au démontage du composant hôte. Ce qui vient de l'extérieur — un écouteur window, un minuteur, un observateur du navigateur — ne l'est pas : il faut le défaire soi-même dans onUnmounted ou onScopeDispose.

Les termes à connaître

toValue

Normalise un argument : renvoie la valeur telle quelle, déballe une ref, ou appelle une fonction d'accès. Ajouté en Vue 3.3.

MaybeRefOrGetter

Le type TypeScript d'un argument accepté sous trois formes : valeur nue, ref, ou fonction qui renvoie la valeur.

Fonction d'accès

Une fonction sans argument qui renvoie la valeur à suivre, par exemple () => props.id. Elle garde le lien réactif là où une valeur nue le perdrait.

Composition

Un composable qui en appelle un autre. Chaque composable reste une fonction, donc la composition ne demande aucun mécanisme particulier.

onScopeDispose

Enregistre un nettoyage exécuté à la destruction de la portée d'effets courante. Dans un composant, cette portée se détruit au démontage.

Nettoyage automatique

Les watch et computed créés pendant la mise en place sont arrêtés au démontage du composant. Les écouteurs posés à la main ne le sont pas.

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.