v-for bir dizi (veya nesne/aralık) üzerinde yineleyerek öğelerin bir listesini render eder. Bunu her zaman benzersiz bir :key ile eşleştirmelisiniz, böylece Vue öğeleri verimli bir şekilde takip edebilir.
<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 key kullanarak hangi öğelerin değiştirildiğini, eklendiğini veya kaldırıldığını belirler, böylece mevcut DOM düğümlerini yeniden kullanıp yeniden sıralayabilir yerine onları yeniden oluşturmak yerine. Kararlı bir key olmadan, Vue "in-place patch" stratejisine geri döner ve bu da hatalara neden olabilir:
<!-- ❌ 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>
Dizi indeksini key olarak kullanmak yaygın bir hatadır — öğeler yeniden sıralanırsa, eklenirse veya silinirse, bileşen/DOM durumu (giriş değerleri veya onay kutusu durumları gibi) yanlış satırda kalabilir.
<!-- ❌ 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 dinamik listeleri render etme şeklinizdir.
:key pratikte isteğe bağlı değildir: kararlı, benzersiz bir key, Vue'nun sanal DOM diff'ini verimli bir şekilde yapmasını sağlar ve yeniden sıralama/filtreleme sırasında hafif durum uyuşmazlığı hatalarını önler.
Gerçek bir id kullanmayı (dinamik listeler için asla indeks değil) ve v-for/v-if ayrı tutmayı bilmek, doğru ve yüksek performanslı listeler için gereklidir.