v-for

  • 预期Array | Object | number | string | Iterable (2.6 新增)

  • 用法

基于源数据多次渲染元素或模板块。此指令之值,必须使用特定语法 alias in expression ,为当前遍历的元素提供别名:

  1. <div v-for="item in items">
  2. {{ item.text }}
  3. </div>

另外也可以为数组索引指定别名 (或者用于对象的键):

  1. <div v-for="(item, index) in items"></div>
  2. <div v-for="(val, key) in object"></div>
  3. <div v-for="(val, name, index) in object"></div>

v-for 默认行为试着不改变整体,而是替换元素。迫使其重新排序的元素,你需要提供一个 key 的特殊属性:

  1. <div v-for="item in items" :key="item.id">
  2. {{ item.text }}
  3. </div>

从 2.6 起,v-for 也可以在实现了可迭代协议的值上使用,包括原生的 MapSet。不过应该注意的是 Vue 2.x 目前并不支持可响应的 MapSet 值,所以无法自动探测变更。

当和 v-if 一起使用时,v-for 的优先级比 v-if 更高。详见列表渲染教程

v-for 的详细用法可以通过以下链接查看教程详细说明。