Formations — 1 037 leçons en français

Accueil › Vue.js › `v-if` et `v-for` sur le même élément

`v-if` et `v-for` sur le même élément

Listes et rendu conditionneldebutant

Mettre v-if et v-for sur le même élément est une erreur en Vue 3.

<!-- ❌ t n'existe pas encore quand v-if est évalué -->
<li v-for="t in taches" v-if="!t.fait" :key="t.id">{{ t.titre }}</li>

En Vue 3, v-if a la priorité sur v-for. Il est évalué en premier, donc l'alias t créé par la boucle n'est pas encore défini : le rendu échoue. Vue 2 faisait l'inverse — le code fonctionnait, mais parcourait toute la liste pour n'en afficher qu'une partie. L'inversion transforme un piège silencieux en erreur immédiate.

Deux façons correctes, selon ce que la condition exprime.

Filtrer la collection — la bonne réponse dans presque tous les cas :

<script setup lang="ts">
const aFaire = computed(() => taches.value.filter((t) => !t.fait))
</script>

<template>
  <li v-for="t in aFaire" :key="t.id">{{ t.titre }}</li>
</template>

Déplacer la boucle sur un <template> quand la condition doit rester dans le template — parce qu'elle dépend d'autre chose que de l'élément, par exemple :

<template v-for="t in taches" :key="t.id">
  <li v-if="!t.fait">{{ t.titre }}</li>
</template>

Ici l'alias est défini avant que le v-if intérieur soit évalué.

Les termes à connaître

Priorité des directives

L'ordre dans lequel Vue applique deux directives au même élément. En Vue 3, v-if est évalué avant v-for.

Alias indisponible

Conséquence directe de cette priorité : au moment où le v-if est évalué, la variable créée par le v-for n'existe pas encore.

`<template v-for>` + `v-if`

Le contournement officiel : la boucle sur le <template>, la condition sur l'élément à l'intérieur. L'alias est alors défini.

Liste filtrée

La solution recommandée : un computed qui filtre la collection, et un v-for sans condition dans le template.

`computed`

Une valeur dérivée, mise en cache et recalculée seulement quand ses dépendances changent. L'endroit naturel d'un filter.

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.