前陣子接觸到一個叫做 Vue.js 的函式庫,用起來感覺相當順手,於是整理一篇筆記做個系統性介紹。
Vue 讀音近似 /vjuː/,與 view 諧音。它是一個資料驅動的 Web 介面函式庫,只聚焦於視圖層,因此很容易與其他函式庫整合,壓縮後體積僅約 24kb。
最簡單的例子:當 input 中的內容變化時,p 節點的內容會跟著變化。
<!-- html -->
<div id="demo">
<p>{{message}}</p>
<input v-model="message">
</div>
<script>
new Vue({
el: '#demo',
data: { message: 'Hello Vue.js!' }
})
</script>
資料綁定就是把 JS 中的變數自動反映到 HTML 上。message 的預設值是 "Hello Vue.js!",頁面啟動時 HTML 中的值就被設成它。
<div id="demo">
<p>{{message}}</p>
<input v-model="message">
</div>
若要輸出原生 HTML,使用三個大括號:
<p>{{{messageHtml}}}</p>
也可以做表達式綁定:
<div>{{length - 1}}</div>
<div>{{isShow ? 'block' : 'none'}}</div>
表達式後面可以接過濾器,對輸出的資料做處理:
<div>{{ message | capitalize }}</div>
Vue.js 也允許自定義過濾器:
Vue.filter('wrap', function (value, begin, end) {
return begin + value + end;
})
<!-- 'vue' => 'before vue after' -->
<span>{{ message | wrap 'before' 'after' }}</span>
指令是帶有 v- 前綴的特殊屬性。當表達式的值發生變化時,它會把對應的行為套用到 DOM 上。
<!-- greeting 為 true 時才顯示 p 節點 --> <p v-if="greeting">hello</p> <!-- 把 href 屬性綁到 JS 中 url 的值 --> <a v-bind:href="url"></a> <!-- 綁定事件,btnClick 是 JS 方法 --> <button v-on:click="btnClick"></button>
bind 與 on 可以縮寫:
<a v-bind:href="url"></a> <a :href="url"></a> <button v-on:click="btnClick"></button> <button @click="btnClick"></button>
Vue.directive('demo', {
bind: function () {
// 準備工作,例如註冊事件處理器或只跑一次的高成本任務
},
update: function (newValue, oldValue) {
// 值更新時的工作,也會以初始值呼叫一次
},
unbind: function () {
// 清理工作,例如移除 bind() 中註冊的事件監聽
}
})
Vue.js 支援對 JS 物件做條件判斷與迴圈輸出,寫起來很像前端模板語言。
<!-- ok 為 true 顯示 Yes,否則顯示 No -->
<h1 v-if="ok">Yes</h1>
<h1 v-else>No</h1>
<!-- 類似 v-if,差別是 v-if 決定要不要建立節點,v-show 決定 display 是否為 none -->
<h1 v-show="ok">Hello!</h1>
<!-- 迴圈;track-by 用於標示唯一鍵,避免重複渲染 -->
<!-- $index 表示陣列索引,$key 表示物件的鍵 -->
<ul id="example-1">
<li v-for="item in items" track-by="_uid">
{{ $index }} : {{ item.message }}
</li>
</ul>
<script>
var example1 = new Vue({
el: '#example-1',
data: {
items: [
{ _uid: '1', message: 'Foo' },
{ _uid: '2', message: 'Bar' }
]
}
})
</script>
樣式同樣可以依 JS 變數動態決定:
<!-- isA 為 true 時,class 多一個 class-a -->
<div class="static" v-bind:class="{ 'class-a': isA, 'class-b': isB }"></div>
<!-- 把 classA、classB 兩個變數的值設為 class -->
<div v-bind:class="[classA, classB]"></div>
<!-- 綁定 style,Vue 會自動補上前綴,styleObject 內是 style 鍵值對 -->
<div v-bind:style="styleObject"></div>
使用 v-on 指令監聽 DOM 事件:
<div id="example-2">
<button v-on:click="say('hi', $event)">Say Hi</button>
<button v-on:click="say('what', $event)">Say What</button>
</div>
<script>
new Vue({
el: '#example-2',
methods: {
say: function (msg, event) {
alert(msg);
event.preventDefault();
}
}
})
</script>
常見的阻止冒泡、取消預設行為,可以透過修飾符快速處理:
<!-- 禁止冒泡 --> <a v-on:click.stop="do"></a> <!-- 同時禁止冒泡與預設行為 --> <a @click.stop.prevent="do"></a>
針對特定按鍵也可以使用修飾符:
<!-- keyCode 為 13 時觸發 --> <input v-on:keyup.13="submit" /> <input v-on:keyup.enter="submit" /> <!-- 支援的按鍵名:enter, tab, delete, esc, space, up, down, left, right -->
元件系統是 Vue.js 的另一個重要概念。它提供了一種抽象,讓我們能用獨立、可重複使用的小元件來組出大型應用。
用 Vue.extend() 定義元件,再用 Vue.component() 註冊。
<div id="box">
<tree></tree>
</div>
<script>
// 定義
var Tree = Vue.extend({
template: '<div>This is a tree!</div>'
});
// 註冊
Vue.component('tree', Tree);
// 開始渲染
new Vue({ el: '#box' });
// 定義與註冊也可以合併成一步,效果相同
Vue.component('tree', {
template: '<div>This is a tree!</div>'
});
new Vue({ el: '#box' });
</script>
渲染結果:
<div id="box"> <div>This is a tree!</div> </div>
也可以做局部註冊:
var Child = Vue.extend({ /* ... */ });
var Parent = Vue.extend({
template: '...',
components: {
'my-component': Child
}
});
Vue.component('child', {
props: ['childMsg'],
// prop 可以直接在模板內使用
template: '<span>{{ childMsg }}</span>'
});
<child child-msg="hello"</child>
動態 props:當父元件的資料變化時,需要通知子元件跟著更新。
<input v-model="parentMsg" /> <child v-bind:child-msg="parentMsg"</child>
父元件資料變化時,透過 props 通知子元件;子元件狀態變化時,則利用事件向上通知父元件。
子元件可以用 this.$parent 存取父元件;父元件則有 this.$children 陣列,包含它所有的子元件。
<!-- 子元件模板 -->
<template id="child-template">
<input v-model="msg">
<button v-on:click="notify">Dispatch Event</button>
</template>
<!-- 父元件模板 -->
<div id="events-example">
<p>Messages: {{ messages | json }}</p>
<child></child>
</div>
<script>
// 註冊子元件,把當前訊息派發出去
Vue.component('child', {
template: '#child-template',
data: function () {
return { msg: 'hello' };
},
methods: {
notify: function () {
if (this.msg.trim()) {
this.$dispatch('child-msg', this.msg);
this.msg = '';
}
}
}
});
// 啟動父元件,收到訊息時推入陣列
var parent = new Vue({
el: '#events-example',
data: { messages: [] },
// 建立實例時,events 選項的效果等同呼叫 $on
events: {
'child-msg': function (msg) {
// 事件回呼中的 this 會自動綁定到註冊它的實例
this.messages.push(msg);
}
}
});
</script>
上面這種寫法在事件觸發後,實際執行的位置不夠直觀,所以更推薦用 v-on 直接綁定:
<!-- child-msg 觸發時,執行父元件的 handleIt 方法 --> <child v-on:child-msg="handleIt"</child>
在典型的 Vue.js 專案中,我們會把介面切成多個小元件,每個元件在同一處封裝自己的 CSS 樣式、模板與 JavaScript 定義。搭配 Webpack 或 Browserify 以及合適的轉譯工具,元件可以這樣寫:

當然也可以使用預處理器:

本文的語法對應 Vue 1.x。若你在 2.x 上實作,有幾處需要留意:track-by 已由 :key 取代;三個大括號的原生 HTML 插值改為 v-html;v-bind:class 的物件與陣列語法在 2.x 有更完整的支援;而 events 選項與 $dispatch/$broadcast 這套父子事件廣播機制在 2.x 已被移除,改用 $emit 搭配模板上的 v-on。查文件時請先確認版本,能省下不少時間。
以上是本文的全部內容,希望對大家的學習有所幫助。