隨著 JavaScript 程式變得越來越複雜,往往需要團隊協作開發,這時候程式碼的模組化與組織規範就變得格外重要。MVC(Model-View-Controller)正是程式碼組織的經典模式。
由於網頁編程有別於傳統客戶端編程,JavaScript 社群在 MVC 基礎上衍生出各種變體,例如 MVP(Model-View-Presenter)、MVVM(Model-View-ViewModel)等,有人把這一類模式統稱為 MV*。這類框架的優點是合理組織程式碼、便於團隊合作與日後維護;缺點則是有一定的學習成本,且會限制你只能採用它的寫法。
<script src="/javascripts/lib/jquery.js"></script> <script src="/javascripts/lib/underscore.js"></script> <script src="/javascripts/lib/backbone.js"></script> <script src="/javascripts/jst.js"></script> <script src="/javascripts/router.js"></script> <script src="/javascripts/init.js"></script>
Backbone.View 用於定義視圖類。透過它的 extend 方法可以定義一個視圖類 AppView,類內部的 render 方法負責把視圖放到網頁上:
var AppView = Backbone.View.extend({ render: function(){ $('main').append('<h1>一級標題</h1>'); } });使用時需先建立視圖類的實例,再呼叫 render 方法:
var appView = new AppView(); appView.render();
建立實例時,通常也需要指定 Model:
var document = new Document({ model: doc });視圖還可以定義 initialize 方法,在建立實例時自動呼叫以完成初始化,省去手動呼叫 render 的步驟:
var AppView = Backbone.View.extend({ initialize: function(){ this.render(); }, render: function(){ $('main').append('<h1>一級標題</h1>'); } }); var appView = new AppView();除了直接在 render 中指定綁定的網頁元素,也可以用 el 屬性指定,並透過 $el 取得對應的 jQuery 物件:
var AppView = Backbone.View.extend({ el: $('main'), render: function(){ this.$el.append('<h1>一級標題</h1>'); } });若不指定 el,也可用 tagName 與 className 屬性來產生元素:
var Document = Backbone.View.extend({ tagName: "li", className: "document", render: function() { // ... } });視圖的 template 屬性用來指定網頁模板,通常搭配 underscore 的 template 函式使用:
var AppView = Backbone.View.extend({ el: $('#container'), template: _.template("<h3>Hello <%= who %><h3>"), initialize: function(){ this.render(); }, render: function(){ this.$el.html(this.template({who: 'world!'})); } });實務上常把模板放在 type 為 text/template 的 script 標籤中,避免被瀏覽器當成 JavaScript 解析:
<script type="text/template" data-name="templateName"> <!-- template contents goes here --> </script>
可用下面的程式碼批次編譯模板:
window.templates = {}; var $sources = $('script[type="text/template"]'); $sources.each(function(index, el) { var $el = $(el); templates[$el.data('name')] = _.template($el.html()); });events 屬性用於指定視圖的事件與對應的處理函式:
var Document = Backbone.View.extend({ events: { "click .icon": "open", "click .button.edit": "openEditDialog", "click .button.delete": "destroy" } });listento 方法用來為特定事件指定回呼函式:
var Document = Backbone.View.extend({ initialize: function() { this.listenTo(this.model, "change", this.render); } });remove 方法則用於移除一個視圖:
updateView: function() { view.remove(); view.render(); };Router 是 Backbone 提供的路由物件,用來把使用者請求的網址與後端處理函式一一對應。首先定義一個 Router 類,最重要的屬性就是 routes:
Router = Backbone.Router.extend({ routes: { } });routes 的每個成員代表一條路徑規則,鍵名為路徑規則、鍵值為處理方法。空字串代表根路徑:
routes: { '': 'phonesIndex', }, phonesIndex: function () { new PhonesIndexView({ el: 'section#main' }); }星號代表任意路徑,可設定路徑參數來捕獲具體的值:
var AppRouter = Backbone.Router.extend({ routes: { "*actions": "defaultRoute" } }); var app_router = new AppRouter; app_router.on('route:defaultRoute', function(actions) { console.log(actions); })路徑規則的更多寫法:
var myrouter = Backbone.Router.extend({ routes: { "help": "help", "search/:query": "search" }, help: function() { ... }, search: function(query) { ... } });設定好 router 後就能啟動應用程式。Backbone.history 用來監控網址的變化:
App = new Router(); $(document).ready(function () { Backbone.history.start({ pushState: true }); });若應用程式不在根目錄,記得指定 root:
Backbone.history.start({pushState: true, root: "/public/search/"})Model 代表單一個物件實體。用 extend 定義一個 User 類,再用 new 建立實例,defaults 屬性用來設定預設屬性:
var User = Backbone.Model.extend({ defaults: { name: '', email: '' } }); var user = new User();建立實例時可提供各屬性的具體值:
var user = new User ({ id: 1, name: 'name', email: 'name@email.com' });Model 實例必須有一個作為主鍵的屬性,其名稱由 idAttribute 設定,一般設為 id。get 方法用來取得屬性值,set 方法用來設定屬性值:
var user = new User({ name: "name", age: 24}); var age = user.get("age"); // 24on 方法用來監聽物件變化,例如監聽 name 屬性的變動:
var user = new User({name: 'BMW',model:'i8'}); user.on("change:name", function(model){ var name = model.get("name"); console.log("Changed my car's name to " + name); }); user.set({name: 'Porsche'});urlroot 屬性用來指定伺服器端操作該 model 的路徑。fetch 事件用來從伺服器取出 Model(使用 GET):
var user = new User ({id: 1}); user.fetch({ success: function (user){ console.log(user.toJSON()); } })save 方法用來通知伺服器新建或更新 Model:若實例不含 id 屬性則用 POST 新建,含 id 則用 PUT 更新。destroy 方法則用 DELETE 在伺服器上刪除該實例。
Collection 是同一類 Model 的集合,就像 Model 是動物、Collection 是動物園那樣:
var Song = Backbone.Model.extend({}); var Album = Backbone.Collection.extend({ model: Song });可用 add 方法加入 Model 實例、remove 方法移除(參數為 id)、get 方法依 id 取得實例、fetch 方法從伺服器取出整個集合的資料。
Backbone 還提供了 Backbone.Events,可讓任意物件擁有事件訂閱與觸發的能力:
var obj = {}; _.extend(obj, Backbone.Events); obj.on("show-message", function(msg) { $('#display').text(msg); }); obj.trigger("show-message", "Hello World");總結來說,Backbone 透過 Model、View、Router、Collection 等幾個核心构件,把原本容易糾結成一團的 JavaScript 程式碼梳理得井然有序,是理解 MV* 架構一個很好的入門框架。