Vue 是一個小巧輕便的 JavaScript 函式庫,API 簡單易懂,能讓開發 web 應用變得更輕鬆。一直讓 Vue 引以為傲的,正是它的便利性、執行效率與靈活性。
這篇教程的目標,是透過一連串實作範例帶你概覽最基礎的概念與特性;後續文章則會談到更多實用功能,最終用 Vue 搭出一個可擴展的專案。
先初始化一個 HTML 頁面,再引入 Vue 的 js 檔。引入方式很多:可以在 script 裡掛 CDN、從官網下載 vue.min.js,或用 npm 安裝依賴。為了方便,本文用 CDN。
<!DOCTYPE html> <html> <head> <title>從零開始學Vue</title> </head> <body> <script src="https://cdn.jsdelivr.net/vue/1.0.16/vue.js"></script> </body> </html>
開發階段請務必使用未壓縮版本,因為它會提供詳細的警告訊息,能替你省下大量除錯時間。
接著在 body 裡放一個 div,建立 Vue 實例並把它與 div 綁定。建立實例要用 Vue() 建構子,並在實例中指明「掛載點」——這個掛載點就是你替 Vue 實例劃出的邊界,兩者一一對應。你只能在掛載點內部處理這個實例的事務,邊界外的部分它管不著。設定掛載點的參數是 el,值可以用 DOM 元素或 CSS 選擇器表示。
<!DOCTYPE html>
<html>
<head>
<title>從零開始學Vue</title>
</head>
<body>
<div id="vueInstance">這中間就是實例掛載點的實例邊界</div>
<script src="https://cdn.jsdelivr.net/vue/1.0.16/vue.js"></script>
<script>
// 建立一個新的 Vue 實例,並設置掛載點
var V = new Vue({ el : '#vueInstance' });
</script>
</body>
</html>
如你所見,new 一個 Vue() 就能建立實例,並指定一個 DOM 元素作為掛載點。上面用 CSS 的 id 選擇器來定義,實例名稱也可以自行決定,方便日後呼叫。
v-model 可以綁在 input 上,讓我們即時取得資料物件的值。你可以把它理解為一個特別的屬性,寫法就像 HTML 元素的屬性一樣。這種雙向綁定可以用在許多表單元素上,例如 input、textarea、select。
換句話說,v-model 綁定的就是那個「我們希望能透過使用者輸入而更新」的資料。以下範例要在 input 上綁定 name,就必須在 Vue 實例的 data 物件中先宣告它:
<div id="vueInstance">
輸入您的姓名:
<input type="text" v-model="name">
</div>
<script src="https://cdn.jsdelivr.net/vue/1.0.16/vue.js"></script>
<script>
var V = new Vue({
el : '#vueInstance',
data : { name : '_Appian' }
});
</script>
不管使用者輸入多少次,name 都會自動更新;反過來,只要 name 的值被改變,其他對應到 name 的地方也會同步修改。這種同步,正是靠 v-model 讓資料透過底層資料流直接綁定後修改的結果——這就是雙向綁定的概念。
為了驗證,我們可以用 $data 把資料映射印出來看看:
<div id="vueInstance">
輸入您的姓名:
<input type="text" v-model="name">
<p>{{ $data | json }}</p>
<p>{{ name }}</p>
</div>
<script>
var V = new Vue({
el : '#vueInstance',
data : { name : '_Appian' }
});
</script>
第一行的重點:$data 是 Vue 實例觀察的資料物件,本質是個物件,所以能轉成 json,也可以用一個新物件整體替換掉;實例會代理它上面的屬性。{{ }} 是插值語法,插入的是 $data 即時變化的值。| json 則是一個過濾器,效果等同 JSON.stringify(),只是讓資料看起來更直觀。
第二行 {{ name }} 就是在插值表達式中直接放資料變數,映射 name 的值。Vue 就是這麼簡單地完成雙向綁定:一個 v-model 指令即可,不必靠 js 或 jQuery 手動控制。相信你能從上面的例子理清邏輯。
Vue 用 v-on 指令做事件監聽與分發。你可以在實例的 methods 中建立方法,再把它綁到監聽事件上。
以下範例建立一個 say 方法綁在 button 上,點擊後會彈出帶有使用者 name 的歡迎視窗。要把它指派給 button,用 v-on:click 進行綁定:
<div id="vueInstance">
輸入您的姓名:
<input type="text" v-model="name">
<button v-on:click="say">歡迎點擊</button>
<button @click="say">歡迎點擊</button>
</div>
<script>
var V = new Vue({
el : '#vueInstance',
data : { name : '_Appian' },
methods : {
say : function(){ alert('歡迎' + this.name); }
}
});
</script>
當然不只 click,還能綁其他滑鼠事件、鍵盤事件等等,例如 v-on:mouseover、v-on:keydown、v-on:submit、v-on:keypress、v-on:keyup,甚至是自訂事件。由於事件綁定非常頻繁,Vue 提供了縮寫:用 @ 取代 v-on,也就是範例中的第二種寫法。
如果我們希望使用者登入後才看到歡迎區,未登入時改顯示登入表單,就可以用 v-if 與 v-show 來控制不同狀態下的顯示內容。
沿用前面的例子,用 loginStatus 控制是否登入:為 true 時顯示輸入框與歡迎按鈕;為 false 時只顯示帳號、密碼輸入框與登入按鈕(暫不做身分驗證,只切換狀態)。
<div id="vueInstance">
<!-- loginStatus 為 true 時會顯示的 section -->
<section v-if="loginStatus">
輸入您的姓名:
<input type="text" v-model="name">
<button v-on:click="say">歡迎點擊</button>
<button @click="switchLoginStatus">退出登錄</button>
</section>
<!-- loginStatus 為 false 時會顯示的 section -->
<section v-if="!loginStatus">
登錄用戶: <input type="text">
登錄密碼: <input type="password">
<button @click="switchLoginStatus">登錄</button>
</section>
</div>
<script>
var V = new Vue({
el : '#vueInstance',
data : { name : '_Appian', loginStatus : false },
methods : {
say : function(){ alert('歡迎' + this.name); },
switchLoginStatus : function(){ this.loginStatus = !this.loginStatus; }
}
});
</script>
這裡的 this 指的就是實例 V。this 的指向是個需要自己搞懂的題目,本文不展開。把 v-if 換成 v-show 也能得到相同效果;兩者都支援 v-else,但綁定 v-else 的標籤,其前一個兄弟元素必須有 v-if 或 v-show。
點擊「登錄」或「退出登錄」都會觸發 switchLoginStatus,讓 loginStatus 在 true 與 false 之間切換,進而改變 v-if 的判斷結果,畫面上顯示的 section 也就跟著換了。
切換 v-if 時,Vue 有一段局部編譯/卸載的過程,因為 v-if 裡的模板可能包含資料綁定或子元件。v-if 是「真正的」條件渲染:它會確保條件塊在切換過程中,內部的事件監聽器與子元件被妥善銷毀與重建。
v-if 也是惰性的——如果初始渲染時條件為假,它什麼都不做,直到條件第一次為真才開始局部編譯(編譯結果會被快取)。
相比之下 v-show 簡單得多:元素一律被編譯並保留,只是用 CSS 做顯示切換。
一般來說,v-if 的切換成本較高,v-show 的初始渲染成本較高。因此需要頻繁切換時用 v-show 較好;若條件在執行期幾乎不會改變,用 v-if 較好。這個差異在目前的小專案裡或許不明顯,但當專案規模變大時就會浮現,值得提早留心。
經營電商網站的話,你一定有很多頁面需要渲染商品列表。v-for 允許我們遍歷陣列,寫成 element in arrayObj 的形式,唸作「循環 arrayObj 裡的每一個 element」。
<div id="vueInstance">
<ul>
<li v-for="el in products">
{{ el.name }} - ¥ {{ el. price }} - {{ el. category }}
</li>
</ul>
</div>
<script>
var V = new Vue({
el : '#vueInstance',
data : {
products : [
{name: 'microphone', price: 25, category: 'electronics'},
{name: 'laptop case', price: 15, category: 'accessories'},
{name: 'screen cleaner', price: 17, category: 'accessories'},
{name: 'laptop charger', price: 70, category: 'electronics'},
{name: 'mouse', price: 40, category: 'electronics'},
{name: 'earphones', price: 20, category: 'electronics'},
{name: 'monitor', price: 120, category: 'electronics'}
]
}
});
</script>
data 裡的陣列不一定得像這樣寫死,也可以從資料庫或 ajax 請求取得,這裡只是為了示範 v-for。若需要拿到項目在陣列中的索引,可以用 $index:
<!-- 寫法一 -->
<li v-for="el in products">
{{ $index }} - {{ el.name }} - ¥ {{ el. price }} - {{ el. category }}
</li>
<!-- 寫法二 -->
<li v-for="(index,el) in products">
{{ index }} - {{ el.name }} - ¥ {{ el. price }} - {{ el. category }}
</li>
計算屬性的典型場景是:某個變數的值需要由其他變數計算得出。
例如使用者在輸入框輸入一個數 x,頁面自動回顯它的平方 x²。這時就要對輸入框做資料綁定,並在資料變動時立即計算:
<div id="vueInstance">
輸入一個數字:
<input type="text" v-model="value">
<p>計算結果:{{ square }}</p>
</div>
<script>
var V = new Vue({
el : '#vueInstance',
data : { value : 1 },
computed : {
square : function(){
return this.value * this.value;
}
}
});
</script>
計算屬性是透過定義一系列 function 來宣告的,寫法與定義 methods 時相同。上面的 square 回傳兩個 this.value 的乘積。
再來看一個稍微複雜的例子:系統隨機取一個 1~10 的數字,使用者也在輸入框輸入 1~10 的數字,剛好相同就算猜中。
<div id="vueInstance">
輸入1~10內的數字:
<input type="text" v-model="value">
<p>計算結果:{{ resultMsg }}</p>
</div>
<script>
var V = new Vue({
el : '#vueInstance',
data : {
value : null,
randNum : 5 // 第一次隨機數為 5
},
methods : {
getRandNum: function(min, max){
return Math.floor(Math.random() * (max - min + 1)) + min;
}
},
computed : {
resultMsg : function(){
if (this.value == this.randNum) {
this.randNum = this.getRandNum(1, 10);
return '你猜對了!';
} else {
this.randNum = this.getRandNum(1, 10);
return '猜錯了,再來!';
}
}
}
});
</script>
到這裡,你已經掌握了 Vue 的基本用法。這個框架足夠小而輕,背後有完整的設計思想,能帶來更流暢的用戶體驗並有效提升開發效率。上面這一系列例子,你都跑通了嗎?
接下來要做的,就是多關注 Vue 的最新動態,或繼續往後面的內容走下去。
專案範例:https://github.com/AppianZ/Close2Vue
補充一點:本文使用的是 Vue 1.x 的語法(如 filterBy、過濾器寫法、this 相關 API),在 Vue 2 之後已有大幅變動,實際上手時請以你所用版本的官方文件為準。