副队长Vue3教程(8)--列表渲染 v-for

点此查看 所有教程、项目、源码导航

文章目录

    • [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 带来的好处

  1. 精准绑定节点,列表增删、排序时,不会出现顺序错乱、表单数据串位
  2. 提升diff对比效率,Vue可以快速定位节点,减少DOM操作
  3. 规避Vue默认就地复用策略带来的bug(比如输入框、复选框数据错乱)

❌ 不推荐、禁止的写法

  1. 不要用数组下标 index 当key
    当列表存在删除、插入、排序时,index会重新变化,diff识别错乱,容易出现数据异常
html 复制代码
<!-- 不推荐 -->
<li v-for="(item, index) in list" :key="index"></li>
  1. 不要用随机数、时间戳当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. 小结

  1. v-for 用于列表渲染,可以遍历数组、对象,支持拿到每一项和索引
  2. 必须绑定 :key,优先使用业务唯一id;禁止用index、随机数做key
  3. 不要在同一个元素上同时写 v-for 和 v-if,优先提前过滤数组
  4. key的本质:给虚拟DOM节点唯一标识,帮助diff算法精准复用DOM,避免数据错乱
相关推荐
feixing_fx4 小时前
JavaScript 是什么:从浏览器脚本到通用编程语言
开发语言·前端·javascript·前端框架·ecmascript
小y的笔记4 小时前
JavaScript URL 状态同步
前端·javascript
泯泷8 小时前
Vercel AI SDK 6 完整教程系列 - 第一部分:基础入门篇
前端·javascript
程序员大阳10 小时前
副队长Vue3教程(5)--事件绑定 v-on
前端·javascript·vue.js·vue3·事件绑定·v-on
泯泷10 小时前
Vercel AI SDK 6 完整教程系列 - 第二部分:结构化数据与工具调用
前端·javascript
云起SAAS12 小时前
手机靓号选号商城H5源码 完整前后台可直接运行
前端·javascript·后端
程序员大阳12 小时前
副队长Vue3教程(6)--script setup语法糖与ref基础响应式
vue.js·vue3·ref·script setup·基础响应式
code2cat12 小时前
JavaScript编程篇之异步请求:切换到待办,为什么又显示了全部任务
前端·javascript
1-1=013 小时前
Vue 条件渲染和列表渲染
前端·javascript·vue.js