Un exemple de code avec l’utilisation ':key' hors d’un 'v-for'

Rafraichir les composants Vue sur un changement de route

Une bonne pratique lorsque la route actuelle change sur une application Vue est de rendre le composant de router-view unique en utilisant la propriété key. Comme décrit dans la documentation officielle, L’attribut spécial key est principalement utilisé comme une indication aidant l’algorithme du DOM virtuel de Vue à identifier les VNodes lors de la comparaison de la nouvelle et de l’ancienne liste de nœuds. Voyons comment il peut être utilisé avec vue-router.

Pendant que je travaillais sur le cours Masterclass de Vueschool.io, j’ai construit cette pagination géniale à partir de rien pour me mettre au défi :

pagination-ui

Vous pouvez la voir en action sur cette page de démonstration ou celle-ci.

Elle contient des boutons page précédente et page suivante pour se déplacer d’une page à l’autre, ainsi qu’un bouton plage précédente et un autre pour la plage suivante pour avancer dans la pagination et sélectionner une page spécifique.

J’ai utilisé la chaîne de requête page=x dans l’URL pour que la page actuelle soit détectée lors du chargement et du changement de page.

Une fois que j’avais bien stabilisé l’algorithme de mise à jour de la plage affichée et la logique d’affichage des boutons dans un état particulier, j’ai essayé de l’intégrer à un composant parent.

Au début, j’ai utilisé le hook updated pour gérer le changement de page et cela a fonctionné sur l’application gérée avec Vuecli. Tout fonctionnait bien avec l’API Options.

Mais après avoir transposé le JavaScript en TypeScript et utilisé l’API Composition, l’application gérée avec Vite ne se comportait pas comme prévu sur le clic des boutons page précédente et page suivante, ce qui bloquait la navigation.

Qu’est-ce qui n’allait pas ?

Dans mon App.vue, je n’utilisais pas un :key unique sur le composant router-view.

Cela provoquait un échec visuel du re-rendu de la page.

Pour résoudre ce problème, grâce à Daniel Kelly, comme il l’a expliqué dans cette leçon, j’ai eu besoin d’inclure la chaîne de la route courante dans la clé.

Auparavant, j’avais :

1
<router-view :key="`$route.path" />

Après, c’est devenu :

1
<router-view :key="`${$route.path}${JSON.stringify($route.query)}`" />

Lors d’un changement de route, l’utilisation de la propriété :key est vraiment essentielle pour éviter des bugs comme celui-ci.