v-for tömbön (vagy objektumon/tartományon) végigiterálva rendereli az elemek listáját. Mindig párosítsa ezt egy egyedi :key-vel, hogy a Vue hatékonyan követhesse az elemeket.
<script setup>
import { ref } from "vue";
const items = ref([{ id: 1, name: "Apple" }, { id: 2, name: "Banana" }]);
</script>
<template>
<ul>
<li v-for="item in items" :key="item.id">{{ item.name }}</li>
</ul>
</template>
<template>
<li v-for="(item, index) in items" :key="item.id">{{ index }}: {{ item.name }}</li>
<li v-for="(value, key) in myObject" :key="key">{{ key }}: {{ value }}</li>
<span v-for="n in 5" :key="n">{{ n }}</span> <!-- range 1..5 -->
</template>
A Vue a key segítségével azonosítja, mely elemek változtak meg, kerültek hozzáadásra vagy eltávolításra, így újra felhasználhatja és átrendezheti a meglévő DOM csomópontokat ahelyett, hogy újraépítené őket. Stabilan kulcs nélkül a Vue egy "helyben történő javítás" stratégiára esik vissza, amely hibákat okozhat:
<!-- ❌ using index as key → wrong when the list reorders/filters -->
<li v-for="(item, i) in items" :key="i">
<input /> <!-- input state can attach to the WRONG item after reordering -->
</li>
<!-- ✅ stable unique id → Vue tracks each item correctly -->
<li v-for="item in items" :key="item.id">...</li>
A tömb indexének kulcsként történő használata gyakori hiba — amikor az elemeket átrendezik, beszúrják vagy törölik, az összetevő/DOM állapota (például az input értékek vagy a jelölőnégyzet állapota) a rossz sorra ragadhat.
<!-- ❌ avoid — ambiguous precedence -->
<li v-for="x in items" v-if="x.active">...</li>
<!-- ✅ filter in a computed, or wrap with <template v-for> -->
A v-for a dinamikus listák renderelésének módja.
A :key gyakorlatban nem opcionális: egy stabil, egyedi kulcs lehetővé teszi a Vue virtuális DOM diffhez való hatékony hozzáadást, és elkerüli a finom állapoteltérési hibákat az átrendezésnél/szűrésnél.
Annak ismerete, hogy valódi id-t kell használni (soha az index nem dinamikus listáknál), és a v-for/v-if eltartása külön alapvető követelmény a helyes, hatékony listáknál.