詳解Vue渲染列表指令：v-for

在

之前的文章中，我們學習了在Vue中如何透過v-if和v-show根據條件渲染所需的DOM元素或模板。在實際的專案中，我們很多時候會碰到將JSON資料中的陣列或物件渲染出清單之類的元素。在Vue中，提供了一個v-for的指令，可以渲染清單。 （學習影片分享：vue影片教學）

v-for 的作用

---

##v-for

可以基於來源資料多次渲染元素或範本區塊。這個指令必須用特定的語法

alias in expression，為目前遍歷的元素提供別名：

<div v-for="alias in expression"> {{ alias }}</div>

一般都是給陣列或物件指定別名，除此之外還可以為索引值指定別名，對於物件也可以給value

指定別名，常見的幾個情形如下：

<div v-for="item in items">{{ item }}</div>
<div v-for="(item, index) in items">{{ item }} {{ index }}</div>
<div v-for="val in object"></div>
<div v-for="(val, key) in object"></div>
<div v-for="(val, key, index) in object"></div>

其中我們也可以把in

#換成

of作為分隔符，因為它是最接近JavaScript迭代器的語法。

v-for

---

的預設行為試著不要改變整體，而是取代元素。迫使其重新排序的元素，你需要提供一個

key的特殊屬性：

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

接下來，我們看看v-for的一些使用場景。 一個陣列的 v-for

#使用v-for指令把陣列的選項清單進行渲染。 v-for指令需要使用

item in items

形式的特殊語法，items

是來源資料數組，

item是數組元素迭代的別名。來看一個簡單的範例：

<!-- Template -->
<ul>
    <li v-for="item in items">{{ item }}</li>
</ul>

// JavaScript
var app = new Vue({
    el: &#39;#app&#39;,
    data: {
        items: [1, 34, 89, 92, 45, 76, 33]
    }
})

這個時候，陣列items的每個item渲染到對應的li

中，在瀏覽器看到的效果如下：

上面的範例是透過

v-for把陣列items

的每個項目迭代出來放到

li中，除此之外，還可以把陣列的每個index也遍歷出來。在上面的程式碼的基礎上，咱們修改一下模板：

<ul>
    <li v-for="(item, index) in items">index-{{ index }}: {{ item }}</li>
</ul>

這個時候數組的索引號也遍歷出來了：

從上面的示列看出來了，你需要哪個元素（HTML的標籤）循環，那麼

v-for就寫在那個元素上。 上面我們已經可以正常的使用v-for

將定義的陣列每一項輸出來。為了加深學習，咱們在上面的範例基礎上增加一項需求，就是將輸出的陣列進行排序。這時候，咱們需要使用到Vue中的

computed

屬性。

在Vue中，我們無法污染來源數據，如果我們直接對來源資料items透過sort()方法進行排序，將會報錯的：

var app = new Vue({
    el: '#app',
    computed: {
        items: function() {
            return this.items.sort()
        }
    },
    data: {
        items: [1, 34, 89, 92, 45, 76, 33]
    }
})

為了不會污染Vue中的來源數據，需要在

computed裡重新宣告一個對象，例如宣告一個sortItems

對象：

var app = new Vue({
    el: '#app',
    computed: {
        sortItems: function() {
            return this.items.sort()
        }
    },
    data: {
        items: [1, 34, 89, 92, 45, 76, 3, 12]
    }
})

這個時候，我們的模板也需要做對應的修改：

<ul>
    <li v-for="item in sortItems">{{ item }}</li>
</ul>

如果不出意外的話，你看到的效果將是這樣的：

雖然有變化了，但不是我們想要的排序結果。雖然結果不是我們想要的，但這並不是Vue本身的問題，在JavaScript中也是這樣。如果我們想要真正的實作一個排序效果，那麼需要加入一個JavaScript的陣列的排序函數的功能：

function sortNumber(a, b) {
    return a - b
}

把

computed

裡的程式碼也做一個對應的修改：

computed: {
    sortItems: function() {
        return this.items.sort(sortNumber)
    }
}

這相輸出的效果才真正的是一個正確的排序效果：################上面的例子，我們看到的是一個簡單的純數字之類的數組，其數組中的每個項目也可以是對象，例如：###

data: {
    objItems: [
        {
            firstName: 'Jack',
            lastName: 'Li',
            age: 34
        },
        {
            firstName: 'Airen',
            lastName: 'Liao',
            age: 18
        }
    ]
}

###我們把模板換成：###

 <li v-for="objItem in objItems">{{ objItem.firstName }} {{objItem.lastName}} is {{ objItem.age}} years old!</li>

###這個時候看到的效果如下：# ##############

在JavaScript中，我们有很多数组的方法，可以对数组进行操作，这些方法可以修改一个数组。其实，在Vue中同样包含一组观察数组变异方法，这些方法将会触发元素的重新更新（视图更新），这些方法也是JavaScript中数组中常看到的方法：push()、pop()、shift()、unshift()、splice()、sort()、reverse()。我们可以在控制台中简单的看一下前面的示例中items数组调用变异方法的效果：

Vue不但提供了数组变异的方法，还提供了替换数组的方法。变异方法可以通过些方法的调用修改源数据中的数组；除此之外也有对应的非变异方法，比如filter()、concat()和slice()等。这些方法是不会改变源数据中的原始数组，但总是返回一个新数组。当使用这些方法时，可以用新数组替换旧数组。

