Accueil › Vue.js › Parcourir une liste avec v-for
Parcourir une liste avec v-for
Listes et rendu conditionneldebutant
v-for répète un élément de template une fois par entrée d'une collection.
La syntaxe est celle d'un for…of JavaScript, avec in à la place de of.
<script setup lang="ts">
const clients = ref([
{ id: 12, nom: 'Durand' },
{ id: 47, nom: 'Nkomo' },
])
</script>
<template>
<li v-for="client in clients" :key="client.id">
{{ client.nom }}
</li>
</template>
L'alias client n'existe qu'à l'intérieur de l'élément répété et de ses
descendants. Un second alias donne l'index :
v-for="(client, i) in clients".
La :key n'est pas facultative. Elle donne à chaque élément rendu une
identité stable. Sans elle, Vue réutilise les nœuds du DOM par position, et
l'état interne d'un <input> ou d'un composant enfant suit la mauvaise ligne
dès que la liste change d'ordre. Utilisez l'identifiant métier — celui qui
vient de la base de données.
v-for accepte aussi un nombre et un objet :
<span v-for="n in 5" :key="n">★</span>
<li v-for="(valeur, cle) in profil" :key="cle">
{{ cle }} : {{ valeur }}
</li>
Le parcours de plage commence à 1, pas à 0. Le parcours d'objet donne
(valeur, cle, index) dans cet ordre — la valeur d'abord, comme pour un
tableau.
Pour répéter plusieurs balises sans en ajouter une dans le DOM, mettez
v-for sur un <template> et la :key sur ce <template>.
Les termes à connaître
- `v-for`
La directive qui répète un élément de template une fois par entrée d'un tableau, d'un objet, d'un nombre ou de tout itérable.
- Alias
Le nom de la variable locale créée par
v-for, visible uniquement à l'intérieur de l'élément répété et de ses descendants.- `:key`
L'identifiant que vous donnez à chaque élément rendu pour que Vue sache, au rendu suivant, lequel est lequel.
- `<template v-for>`
Un conteneur invisible qui permet de répéter plusieurs éléments sans introduire de balise supplémentaire dans le DOM.
- Parcours de plage
v-for="n in 5"répète cinq fois, avecnvalant 1 puis 2… jusqu'à 5. Le compte commence à 1, pas à 0.- Parcours d'objet
v-for="(valeur, cle, index) in objet"suit l'ordre deObject.keys()— l'ordre d'insertion pour des clés non numériques.
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.