v-for paraqet një listë elementesh duke përsëritur një grup (ose objekt/gamë). Duhet ta bashkëzini gjithmonë me një :key unik në mënyrë që Vue të ndjekë artikujt në mënyrë efikase.
<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 përdor key për të identifikuar se cilat artikuj ndryshuan, u shtuan ose u hiq, në mënyrë që të mund të ripërdorë dhe rirredhë nyjet ekzistuese të DOM në vend që të ato të ribanin. Pa një key të qëndrueshëm, Vue kthehet në strategjinë "in-place patch" që mund të shkaktojë defekte:
<!-- ❌ 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>
Përdorimi i indeksit të grupit si key është një gabim i zakonshëm — kur artikujt renditen, futen ose fshihen, gjendja e komponentës/DOM (si vlerat e inputit ose gjendjet e checkbox) mund të mbetet në rreshtin e gabuar.
<!-- ❌ 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 është mënyra se si paraqiten listat dinamike.
:key nuk është opsional në praktikë: një key i qëndrueshëm dhe unik lejon që Vue të ketë një diff virtuale të DOM efikase dhe shmang gabimet e zhdukjes së gjendjes në rirradhëzim/filtruar.
Dija e përdorimit të një id të vërtetë (asnjëherë indeksin për listat dinamike) dhe ndarjen e v-for/v-if është thelbësore për listat e sakta dhe performante.