由于JavaScript的限制，Vue不能检测以下变动的数组：

• 当你利用索引直接设置一个项时，例如app.items[indexOfItem] = newValue
• 当你修改数组的长度时，例如： app.items.length = newLength

为了解决第一类问题，以下两种方式都可以实现和app.items[indexOfItem = newValue相同的效果，同时也将触发状态更新：

Vue.set(app.items, indexOfItem, newValue)

app.items.splice(indexOfItem, 1, newValue)

为了解决第二类问题，你可以使用splice():

app.items.splice(newLength)

对象的 v-for

---

v-for除了可以使用在数组上之外还可以应用在对象上。

<!-- Template -->
<ul>
    <li v-for="value in obj">{{ value }}</li>
</ul>

// JavaScript
obj: {
    firstName: &#39;Airen&#39;,
    lastName: &#39;Liao&#39;,
    age: 30
}

使用v-for可以把obj的每个key对应的value值遍历出来，并且填到对应的li元素中。效果如下：

你也可以给对象的key遍历出来：

<ul>
    <li v-for="(value, key) in obj">{{ key }}: {{ value }}</li>
</ul>

效果如下：

同样，也可以类似数组一样，可以把index索引做为第三个参数：

<ul>
    <li v-for="(value, key, index) in obj">{{ index }}. {{ key }}: {{ value }}</li>
</ul>

前面提到过，数组可以变异，但对于对象而言，Vue不能检测对象属性的添加或删除。这主要也是由于JavaScript的限制。不过在Vue中，对于已经创建好的实例，可以使用Vue.set(object, key, value)方法向嵌套对象添加响应式属性。例如：

var app = new Vue({
    data: {
        obj: {
            name: 'Airen'
        }
    }
})

可以使用类似下面的方式，给obj对象添加一个新的属性age：

Vue.set(app.obj, 'age', 27)

回到我们的示例中给数据源中的obj添加一个'from'的key，而且其对应的value值为'江西'：

除了Vue.set()之外，还可以使用app.$set实例方法，它其实就是Vue.set的别名:

mounted(){
    this.$set(this.obj, '职位', '码农')
}

这里用到了Vue中的mounted()，和computed一样，也不知道他在Vue中的作用，同样放到后面来。我们总是会搞明白的。

有时候你可能需要为已有对象赋予多个新属性，比如使用Object.assign()或_.extend()。在这种情况下，应该用两个对象的属性创建一个新的对象。所以，如果你想添加新的响应式属性，不要像这样：

Object.assign(this.obj, {
    age: 27,
    favoriteColor: 'Vue Green'
})

应该这样做：

this.obj = Object.assign({}, this.obj, {
    age: 27,
    favoriteColor: 'Vue Green'
})

一段取值范围的 v-for

---

v-for也可以取整数。在这种情况下，它将重复多次模板：

<ul>
    <li v-for="n in 10">{{ n }}</li>
</ul>

结果如下：

v-for 和 一个 <template></template>

---

类似于v-if，你也可以利用带有v-for的<template></template>渲染多个元素，比如：

<ul>
    <template v-for="(value, key) in obj">
        <li>
            <label :for="key">{{ key }}:</label>
            <input type="text" :placeholder="value" :id="key" />
        </li>
    </template>
</ul>

效果如下：

注意了，v-for和<template></template>一起使用的时候，需要把v-for写在<template></template>元素上。另外上面的示例中，咱们还使用了Vue的一些其他特性，但这些特性不是这节内容所要学习的。后面我们会有机会一一介绍的。

一个组件的 v-for

---

在自定义组件里，也可以像任何普通元素一样用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示例：

<div id="todo">
    <input
        v-model="newTodoText"
        v-on:keyup.enter="addNewTodo"
        placeholder="Add a todo"
    />

    <ul>
        <li
            is="todoItem"
            v-for="(todo, index) in todos"
            v-bind:title="todo"
            v-on:remove="todos.splice(index, 1)"></li>
    </ul>
</div>

Vue.component(&#39;todoItem&#39;, {
    template:`
        <li>
            {{ title }}
            <button v-on:click="$emit(&#39;remove&#39;)">x</button>
        </li>
    `,
    props: [&#39;title&#39;]
})

new Vue({
    el: &#39;#todo&#39;,
    data: {
        newTodoText: &#39;&#39;,
        todos: [
            &#39;Do the dishes&#39;,
            &#39;Take out the trash&#39;,
            &#39;Mow the lawn&#39;
        ]
    },
    methods: {
        addNewTodo: function() {
            this.todos.push(this.newTodoText)
            this.newTodoText = &#39;&#39;
        }
    }
})

总结

---

这篇文章主要总结了Vue的v-for指令。通过这个指令，配合数据源中的数组或者对象，我们可以很方便的生成列表。这也常常称为列表渲染。当然配合一些模板，我们可以做出一些特有的功能和效果。比如文章中最后一个Todo 列表，使用v-for很易实现。

（学习视频分享：web前端开发、编程基础视频）

以上是詳解Vue渲染列表指令：v-for的詳細內容。更多資訊請關注PHP中文網其他相關文章！