列表渲染
用 v-for 把一个数组对应为一组元素
我们用 v-for 指令根据一组数组的选项列表进行渲染。v-for 指令需要使用 item in items 形式的特殊语法, items 是源数据数组并且 item 是数组元素迭代的别名。
<ul id="example-1"> HTML <li v-for="item in items"> {{ item.message }} </li> </ul>
var example1 = new Vue({ JS el: '#example-1', data: { items: [ { message: 'Foo' }, { message: 'Bar' } ] } })
结果:
在 v-for 块中,我们拥有对父作用域属性的完全访问权限。v-for 还支持一个可选的第二个参数为当前项的索引。
<ul id="example-2"> HTML <li v-for="(item, index) in items"> {{ parentMessage }} - {{ index }} - {{ item.message }} </li> </ul>
var example2 = new Vue({ JS el: '#example-2', data: { parentMessage: 'Parent', items: [ { message: 'Foo' }, { message: 'Bar' } ] } })
结果:
也可以使用 of 替代 in 作为分隔符,因为它是最接近JavaScript迭代的的语法:
<div v-for="item of items"></div> HTML
一个对象的 v-for
也可以使用 v-for 通过一个对象的属性来迭代。
<ul id="v-for-object" class="demo"> HTML <li v-for="value in object"> {{ value }} </li> </ul>
new Vue({ JS el: '#v-for-object', data: { object: { firstName: 'John', lastName: 'Doe', age: 30 } } })
结果:
也可以提供第二个的参数为键名:
<ul id="v-for-object" class="demo"> HTML <div v-for="(value, key) in object"> {{ key }}: {{ value }} </div> 5 </ul>
new Vue({ JS el: '#v-for-object', data: { object: { firstName: 'John', lastName: 'Doe', age: 30 } } })
结果:
第三个参数为索引:
<ul id="v-for-object" class="demo"> HTML <div v-for="(value, key, index) in object"> {{ index }}. {{ key }}: {{ value }} </div> </ul>
new Vue({ JS el: '#v-for-object', data: { object: { firstName: 'John', lastName: 'Doe', age: 30 } } })
注意:在遍历对象时,是按 Object.keys() 的结果遍历,但是不能保证它的结果在不同的JavaScript引擎下是一致的。
key
当 Vue.js 用 v-for 正在更新已渲染过的元素列表时,它默认用“就地复用”策略。如果数据项的顺序被改变。Vue将不会移动dom元素来匹配数据项的顺序,而是简单复用此处的每个元素,并且确保它在特定索引下显示已被渲染过的每个元素。这个类似Vue 1.x的 track-by="$index" 。
这个默认的模式是高效的,但是只适用于不依赖子组件状态或临时dom状态(例如:表单输入值)的列表渲染输出。
为了给 Vue 一个提示,以便它能跟踪每个节点的身份,从而重用和重新排序现有元素,我们需要为每一项提供一个唯一的 key 属性。理想的 key 值是每项都有的且唯一的id。这个特殊的属性相当于 Vue 1.x 的 Track-by ,但它的工作方式类似于一个属性,所以你需要用 v-bind 来帮顶动态值(在这里使用简写):
<div v-for="item in items" :key="item.id"> HTML <!-- 内容 --> </div>
建议尽可能在使用 v-for 时提供 key , 除非遍历输出的dom内容非常简单,或者是刻意依赖默认行为以获取性能上的提升。
因为它是Vue识别节点的一个通用机制, key 并不与 v-for 特别关联 , key 还具有其他用途,我们将在后面的指南中看到其他用途。
数据更新检测
变异方法
Vue包含一组观察数组的变异方法,所以它们也将会触发视图更新。这些方法如下:
—— push()
—— pop()
—— shift()
—— unshift()
—— splice()
—— sort()
—— reverse()
替换数组
变异方法(mutation method),顾名思义,会改变被这些方法调用的原始数组。相比之下,也有非变异(non-mutating method)方法,例如:filter()、concat()、slice()。这些不会改变原始数组,但总是返回一个新数组。当使用非变异方法时,可以用新数组替换旧数组:
example1.items = example1.items.filter(function (item) { JS return item.message.match(/Foo/) })
注意事项
对象更改检测注意事项
还是由于JavaScript的限制,Vue不能检测对象属性的添加或删除:
var vm = new Vue({ JS data: { a: 1 } }) // `vm.a` 现在是响应式的 vm.b = 2 // `vm.b` 不是响应式的
对于已经创建的实例,Vue不能动态添加根级别的响应式属性。但是,可以使用Vue.set(Object , key , value) 方法向嵌套对象添加响应式属性。例如,对于:
var vm = new Vue({ JS data: { userProfile: { name: 'Anika' } } })
可以添加到一个新的 age 属性到嵌套的 userProfile 对象:
Vue.set(vm.userProfile, 'age', 27) JS
还可以使用 vm.$set 实例方法,它只是全局 Vue.set 的别名:
vm.$set(vm.userProfile, 'age', 27) JS
有时你可能为需要为已有对象赋予多个新属性,比如使用Object.assign() 或 _.extend() 。在这种情况下你应该用两个对象的属性创建一个新的对象。所以,如果你想添加新的响应式属性,不要像这样:
Object.assign(vm.userProfile, { JS age: 27, favoriteColor: 'Vue Green' })
你应该这样做:
Object.assign(vm.userProfile, { JS age: 27, favoriteColor: 'Vue Green' })
显示过滤/排序效果
有时,我们想要显示一个数组的过滤或排序副本,而不实际改变或重置原始数据。在这种情况下,可以创建返回过滤或排序数组的计算属性。
例如:
<li v-for="n in evenNumbers">{{ n }}</li> HTML
data: { JS 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> HTML
data: { JS numbers: [ 1, 2, 3, 4, 5 ] }, methods: { even: function (numbers) { return numbers.filter(function (number) { return number % 2 === 0 }) } }
一段取值范围的 v-for
v-for 也可以取整数。在这种情况下,它将重复多次模板。
<div> <span v-for="n in 10">{{ n }} </span> </div>
结果:
v-for on a <template>
类似于 v-if ,你也可以利用带有 v-for 的<template>渲染多个元素。比如:
<ul> HTML <template v-for="item in items"> <li>{{ item.msg }}</li> <li class="divider" role="presentation"></li> </template> </ul>
v-for with v-if
当它们处于同一节点, v-for 的优先级比 v-if 更高,这意味着 v-if 将分别重复运行于每个 v-for 循环中。当你想为仅有的一些项渲染节点时,这种优先级的机制会十分有用,如下:
<li v-for="todo in todos" v-if="!todo.isComplete"> HTML {{ todo }} </li>
上面的代码只传递了未完成的todos。
而如果你的目的是由条件地跳过循环的执行,那么可以将 v-if 置于外层元素(或<template>)上。如:
<ul v-if="todos.length"> HTML <li v-for="todo in todos"> {{ todo }} </li> </ul> <p v-else>No todos left!</p>