用 v-for 把一個(gè)數(shù)組對(duì)應(yīng)為一組元素

我們用 v-for 指令根據(jù)一組數(shù)組的選項(xiàng)列表進(jìn)行渲染艇纺。v-for 指令需要使用 item in items 形式的特殊語(yǔ)法硅确，items 是源數(shù)據(jù)數(shù)組并且 item 是數(shù)組元素迭代的別名。

                                                                                         HTML
<ul id="example-1">
  <li v-for="item in items">
    {{ item.message }}
  </li>
</ul>

                                                                                         JS
var example1 = new Vue({
  el: '#example-1',
  data: {
    items: [
      { message: 'Foo' },
      { message: 'Bar' }
    ]
  }
})

在 v-for 塊中工秩，我們擁有對(duì)父作用域?qū)傩缘耐耆L問(wèn)權(quán)限涵妥。v-for 還支持一個(gè)可選的第二個(gè)參數(shù)為當(dāng)前項(xiàng)的索引。

                                                                                        HTML
<ul id="example-2">
 <li v-for="(item, index) in items">
   {{ parentMessage }} - {{ index }} - {{ item.message }}
 </li>
</ul>

                                                                                         JS
var example2 = new Vue({
  el: '#example-2',
  data: {
    parentMessage: 'Parent',
    items: [
      { message: 'Foo' },
      { message: 'Bar' }
    ]
  }
})

你也可以用 of 替代 in 作為分隔符乖寒，因?yàn)樗亲罱咏?JavaScript 迭代器的語(yǔ)法：

                                                                                        HTML
<div v-for="item of items"></div>

一個(gè)對(duì)象的v-for

你也可以用 v-for 通過(guò)一個(gè)對(duì)象的屬性來(lái)迭代猴蹂。

                                                                                        HTML
<ul id="v-for-object" class="demo">
  <li v-for="value in object">
    {{ value }}
  </li>
</ul>

                                                                                        JS
new Vue({
  el: '#v-for-object',
  data: {
    object: {
      firstName: 'John',
      lastName: 'Doe',
      age: 30
    }
  }
})

你也可以提供第二個(gè)的參數(shù)為鍵名：

                                                                                        HTML
<div v-for="(value, key) in object">
  {{ key }}: {{ value }}
</div>

第三個(gè)參數(shù)為索引：

                                                                                        HTML
<div v-for="(value, key, index) in object">
  {{ index }}. {{ key }}: {{ value }}
</div>

注意: 在遍歷對(duì)象時(shí)，是按 Object.keys() 的結(jié)果遍歷楣嘁，但是不能保證它的結(jié)果在不同的 JavaScript 引擎下是一致的晕讲。

key

當(dāng) Vue.js 用 v-for 正在更新已渲染過(guò)的元素列表時(shí)，它默認(rèn)用“就地復(fù)用”策略马澈。如果數(shù)據(jù)項(xiàng)的順序被改變瓢省，Vue 將不會(huì)移動(dòng) DOM 元素來(lái)匹配數(shù)據(jù)項(xiàng)的順序， 而是簡(jiǎn)單復(fù)用此處每個(gè)元素痊班，并且確保它在特定索引下顯示已被渲染過(guò)的每個(gè)元素勤婚。

這個(gè)默認(rèn)的模式是高效的，但是只適用于不依賴子組件狀態(tài)或臨時(shí) DOM 狀態(tài) (例如：表單輸入值) 的列表渲染輸出涤伐。

為了給 Vue 一個(gè)提示馒胆，以便它能跟蹤每個(gè)節(jié)點(diǎn)的身份缨称，從而重用和重新排序現(xiàn)有元素，你需要為每項(xiàng)提供一個(gè)唯一 key 屬性祝迂。理想的 key 值是每項(xiàng)都有的唯一 id睦尽。這個(gè)特殊的屬性相當(dāng)于 Vue 1.x 的 track-by ，但它的工作方式類似于一個(gè)屬性型雳，所以你需要用 v-bind 來(lái)綁定動(dòng)態(tài)值 (在這里使用簡(jiǎn)寫(xiě))：

                                                                                        HTML
<div v-for="item in items" :key="item.id">
  <!-- 內(nèi)容 -->
</div>

建議盡可能在使用 v-for 時(shí)提供 key当凡，除非遍歷輸出的 DOM 內(nèi)容非常簡(jiǎn)單，或者是刻意依賴默認(rèn)行為以獲取性能上的提升纠俭。

因?yàn)樗?Vue 識(shí)別節(jié)點(diǎn)的一個(gè)通用機(jī)制沿量，key 并不與 v-for 特別關(guān)聯(lián)，key 還具有其他用途冤荆，我們將在后面的指南中看到其他用途朴则。

