# 列表渲染
## [用`v-for`把一个数组对应为一组元素](https://cn.vuejs.org/v2/guide/list.html#%E7%94%A8-v-for-%E6%8A%8A%E4%B8%80%E4%B8%AA%E6%95%B0%E7%BB%84%E5%AF%B9%E5%BA%94%E4%B8%BA%E4%B8%80%E7%BB%84%E5%85%83%E7%B4%A0 "用 v-for 把一个数组对应为一组元素")
我们用`v-for`指令根据一组数组的选项列表进行渲染。`v-for`指令需要使用`item in items`形式的特殊语法，`items`是源数据数组并且`item`是数组元素迭代的别名。
~~~
<ul id="example-1">
<li v-for="item in items">
{{ item.message }}
</li>
</ul>
~~~
~~~
var example1 = new Vue({
el: '#example-1',
data: {
items: [
{ message: 'Foo' },
{ message: 'Bar' }
]
}
})
~~~
结果：
* Foo
* Bar
在`v-for`块中，我们拥有对父作用域属性的完全访问权限。`v-for`还支持一个可选的第二个参数为当前项的索引。
~~~
<ul id="example-2">
<li v-for="(item, index) in items">
{{ parentMessage }} - {{ index }} - {{ item.message }}
</li>
</ul>
~~~
~~~
var example2 = new Vue({
el: '#example-2',
data: {
parentMessage: 'Parent',
items: [
{ message: 'Foo' },
{ message: 'Bar' }
]
}
})
~~~
结果：
* Parent - 0 - Foo
* Parent - 1 - Bar
你也可以用`of`替代`in`作为分隔符，因为它是最接近 JavaScript 迭代器的语法：
~~~
<div v-for="item of items"></div>
~~~
## [一个对象的`v-for`](https://cn.vuejs.org/v2/guide/list.html#%E4%B8%80%E4%B8%AA%E5%AF%B9%E8%B1%A1%E7%9A%84-v-for "一个对象的 v-for")
你也可以用`v-for`通过一个对象的属性来迭代。
~~~
<ul id="v-for-object" class="demo">
<li v-for="value in object">
{{ value }}
</li>
</ul>
~~~
~~~
new Vue({
el: '#v-for-object',
data: {
object: {
title: 'How to do lists in Vue',
author: 'Jane Doe',
publishedAt: '2016-04-10'
}
}
})
~~~
结果：
* How to do lists in Vue
* Jane Doe
* 2016-04-10
你也可以提供第二个的参数为 property 名称 (也就是键名)：
~~~
<div v-for="(value, name) in object">
{{ name }}: {{ value }}
</div>
~~~
title: How to do lists in Vue
author: Jane Doe
publishedAt: 2016-04-10
第三个参数为索引：
~~~
<div v-for="(value, name, index) in object">
{{ index }}. {{ name }}: {{ value }}
</div>
~~~
0\. title: How to do lists in Vue
1\. author: Jane Doe
2\. publishedAt: 2016-04-10
在遍历对象时，是按`Object.keys()`的结果遍历，但是不能保证它的结果在不同的 JavaScript 引擎下是一致的。
## [维护状态](https://cn.vuejs.org/v2/guide/list.html#%E7%BB%B4%E6%8A%A4%E7%8A%B6%E6%80%81 "维护状态")
当 Vue.js 用`v-for`正在更新已渲染过的元素列表时，它默认用“就地复用”策略。如果数据项的顺序被改变，Vue 将不会移动 DOM 元素来匹配数据项的顺序， 而是简单复用此处每个元素，并且确保它在特定索引下显示已被渲染过的每个元素。这个类似 Vue 1.x 的`track-by="$index"`。
这个默认的模式是高效的，但是**只适用于不依赖子组件状态或临时 DOM 状态 (例如：表单输入值) 的列表渲染输出**。
为了给 Vue 一个提示，以便它能跟踪每个节点的身份，从而重用和重新排序现有元素，你需要为每项提供一个唯一`key`属性：
~~~
<div v-for="item in items" v-bind:key="item.id">
<!-- 内容 -->
</div>
~~~
建议尽可能在使用`v-for`时提供`key`attribute，除非遍历输出的 DOM 内容非常简单，或者是刻意依赖默认行为以获取性能上的提升。
因为它是 Vue 识别节点的一个通用机制，`key`并不与`v-for`特别关联，`key`还具有其他用途，我们将在后面的指南中看到其他用途。
不要使用对象或数组之类的非原始类型值作为`v-for`的`key`。用字符串或数类型的值取而代之。
更多`key`attribute 的细节用法请移步至[`key`的 API 文档](https://cn.vuejs.org/v2/api/#key)。
## [数组更新检测](https://cn.vuejs.org/v2/guide/list.html#%E6%95%B0%E7%BB%84%E6%9B%B4%E6%96%B0%E6%A3%80%E6%B5%8B "数组更新检测")
### [变异方法](https://cn.vuejs.org/v2/guide/list.html#%E5%8F%98%E5%BC%82%E6%96%B9%E6%B3%95 "变异方法")
Vue 包含一组观察数组的变异方法，所以它们也将会触发视图更新。这些方法如下：
* `push()`
* `pop()`
* `shift()`
* `unshift()`
* `splice()`
* `sort()`
* `reverse()`
你打开控制台，然后用前面例子的`items`数组调用变异方法：`example1.items.push({ message: 'Baz' })`。
### [替换数组](https://cn.vuejs.org/v2/guide/list.html#%E6%9B%BF%E6%8D%A2%E6%95%B0%E7%BB%84 "替换数组")
变异方法 (mutation method)，顾名思义，会改变被这些方法调用的原始数组。相比之下，也有非变异 (non-mutating method) 方法，例如：`filter()`,`concat()`和`slice()`。这些不会改变原始数组，但**总是返回一个新数组**。当使用非变异方法时，可以用新数组替换旧数组：
~~~
example1.items = example1.items.filter(function (item) {
return item.message.match(/Foo/)
})
~~~
你可能认为这将导致 Vue 丢弃现有 DOM 并重新渲染整个列表。幸运的是，事实并非如此。Vue 为了使得 DOM 元素得到最大范围的重用而实现了一些智能的、启发式的方法，所以用一个含有相同元素的数组去替换原来的数组是非常高效的操作。
### [注意事项](https://cn.vuejs.org/v2/guide/list.html#%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9 "注意事项")
由于 JavaScript 的限制，Vue 不能检测以下变动的数组：
1. 当你利用索引直接设置一个项时，例如：`vm.items[indexOfItem] = newValue`
2. 当你修改数组的长度时，例如：`vm.items.length = newLength`
举个例子：
~~~
var vm = new Vue({
data: {
items: ['a', 'b', 'c']
}
})
vm.items[1] = 'x' // 不是响应性的
vm.items.length = 2 // 不是响应性的
~~~
为了解决第一类问题，以下两种方式都可以实现和`vm.items[indexOfItem] = newValue`相同的效果，同时也将触发状态更新：
~~~
// Vue.set
Vue.set(vm.items, indexOfItem, newValue)
~~~
~~~
// Array.prototype.splice
vm.items.splice(indexOfItem, 1, newValue)
~~~
你也可以使用[`vm.$set`](https://cn.vuejs.org/v2/api/#vm-set)实例方法，该方法是全局方法`Vue.set`的一个别名：
~~~
vm.$set(vm.items, indexOfItem, newValue)
~~~
为了解决第二类问题，你可以使用`splice`：
~~~
vm.items.splice(newLength)
~~~
## [对象更改检测注意事项](https://cn.vuejs.org/v2/guide/list.html#%E5%AF%B9%E8%B1%A1%E6%9B%B4%E6%94%B9%E6%A3%80%E6%B5%8B%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9 "对象更改检测注意事项")
还是由于 JavaScript 的限制，**Vue 不能检测对象属性的添加或删除**：
~~~
var vm = new Vue({
data: {
a: 1
}
})
// `vm.a` 现在是响应式的
vm.b = 2
// `vm.b` 不是响应式的
~~~
对于已经创建的实例，Vue 不能动态添加根级别的响应式属性。但是，可以使用`Vue.set(object, propertyName, value)`方法向嵌套对象添加响应式属性。例如，对于：
~~~
var vm = new Vue({
data: {
userProfile: {
name: 'Anika'
}
}
})
~~~
你可以添加一个新的`age`属性到嵌套的`userProfile`对象：
~~~
Vue.set(vm.userProfile, 'age', 27)
~~~
你还可以使用`vm.$set`实例方法，它只是全局`Vue.set`的别名：
~~~
vm.$set(vm.userProfile, 'age', 27)
~~~
有时你可能需要为已有对象赋予多个新属性，比如使用`Object.assign()`或`_.extend()`。在这种情况下，你应该用两个对象的属性创建一个新的对象。所以，如果你想添加新的响应式属性，不要像这样：
~~~
Object.assign(vm.userProfile, {
age: 27,
favoriteColor: 'Vue Green'
})
~~~
你应该这样做：
~~~
vm.userProfile = Object.assign({}, vm.userProfile, {
age: 27,
favoriteColor: 'Vue Green'
})
~~~
## [显示过滤/排序结果](https://cn.vuejs.org/v2/guide/list.html#%E6%98%BE%E7%A4%BA%E8%BF%87%E6%BB%A4-%E6%8E%92%E5%BA%8F%E7%BB%93%E6%9E%9C "显示过滤/排序结果")
有时，我们想要显示一个数组的过滤或排序副本，而不实际改变或重置原始数据。在这种情况下，可以创建返回过滤或排序数组的计算属性。
例如：
~~~
<li v-for="n in evenNumbers">{{ n }}</li>
~~~
~~~
data: {
numbers: [ 1, 2, 3, 4, 5 ]
},
computed: {
evenNumbers: function () {
return this.numbers.filter(function (number) {
return number % 2 === 0
})
}
}
~~~
在计算属性不适用的情况下 (例如，在嵌套`v-for`循环中) 你可以使用一个 method 方法：
~~~
<li v-for="n in even(numbers)">{{ n }}</li>
~~~
~~~
data: {
numbers: [ 1, 2, 3, 4, 5 ]
},
methods: {
even: function (numbers) {
return numbers.filter(function (number) {
return number % 2 === 0
})
}
}
~~~
## [一段取值范围的`v-for`](https://cn.vuejs.org/v2/guide/list.html#%E4%B8%80%E6%AE%B5%E5%8F%96%E5%80%BC%E8%8C%83%E5%9B%B4%E7%9A%84-v-for "一段取值范围的 v-for")
`v-for`也可以取整数。在这种情况下，它将重复多次模板。
~~~
<div>
<span v-for="n in 10">{{ n }} </span>
</div>
~~~
结果：
12345678910
## [`v-for`on a`<template>`](https://cn.vuejs.org/v2/guide/list.html#v-for-on-a-lt-template-gt "v-for on a ")
类似于`v-if`，你也可以利用带有`v-for`的`<template>`渲染多个元素。比如：
~~~
<ul>
<template v-for="item in items">
<li>{{ item.msg }}</li>
<li class="divider" role="presentation"></li>
</template>
</ul>
~~~
## [`v-for`with`v-if`](https://cn.vuejs.org/v2/guide/list.html#v-for-with-v-if "v-for with v-if")
注意我们**不**推荐同时使用`v-if`和`v-for`。更多细节可查阅[风格指南](https://cn.vuejs.org/v2/style-guide/#%E9%81%BF%E5%85%8D-v-if-%E5%92%8C-v-for-%E7%94%A8%E5%9C%A8%E4%B8%80%E8%B5%B7-%E5%BF%85%E8%A6%81)。
当它们处于同一节点，`v-for`的优先级比`v-if`更高，这意味着`v-if`将分别重复运行于每个`v-for`循环中。当你想为仅有的*一些*项渲染节点时，这种优先级的机制会十分有用，如下：
~~~
<li v-for="todo in todos" v-if="!todo.isComplete">
{{ todo }}
</li>
~~~
上面的代码只传递了未完成的 todos。
而如果你的目的是有条件地跳过循环的执行，那么可以将`v-if`置于外层元素 (或[`<template>`](https://cn.vuejs.org/v2/guide/conditional.html#%E5%9C%A8-lt-template-gt-%E4%B8%AD%E9%85%8D%E5%90%88-v-if-%E6%9D%A1%E4%BB%B6%E6%B8%B2%E6%9F%93%E4%B8%80%E6%95%B4%E7%BB%84))上。如：
~~~
<ul v-if="todos.length">
<li v-for="todo in todos">
{{ todo }}
</li>
</ul>
<p v-else>No todos left!</p>
~~~
## [一个组件的`v-for`](https://cn.vuejs.org/v2/guide/list.html#%E4%B8%80%E4%B8%AA%E7%BB%84%E4%BB%B6%E7%9A%84-v-for "一个组件的 v-for")
> 了解组件相关知识，查看[组件](https://cn.vuejs.org/v2/guide/components.html)。完全可以先跳过它，以后再回来查看。
在自定义组件里，你可以像任何普通元素一样用`v-for`。
~~~
<my-component v-for="item in items" :key="item.id"></my-component>
~~~
> 2.2.0+ 的版本里，当在组件中使用`v-for`时，`key`现在是必须的。
然而，任何数据都不会被自动传递到组件里，因为组件有自己独立的作用域。为了把迭代数据传递到组件里，我们要用`props`：
~~~
<my-component
v-for="(item, index) in items"
v-bind:item="item"
v-bind:index="index"
v-bind:key="item.id"
></my-component>
~~~
不自动将`item`注入到组件里的原因是，这会使得组件与`v-for`的运作紧密耦合。明确组件数据的来源能够使组件在其他场合重复使用。
下面是一个简单的 todo list 的完整例子：
~~~
<div id="todo-list-example">
<form v-on:submit.prevent="addNewTodo">
<label for="new-todo">Add a todo</label>
<input
v-model="newTodoText"
id="new-todo"
placeholder="E.g. Feed the cat"
>
<button>Add</button>
</form>
<ul>
<li
is="todo-item"
v-for="(todo, index) in todos"
v-bind:key="todo.id"
v-bind:title="todo.title"
v-on:remove="todos.splice(index, 1)"
></li>
</ul>
</div>
~~~
注意这里的`is="todo-item"`属性。这种做法在使用 DOM 模板时是十分必要的，因为在`<ul>`元素内只有`<li>`元素会被看作有效内容。这样做实现的效果与`<todo-item>`相同，但是可以避开一些潜在的浏览器解析错误。查看[DOM 模板解析说明](https://cn.vuejs.org/v2/guide/components.html#%E8%A7%A3%E6%9E%90-DOM-%E6%A8%A1%E6%9D%BF%E6%97%B6%E7%9A%84%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9)来了解更多信息。
~~~
Vue.component('todo-item', {
template: '\
<li>\
{{ title }}\
<button v-on:click="$emit(\'remove\')">Remove</button>\
</li>\
',
props: ['title']
})
new Vue({
el: '#todo-list-example',
data: {
newTodoText: '',
todos: [
{
id: 1,
title: 'Do the dishes',
},
{
id: 2,
title: 'Take out the trash',
},
{
id: 3,
title: 'Mow the lawn'
}
],
nextTodoId: 4
},
methods: {
addNewTodo: function () {
this.todos.push({
id: this.nextTodoId++,
title: this.newTodoText
})
this.newTodoText = ''
}
}
})
~~~
Add a todoAdd
* Do the dishesRemove
* Take out the trashRemove
* Mow the lawnRemove
- 内容介绍
- EcmaScript基础
- 快速入门
- 常量与变量
- 字符串
- 函数的基本概念
- 条件判断
- 数组
- 循环
- while循环
- for循环
- 函数基础
- 对象
- 对象的方法
- 函数
- 变量作用域
- 箭头函数
- 闭包
- 高阶函数
- map/reduce
- filter
- sort
- Promise
- 基本对象
- Arguments 对象
- 剩余参数
- Map和Set
- Json基础
- RegExp
- Date
- async
- callback
- promise基础
- promise-api
- promise链
- async-await
- 项目实践
- 标签系统
- 远程API请求
- 面向对象编程
- 创建对象
- 原型继承
- 项目实践
- Classes
- 构造函数
- extends
- static
- 项目实践
- 模块
- import
- export
- 项目实践
- 第三方扩展库
- immutable
- Vue快速入门
- 理解MVVM
- Vue中的MVVM模型
- Webpack+Vue快速入门
- 模板语法
- 计算属性和侦听器
- Class 与 Style 绑定
- 条件渲染
- 列表渲染
- 事件处理
- 表单输入绑定
- 组件基础
- 组件注册
- Prop
- 自定义事件
- 插槽
- 混入
- 过滤器
- 项目实践
- 标签编辑
- 移动客户端开发
- uni-app基础
- 快速入门程序
- 单页程序
- 底部Tab导航
- Vue语法基础
- 模版语法
- 计算属性与侦听器
- Class与Style绑定
- 样式与布局
- Box模型
- Flex布局
- 内置指令
- 基本指令
- v-model与表单
- 条件渲染指令
- 列表渲染指令v-for
- 事件与自定义属性
- 生命周期
- 项目实践
- 学生实验
- 贝店商品列表
- 加载更多数据
- 详情页面
- 自定义组件
- 内置组件
- 表单组件
- 技术专题
- 状态管理vuex
- Flyio
- Mockjs
- SCSS
- 条件编译
- 常用功能实现
- 上拉加载更多数据
- 数据加载综合案例
- Teaset UI组件库
- Teaset设计
- Teaset使用基础
- ts-tag
- ts-badge
- ts-button
- ta-banner
- ts-list
- ts-icon
- ts-load-more
- ts-segmented-control
- 代码模版
- 项目实践
- 标签组件
- 失物招领客户端原型
- 发布页面
- 检索页面
- 详情页面
- 服务端开发技术
- 服务端开发环境配置
- Koajs快速入门
- 快速入门
- 常用Koa中间件介绍
- 文件上传
- RestfulApi
- 一个复杂的RESTful例子
- 使用Mockjs生成模拟数据
- Thinkjs快速入门
- MVC模式
- Thinkjs介绍
- 快速入门
- RESTful服务
- RBAC案例
- 关联模型
- 应用开发框架
- 服务端开发
- PC端管理界面开发
- 移动端开发
- 项目实践
- 失物招领项目
- 移动客户端UI设计
- 服务端设计
- 数据库设计
- Event（事件）
- 客户端设计
- 事件列表页面
- 发布页面
- 事件详情页面
- API设计
- image
- event
- 微信公众号开发
- ui设计规范