v-for rendert een list van elementen door over een array (of object/bereik) te itereren. Je moet het altijd koppelen aan een unieke :key zodat Vue items efficiënt kan volgen.
<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>
Vue gebruikt de key om te bepalen welke items zijn gewijzigd, toegevoegd of verwijderd, zodat het bestaande DOM-knooppunten kan hergebruiken en opnieuw ordenen in plaats van ze opnieuw op te bouwen. Zonder een stabiele sleutel valt Vue terug op een "in-place patch"-strategie die bugs kan veroorzaken:
<!-- ❌ 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>
De array index als sleutel gebruiken is een veelgemaakte fout — wanneer items worden opnieuw geordend, ingevoegd of verwijderd, kunnen component/DOM-staat (zoals invoerwaarden of selectievakjes) aan de verkeerde rij blijven plakken.
<!-- ❌ avoid — ambiguous precedence -->
<li v-for="x in items" v-if="x.active">...</li>
<!-- ✅ filter in a computed, or wrap with <template v-for> -->
v-for is hoe je dynamische lijsten rendert.
De :key is in de praktijk niet optioneel: een stabiele, unieke sleutel laat Vue's virtual DOM efficiënt differ en vermijdt subtiele state-mismatch bugs bij opnieuw ordenen/filteren.
Weten wanneer je een echte id gebruikt (nooit de index voor dynamische lijsten) en v-for/v-if gescheiden houdt, is essentieel voor correcte, performante lijsten.