數(shù)據(jù)更新檢測(cè)

變異方法

Vue 包含一組觀察數(shù)組的變異方法，所以它們也將會(huì)觸發(fā)視圖更新钓简。這些方法如下：

• push()
• pop()
• shift()
• unshift()
• splice()
• sort()
• reverse()
  你打開(kāi)控制臺(tái)乌妒，然后用前面例子的 items 數(shù)組調(diào)用變異方法：
  example1.items.push({ message: 'Baz' }) 。

替換數(shù)組

變異方法 (mutation method)外邓，顧名思義撤蚊，會(huì)改變被這些方法調(diào)用的原始數(shù)組。相比之下坐榆，也有非變異 (non-mutating method) 方法，例如：filter(), concat() 和 slice() 冗茸。這些不會(huì)改變?cè)紨?shù)組席镀，但總是返回一個(gè)新數(shù)組。當(dāng)使用非變異方法時(shí)夏漱，可以用新數(shù)組替換舊數(shù)組：

                                                                                        JS
example1.items = example1.items.filter(function (item) {
  return item.message.match(/Foo/)
})

你可能認(rèn)為這將導(dǎo)致 Vue 丟棄現(xiàn)有 DOM 并重新渲染整個(gè)列表豪诲。幸運(yùn)的是，事實(shí)并非如此挂绰。Vue 為了使得 DOM 元素得到最大范圍的重用而實(shí)現(xiàn)了一些智能的屎篱、啟發(fā)式的方法，所以用一個(gè)含有相同元素的數(shù)組去替換原來(lái)的數(shù)組是非常高效的操作葵蒂。

注意事項(xiàng)

由于 JavaScript 的限制交播，Vue 不能檢測(cè)以下變動(dòng)的數(shù)組：
1.當(dāng)你利用索引直接設(shè)置一個(gè)項(xiàng)時(shí)，例如：vm.items[indexOfItem] = newValue
2.當(dāng)你修改數(shù)組的長(zhǎng)度時(shí)践付，例如：vm.items.length = newLength

舉個(gè)例子：

                                                                                        JS
var vm = new Vue({
  data: {
    items: ['a', 'b', 'c']
  }
})
vm.items[1] = 'x' // 不是響應(yīng)性的
vm.items.length = 2 // 不是響應(yīng)性的

為了解決第一類問(wèn)題秦士，以下兩種方式都可以實(shí)現(xiàn)和 vm.items[indexOfItem] = newValue 相同的效果，同時(shí)也將觸發(fā)狀態(tài)更新：

                                                                                        JS
// Vue.set
Vue.set(vm.items, indexOfItem, newValue)

                                                                                        JS
// Array.prototype.splice
vm.items.splice(indexOfItem, 1, newValue)

你也可以使用 vm.$set 實(shí)例方法永高，該方法是全局方法 Vue.set 的一個(gè)別名：

                                                                                        JS
vm.$set(vm.items, indexOfItem, newValue)

為了解決第二類問(wèn)題隧土，你可以使用 splice：

                                                                                        JS
vm.items.splice(newLength)

對(duì)象更改檢測(cè)注意事項(xiàng)

還是由于 JavaScript 的限制提针，Vue 不能檢測(cè)對(duì)象屬性的添加或刪除：

                                                                                        JS
var vm = new Vue({
  data: {
    a: 1
  }
})
// `vm.a` 現(xiàn)在是響應(yīng)式的

vm.b = 2
// `vm.b` 不是響應(yīng)式的

對(duì)于已經(jīng)創(chuàng)建的實(shí)例，Vue 不能動(dòng)態(tài)添加根級(jí)別的響應(yīng)式屬性曹傀。但是辐脖，可以使用 Vue.set(object, key, value) 方法向嵌套對(duì)象添加響應(yīng)式屬性。例如皆愉，對(duì)于：

                                                                                       JS
var vm = new Vue({
 data: {
   userProfile: {
     name: 'Anika'
   }
 }
})

你可以添加一個(gè)新的 age 屬性到嵌套的 userProfile 對(duì)象：

                                                                                        JS
Vue.set(vm.userProfile, 'age', 27)

你還可以使用 vm.$set 實(shí)例方法嗜价，它只是全局 Vue.set 的別名：

                                                                                        JS
vm.$set(vm.userProfile, 'age', 27)

有時(shí)你可能需要為已有對(duì)象賦予多個(gè)新屬性，比如使用 Object.assign() 或 _.extend()亥啦。在這種情況下炭剪，你應(yīng)該用兩個(gè)對(duì)象的屬性創(chuàng)建一個(gè)新的對(duì)象。所以翔脱，如果你想添加新的響應(yīng)式屬性奴拦，不要像這樣：

                                                                                        JS
