用JavaScript打造一個完整的應用,如果沒有合適的工具會相當吃力。jQuery只是操作DOM的庫,並不提供構建應用的基礎能力,這正是我們需要CanJS這類專門框架的原因。CanJS是一個輕量級的MVC庫,內建MVC基本框架、模板動態綁定、路由支持,並且內存安全,同時兼容jQuery、Zepto、MooTools、YUI、Dojo等,擴展與插件豐富。
先為你的應用創建一個文件夾,並在其中建立 css、js、views、img 四個子目錄。將下面的代碼保存為 index.html:
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>CanJS Contacts Manager</title> <link rel="stylesheet" href="css/bootstrap.min.css"> <link rel="stylesheet" href="css/contacts.css"> </head> <body> <div class="container"> <div class="row"> <div class="span12"> <h1>Contacts Manager</h1> </div> </div> <div class="row"> <div class="span3"> <div class="well"> <nav id="filter"></nav> </div> </div> <div class="span9"> <div id="create"></div> <div id="contacts"></div> </div> </div> </div> <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.js"></script> <script src="js/can.jquery.min.js"></script> <script src="js/can.fixture.js"></script> <script src="js/contacts.js"></script> </body> </html>
注意腳本放在頁面底部加載,包括你自己的 contacts.js。
View負責渲染應用的UI模板。CanJS支持多種模板引擎,本文採用EJS,它內建於CanJS且支持動態綁定。EJS的三種常用標簽:
<% CODE %> 執行JS;<%= CODE %> 執行JS並將未轉義結果寫入當前位置;<%%= CODE %> 執行JS並將轉義結果寫入當前位置(常用於子模板)。
將以下代碼保存為 views/contactsList.ejs:
<ul class="clearfix">
<% list(contacts, function(contact){ %>
<li class="contact span8" <%= (el)-> el.data('contact', contact) %>>
<%== can.view.render('views/contactView.ejs', {
contact: contact, categories: categories
}) %>
</li>
<% }) %>
</ul>
這裡的 list() 回調在配合可觀察列表時,一旦數據變化就會借助動態綁定重新調用;<li> 通過元素回調把聯系人數據掛到節點上;最後用 can.view.render() 把子模板渲染成單個聯系人。
把子模板拆分成獨立塊,既好管理又便於復用。保存以下代碼為 views/contactView.ejs:
<a href="javascript://" class="remove"><i class="icon-remove"></i></a>
<form>
<div class="row">
<div class="span2">
<img src="img/contact.png" width="100" height="100">
</div>
<div class="span3">
<input type="text" name="name" placeholder="Add Name"
<%= contact.attr('name') ? "value='" + contact.name + "'" : "class='empty'" %>>
<select name="category">
<% $.each(categories, function(i, category){ %>
<option value="<%= category.data %>" <%= contact.category === category.data ? "selected" : "" %>>
<%= category.name %>
</option>
<% }) %>
</select>
</div>
<div class="span3">
<label>Address</label>
<input type="text" name="address"
<%= contact.attr('address') ? "value='" + contact.address + "'" : "class='empty'" %>>
<label>Phone</label>
<input type="text" name="phone"
<%= contact.attr('phone') ? "value='" + contact.phone + "'" : "class='empty'" %>>
<label>Email</label>
<input type="text" name="email"
<%= contact.attr('email') ? "value='" + contact.email + "'" : "class='empty'" %>>
</div>
</div>
</form>
EJS在渲染時,凡是用到 attr() 的代碼都會交由事件處理器管理,監聽對應屬性的變化。一旦屬性改變,關聯的UI就會自動更新。這種動態綁定是有選擇性的——只有使用了attr()才會為該屬性開啟。例如:
<input type="text" name="name" placeholder="Add Name"
<%= contact.attr('name') ? "value='" + contact.name + "'" : "class='empty'" %>>
特殊標記裡的代碼會綁定到該聯系人的name屬性上,name一旦變化,事件觸發並刷新HTML。
can.Control創建了一個可組織、無洩漏的控制器,適合封裝widget或處理業務邏輯。它的重要成員約定包括:this(實例引用)、this.element(關聯的DOM元素)、this.options(參數對象)、init()(實例創建時調用)。當關聯元素從DOM中移除時,Control會自動銷毀並清除綁定。
在 contacts.js 中創建管理聯系人的Control:
Contacts = can.Control({
init: function(){
this.element.html(can.view('views/contactsList.ejs', {
contacts: this.options.contacts,
categories: this.options.categories
}));
}
})
實例創建時,init() 會用 can.view() 渲染模板(返回一個documentFragment),再用 jQuery.html() 把它插入到Control的元素中。
Model是應用的數據抽象層。本例子用兩個Model分別對應聯系人與類別:
Contact = can.Model({
findAll: 'GET /contacts',
create : "POST /contacts",
update : "PUT /contacts/{id}",
destroy : "DELETE /contacts/{id}"
},{});
Category = can.Model({
findAll: 'GET /categories'
},{});
一個Model最多可定義findAll、findOne、create、update、destroy五個方法來實現CRUD,配合REST服務效果最佳。Model實例源自CanJS的observable:can.Observe提供對象觀察者模式,can.Observe.List提供數組觀察模式,因此可以用attr()讀寫數據並監聽變動。
Fixture會攔截AJAX請求並用文件或方法模擬響應,非常適合測試或後端未就緒時使用。先准備數據:
var CONTACTS = [
{ id: 1, name: 'William', address: '1 CanJS Way', email: 'william@husker.com', phone: '0123456789', category: 'co-workers' },
{ id: 2, name: 'Laura', address: '1 CanJS Way', email: 'laura@starbuck.com', phone: '0123456789', category: 'friends' },
{ id: 3, name: 'Lee', address: '1 CanJS Way', email: 'lee@apollo.com', phone: '0123456789', category: 'family' }
];
var CATEGORIES = [
{ id: 1, name: 'Family', data: 'family' },
{ id: 2, name: 'Friends', data: 'friends' },
{ id: 3, name: 'Co-workers', data: 'co-workers' }
];
can.fixture()接收要攔截的URL和響應方法兩個參數,動態部分可用{}通配符:
can.fixture('GET /contacts', function(){
return [CONTACTS];
});
var id = 4;
can.fixture("POST /contacts", function(){
return {id: (id++)}
});
can.fixture("PUT /contacts/{id}", function(){
return {};
});
can.fixture("DELETE /contacts/{id}", function(){
return {};
});
can.fixture('GET /categories', function(){
return [CATEGORIES];
});
Model、View、Control都已就位,最後把一切串起來:
$(document).ready(function(){
$.when(Category.findAll(), Contact.findAll()).then(
function(categoryResponse, contactResponse){
var categories = categoryResponse[0],
contacts = contactResponse[0];
new Contacts('#contacts', {
contacts: contacts,
categories: categories
});
});
});
這段代碼先用 jQuery.ready 監聽DOM就緒,再用 $.when() 等待兩個 findAll() 異步請求同時完成,從響應數組中取出數據集,最後為 #contacts 元素創建Control。用瀏覽器打開頁面,就能看到聯系人列表了。

作為系列教程的第一篇,你已經掌握了CanJS的三大核心:Model(數據抽象層)、View(把數據轉換成HTML的模板)與Control(把一切組織關聯起來)。