v-for rendert eine Liste von Elementen durch Iteration über ein Array (oder object/range). Sie sollten es immer mit einem eindeutigen :key koppeln, damit Vue Elemente effizient verfolgen kann.
<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 verwendet key, um zu identifizieren, welche Elemente sich geändert haben, hinzugefügt oder entfernt wurden, sodass es bestehende DOM-Knoten wiederverwenden und neu anordnen kann, anstatt sie neu zu erstellen. Ohne einen stabilen key fällt Vue auf eine "in-place patch"-Strategie zurück, die Fehler verursachen kann:
<!-- ❌ 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>
Den Array-Index als key zu verwenden, ist ein häufiger Fehler — wenn Elemente neu angeordnet, eingefügt oder gelöscht werden, kann sich der component/DOM-Zustand (wie Input-Werte oder Checkbox-Zustände) an der falschen Zeile festsetzen.
<!-- ❌ 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 ist, wie Sie dynamische Listen rendern.
Das :key ist praktisch nicht optional: Ein stabiler, eindeutiger key ermöglicht es Vues virtual DOM, effizient zu diff, und vermeidet subtile State-Mismatch-Fehler bei Neuanordnung/Filterung.
Zu wissen, wie man eine echte ID verwendet (niemals den Index für dynamische Listen) und v-for/v-if getrennt hält, ist für korrekte, performante Listen unerlässlich.