Object.assign(vm.userProfile, {
  age: 27,
  favoriteColor: 'Vue Green'
})

你應(yīng)該這樣做：

                                                                                        JS
vm.userProfile = Object.assign({}, vm.userProfile, {
  age: 27,
  favoriteColor: 'Vue Green'
})

顯示過(guò)濾/排序結(jié)果

有時(shí)，我們想要顯示一個(gè)數(shù)組的過(guò)濾或排序副本届吁，而不實(shí)際改變或重置原始數(shù)據(jù)错妖。在這種情況下，可以創(chuàng)建返回過(guò)濾或排序數(shù)組的計(jì)算屬性疚沐。

例如：

                                                                                        HTML
<li v-for="n in evenNumbers">{{ n }}</li>

                                                                                        JS
data: {
  numbers: [ 1, 2, 3, 4, 5 ]
},
computed: {
  evenNumbers: function () {
    return this.numbers.filter(function (number) {
      return number % 2 === 0
    })
  }
}

在計(jì)算屬性不適用的情況下 (例如暂氯，在嵌套 v-for 循環(huán)中) 你可以使用一個(gè) method 方法：

                                                                                        HTML
<li v-for="n in even(numbers)">{{ n }}</li>

                                                                                        JS
data: {
  numbers: [ 1, 2, 3, 4, 5 ]
},
methods: {
  even: function (numbers) {
    return numbers.filter(function (number) {
      return number % 2 === 0
    })
  }
}

一段取值范圍的 v-for

v-for 也可以取整數(shù)。在這種情況下亮蛔，它將重復(fù)多次模板痴施。

                                                                                        HTML
<div>
  <span v-for="n in 10">{{ n }} </span>
</div>

v-for on a <template>

類似于 v-if，你也可以利用帶有 v-for 的 <template> 渲染多個(gè)元素究流。比如：

                                                                                        HTML
<ul>
  <template v-for="item in items">
    <li>{{ item.msg }}</li>
    <li class="divider" role="presentation"></li>
  </template>
</ul>

v-for with v-if

當(dāng)它們處于同一節(jié)點(diǎn)辣吃，v-for 的優(yōu)先級(jí)比 v-if 更高，這意味著 v-if 將分別重復(fù)運(yùn)行于每個(gè) v-for 循環(huán)中芬探。當(dāng)你想為僅有的一些項(xiàng)渲染節(jié)點(diǎn)時(shí)神得，這種優(yōu)先級(jí)的機(jī)制會(huì)十分有用，如下：

                                                                                        HTML
<li v-for="todo in todos" v-if="!todo.isComplete">
  {{ todo }}
</li>

上面的代碼只傳遞了未完成的 todos偷仿。

而如果你的目的是有條件地跳過(guò)循環(huán)的執(zhí)行哩簿，那么可以將 v-if 置于外層元素 (或 <template>)上。如：

                                                                                        HTML
<ul v-if="todos.length">
  <li v-for="todo in todos">
    {{ todo }}
  </li>
</ul>
<p v-else>No todos left!</p>

一個(gè)組件的 v-for

在自定義組件里酝静，你可以像任何普通元素一樣用 v-for 节榜。

                                                                                        HTML
<my-component v-for="item in items" :key="item.id"></my-component>

2.2.0+ 的版本里，當(dāng)在組件中使用 v-for 時(shí)别智，key 現(xiàn)在是必須的全跨。

然而，任何數(shù)據(jù)都不會(huì)被自動(dòng)傳遞到組件里亿遂，因?yàn)榻M件有自己獨(dú)立的作用域浓若。為了把迭代數(shù)據(jù)傳遞到組件里渺杉，我們要用 props ：

                                                                                        HTML
<my-component
  v-for="(item, index) in items"
  v-bind:item="item"
  v-bind:index="index"
  v-bind:key="item.id"
></my-component>

不自動(dòng)將 item 注入到組件里的原因是，這會(huì)使得組件與 v-for 的運(yùn)作緊密耦合挪钓。明確組件數(shù)據(jù)的來(lái)源能夠使組件在其他場(chǎng)合重復(fù)使用是越。

下面是一個(gè)簡(jiǎn)單的 todo list 的完整例子：

                                                                                        HTML
<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 模板時(shí)是十分必要的碌上，因?yàn)樵?<ul> 元素內(nèi)只有 <li> 元素會(huì)被看作有效內(nèi)容倚评。這樣做實(shí)現(xiàn)的效果與 <todo-item> 相同，但是可以避開(kāi)一些潛在的瀏覽器解析錯(cuò)誤馏予。

                                                                                        JS
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 = ''
    }
  }
})