Formations — 1 037 leçons en français

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, avec n valant 1 puis 2… jusqu'à 5. Le compte commence à 1, pas à 0.

Parcours d'objet

v-for="(valeur, cle, index) in objet" suit l'ordre de Object.keys() — l'ordre d'insertion pour des clés non numériques.

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.