DIV CSS 佈局教程網

Vue.js 入門教程:列表渲染 v-repeat 完全解析
編輯:關於JavaScript     

列表渲染是每個前端框架的必備能力。本文完整梳理 Vue.js 中 v-repeat 指令的用法,從基本渲染、塊級重複、變異方法,一路談到 track-by 效能優化、遍歷物件與內建過濾器,是一篇值得收藏的參考。

基本用法

可用 v-repeat 基於 ViewModel 上的物件陣列渲染列表。對陣列中每個物件,該指令會建立一個以該物件作為 $data 的子 Vue 實例,這些子實例繼承父實例的資料作用域,因此既能存取子實例屬性,也能存取父實例屬性;此外還可透過 $index 取得當前實例對應的陣列索引。

 <ul id="demo"> <li v-repeat="items" class="item-{{$index}}"> {{$index}} - {{parentMsg}} {{childMsg}} </li> </ul> 
 var demo = new Vue({ el: '#demo', data: { parentMsg: 'Hello', items: [ { childMsg: 'Foo' }, { childMsg: 'Bar' } ] } })

塊級重複

若需重複一個含多個節點的區塊,可用 <template> 標籤包裹。它只作語義上的包裹,本身不會被渲染:

 <ul> <template v-repeat="list"> <li>{{msg}}</li> <li class="divider"></li> </template> </ul>

簡單值陣列

對字串、數字、boolean 等並非物件的簡單值,可用 $value 直接存取:

 <ul id="tags"> <li v-repeat="tags"> {{$value}} </li> </ul> 
 new Vue({ el: '#tags', data: { tags: ['JavaScript', 'MVVM', 'Vue.js'] } })

使用別名

若想更明確地存取當前作用域變數,可透過參數為 v-repeat 指定迭代項的別名:

 <ul id="users"> <li v-repeat="user : users"> {{user.name}} - {{user.email}} </li> </ul> 
 var users = new Vue({ el: '#users', data: { users: [ { name: 'Foo Bar', email: 'foo@bar.com' }, { name: 'John Doh', email: 'john@doh.com' } ] } });

變異方法

Vue.js 內部對被觀察陣列的變異方法(push、pop、shift、unshift、splice、sort、reverse)進行了攔截,因此呼叫這些方法也會自動觸發視圖更新。

 // 以下操作會觸發 DOM 更新 demo.items.unshift({ childMsg: 'Baz' }) demo.items.pop() 

下面這個例子示範點擊按鈕時移除資料項:

 <!DOCTYPE html> <html> <head lang="en"> <meta charset="UTF-8"> <title></title> <script src="https://cdnjs.cloudflare.com/ajax/libs/vue/0.12.16/vue.min.js"></script> </head> <body> <ul id="tags"> <li v-repeat="tags"> {{$value}} </li> </ul> <input type="button" value="測試" onclick="myClick();"> <script> var tag = new Vue({ el: '#tags', data: { tags: ['標簽一', '標簽二', '標簽三'] } }); function myClick(){ tag.tags.pop(); } </script> </body> </html> 

擴展方法

Vue.js 為被觀察陣列加了 $set() 與 $remove() 兩個便捷方法。應避免直接透過索引設定元素(如 demo.items[0] = {}),因為這類改動無法被偵測到,正確做法是用 $set():

 // 不要用 `demo.items[0] = ...` demo.items.$set(0, { childMsg: 'Changed!'}) 

$remove() 則是 splice() 的語法糖,會移除給定索引處的元素;若參數不是數值,它會搜尋該值並刪除第一個相符的元素:

 // 刪除索引為 0 的元素。 demo.items.$remove(0) 
 <!DOCTYPE html> <html> <head lang="en"> <meta charset="UTF-8"> <title></title> <script src="https://cdnjs.cloudflare.com/ajax/libs/vue/0.12.16/vue.min.js"></script> </head> <body> <ul id="tags"> <li v-repeat="tags"> {{$value}} </li> </ul> <input type="button" value="測試" onclick="myClick();"> <script> var tag = new Vue({ el: '#tags', data: { tags: ['標簽一', '標簽二', '標簽三'] } }); function myClick(){ //tag.tags.pop(); //tag.tags[0] = '修改後的內容不生效'; tag.tags.$set(0, '修改後的內容生效'); tag.tags.$remove(1); } </script> </body> </html> 

替換陣列

當你使用 filter、concat、slice 等非變異方法時,回傳的是一個不同的陣列實例,此時可用新陣列替換舊的:

 demo.items = demo.items.filter(function (item) { return item.childMsg.match(/Hello/) })

你可能會擔心這會導致整個列表的 DOM 被銷毀重建,但其實 Vue.js 能辨識陣列元素是否已有關聯的 Vue 實例,並盡可能有效復用。

使用 track-by

某些時候你需要用全新的物件(例如 API 回傳的物件)替換陣列。若每個資料物件都有唯一的 id 屬性,可用 track-by 提示 Vue.js 復用已有實例與 DOM 節點。例如資料長這樣:

 { items: [ { _uid: '88f869d', ... }, { _uid: '7496c10', ... } ] }

就能這樣給出提示:

 <div v-repeat="items" track-by="_uid"> <!-- content --> </div> 

替換 items 時,若碰到有相同 _uid 的新物件,Vue.js 就知道可直接復用已有實例。在重新渲染大型列表時,合理使用 track-by 能顯著提升效能。

遍歷物件

v-repeat 也能遍歷物件的所有屬性,每個重複實例會有個特殊屬性 $key;對簡單值同樣可用 $value:

 <ul id="repeat-object"> <li v-repeat="primitiveValues">{{$key}} : {{$value}}</li> <li>===</li> <li v-repeat="objectValues">{{$key}} : {{msg}}</li> </ul> 
 new Vue({ el: '#repeat-object', data: { primitiveValues: { FirstName: 'John', LastName: 'Doe', Age: 30 }, objectValues: { one: { msg: 'Hello' }, two: { msg: 'Bye' } } } });

由於 ECMAScript 5 無法偵測物件新增或刪除屬性,Vue.js 為被觀察物件加了 $add(key, value)、$set(key, value) 與 $delete(key) 三個擴展方法,用於在增刪屬性時觸發視圖更新。$add 與 $set 的差別在於:當指定鍵已存在時 $add 會提前返回,因此 obj.$add(key) 不會以 undefined 覆蓋既有值。

迭代值域

v-repeat 也能接受一個整數,此時會重複顯示模板多次。以下範例迭代 3 次:

 <div id="range"> <div v-repeat="val">Hi! {{$index}}</div> </div> 
 new Vue({ el: '#range', data: { val: 3 } });

陣列過濾器

有時我們只想顯示陣列過濾或排序後的版本,而不想改動原始資料。Vue 提供了 filterBy 與 orderBy 兩個內建過濾器來簡化這類需求:

 <input v-model="searchText"> <ul> <li v-repeat="users | filterBy searchText">{{name}}</li> </ul> 
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved