v-for esegue il rendering di un elenco di elementi iterando su un array (o oggetto/intervallo). Dovresti sempre associarlo a una :key univoca in modo che Vue possa tracciare gli elementi in modo efficiente.
<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 utilizza key per identificare quali elementi sono cambiati, aggiunti o rimossi, in modo che possa riutilizzare e riordinare i nodi DOM esistenti invece di ricostruirli. Senza una key stabile, Vue ricorre a una strategia "in-place patch" che può causare bug:
<!-- ❌ 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>
Usare l'indice dell'array come key è un errore comune — quando gli elementi vengono riordinati, inseriti o eliminati, lo stato del componente/DOM (come i valori di input o gli stati delle caselle di controllo) può rimanere allegato alla riga sbagliata.
<!-- ❌ 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 è il modo in cui renderizzi elenchi dinamici.
La :key non è opzionale nella pratica: una key univoca e stabile consente al virtual DOM di Vue di eseguire il diff in modo efficiente ed evita bug sottili di mancata corrispondenza dello stato al riordinamento/filtraggio.
Sapere come usare un ID reale (mai l'indice per elenchi dinamici) e mantenere v-for/v-if separati è essenziale per elenchi corretti e performanti.