点此查看 所有教程、项目、源码导航
文章目录
-
- [1. 本篇说明](#1. 本篇说明)
- [2. v-for 基础遍历数组](#2. v-for 基础遍历数组)
- [3. 遍历对象数组(最常用)](#3. 遍历对象数组(最常用))
- [4. v-for 遍历对象(了解)](#4. v-for 遍历对象(了解))
- [5. key 的作用(重点)](#5. key 的作用(重点))
-
- [key 带来的好处](#key 带来的好处)
- [❌ 不推荐、禁止的写法](#❌ 不推荐、禁止的写法)
- [6. v-for 和 v-if 一起使用的规范(高频坑)](#6. v-for 和 v-if 一起使用的规范(高频坑))
- [7. 综合小案例:添加删除列表项](#7. 综合小案例:添加删除列表项)
- [8. 小结](#8. 小结)
1. 本篇说明
前面我们学习了条件渲染 v-if、v-show,这一节学习列表渲染指令 v-for。
开发中经常需要渲染数组、对象列表,比如商品列表、用户表格、菜单,都靠 v-for 实现。
2. v-for 基础遍历数组
语法:v-for="item in 数组",item 代表数组里的每一项。
html
<template>
<div>
<ul>
<li v-for="item in list">
{{ item }}
</li>
</ul>
</div>
</template>
<script setup>
import { ref } from 'vue'
const list = ref(['苹果', '香蕉', '橙子'])
</script>
效果:

带索引写法:v-for="(item, index) in 数组",index 是当前项的下标,从0开始
html
<template>
<div>
<ul>
<li v-for="(item, index) in list">
下标:{{ index }},水果:{{ item }}
</li>
</ul>
</div>
</template>
<script setup>
import { ref } from 'vue'
const list = ref(['苹果', '香蕉', '橙子'])
</script>
效果:

3. 遍历对象数组(最常用)
真实项目大多是对象数组,取出对象里面的字段渲染
html
<template>
<div>
<ul>
<li v-for="user in userList">
{{ user.id }} - {{ user.name }}
</li>
</ul>
</div>
</template>
<script setup>
import { ref } from 'vue'
const userList = ref([
{ id: 1, name: '张三' },
{ id: 2, name: '李四' },
{ id: 3, name: '王五' }
])
</script>
效果:

4. v-for 遍历对象(了解)
也可以遍历普通对象,拿到属性值、属性名
语法:v-for="(value, key) in 对象"
html
<template>
<div>
<p v-for="(value, key) in info">
{{ key }}:{{ value }}
</p>
</div>
</template>
<script setup>
import { ref } from 'vue'
const info = ref({
name: '小明',
age: 18,
gender: '男'
})
</script>
效果:

5. key 的作用(重点)
Vue 底层有一套虚拟DOM diff算法,用来对比新旧列表,尽量复用DOM,减少重复创建销毁,提升性能。
key 是给每一项DOM的唯一标识,让diff算法可以精准找到对应的节点。
✅ 正确示例:使用业务唯一id作为key
html
<template>
<div>
<ul>
<li v-for="user in userList" :key="user.id">
{{ user.id }} - {{ user.name }}
</li>
</ul>
</div>
</template>
<script setup>
import { ref } from 'vue'
const userList = ref([
{ id: 1, name: '张三' },
{ id: 2, name: '李四' },
{ id: 3, name: '王五' }
])
</script>
key 带来的好处
- 精准绑定节点,列表增删、排序时,不会出现顺序错乱、表单数据串位
- 提升diff对比效率,Vue可以快速定位节点,减少DOM操作
- 规避Vue默认就地复用策略带来的bug(比如输入框、复选框数据错乱)
❌ 不推荐、禁止的写法
- 不要用数组下标
index当key
当列表存在删除、插入、排序时,index会重新变化,diff识别错乱,容易出现数据异常
html
<!-- 不推荐 -->
<li v-for="(item, index) in list" :key="index"></li>
- 不要用随机数、时间戳当key
每次渲染都会生成新值,DOM会全部重新销毁重建,失去复用的意义,性能变差
html
<!-- 不推荐 -->
<li v-for="item in list" :key="Math.random()"></li>
6. v-for 和 v-if 一起使用的规范(高频坑)
规范:不要在同一个标签上同时写 v-for 和 v-if
原因:v-for 优先级更高,会先循环全部列表,再做判断,性能浪费;而且语义不清晰。
✅ 推荐方案:先过滤数组,再循环
html
<template>
<div>
<ul>
<li v-for="user in filterUserList" :key="user.id">
{{ user.name }}
</li>
</ul>
</div>
</template>
<script setup>
import { ref, computed } from 'vue'
const userList = ref([
{ id: 1, name: '张三', isShow: true },
{ id: 2, name: '李四', isShow: false },
{ id: 3, name: '王五', isShow: true }
])
// 计算属性过滤
const filterUserList = computed(() => {
return userList.value.filter(item => item.isShow)
})
</script>
如果只是简单按需渲染整个列表,可以在外层包裹一层标签,v-if写在外层
html
<template>
<div>
<ul v-if="userList.length > 0">
<li v-for="user in userList" :key="user.id">
{{ user.name }}
</li>
</ul>
<p v-else>暂无数据</p>
</div>
</template>
7. 综合小案例:添加删除列表项
html
<template>
<div>
<button @click="addUser">新增用户</button>
<ul>
<li v-for="user in userList" :key="user.id">
{{ user.id }} - {{ user.name }}
<button @click="delUser(user.id)">删除</button>
</li>
</ul>
</div>
</template>
<script setup>
import { ref } from 'vue'
const userList = ref([
{ id: 1, name: '张三' },
{ id: 2, name: '李四' }
])
let nextId = 3
const addUser = () => {
userList.value.push({ id: nextId++, name: '新用户' })
}
const delUser = (id) => {
// filter 过滤,保留id和目标id不相等的数据,实现删除
userList.value = userList.value.filter(item => item.id !== id)
}
</script>
效果:

8. 小结
v-for用于列表渲染,可以遍历数组、对象,支持拿到每一项和索引- 必须绑定
:key,优先使用业务唯一id;禁止用index、随机数做key - 不要在同一个元素上同时写 v-for 和 v-if,优先提前过滤数组
- key的本质:给虚拟DOM节点唯一标识,帮助diff算法精准复用DOM,避免数据错乱