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
watchetcomputedcréé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.
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.