v-for เรนเดอร์รายการขององค์ประกอบโดยการวนซ้ำผ่านอาร์เรย์ (หรือวัตถุ/ช่วง) คุณควรจับคู่กับ :key ที่ไม่ซ้ำกันเสมอเพื่อให้ Vue สามารถติดตามรายการได้อย่างมีประสิทธิภาพ
<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 เพื่อระบุว่ารายการใดเปลี่ยนแปลง เพิ่มเติม หรือลบออก เพื่อให้สามารถ นำโหนด DOM ที่มีอยู่กลับมาใช้ใหม่และจัดลำดับใหม่ แทนที่จะสร้างใหม่ หากไม่มีคีย์ที่เสถียร Vue จะกลับไปใช้กลยุทธ์ "in-place patch" ซึ่งอาจทำให้เกิดข้อผิดพลาด:
<!-- ❌ 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>
การใช้ดัชนีอาร์เรย์เป็นคีย์เป็นข้อผิดพลาดทั่วไป — เมื่อรายการถูกจัดลำดับใหม่ แทรก หรือลบ สถานะส่วนประกอบ/DOM (เช่น ค่าอินพุตหรือสถานะช่องทำเครื่องหมาย) อาจติดอยู่ในแถวที่ผิด
<!-- ❌ 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 คือวิธีการเรนเดอร์รายการแบบไดนามิก
:key ไม่ใช่ตัวเลือกในทางปฏิบัติ: คีย์ที่เสถียรและไม่ซ้ำกันช่วยให้ Vue diff เสมือน DOM ทำงานได้อย่างมีประสิทธิภาพและหลีกเลี่ยงข้อบกพร่องจากการไม่ตรงกันของสถานะอย่างละเอียดในการจัดลำดับใหม่/กรอง
การรู้ว่าต้องใช้ ID จริง (ไม่ใช่ดัชนีสำหรับรายการแบบไดนามิก) และการแยก v-for/v-if ถือเป็นสิ่งจำเป็นสำหรับรายการที่ถูกต้องและมีประสิทธิภาพสูง