HTML5 興起之後,前端 MVC 框架如雨後春筍般冒出:Backbone.js、Ember.js、AngularJS……它們在哲學與 API 設計上各有主張。本文不談抽象比較,而是直接動手做一個名為 Adobe Reader 的混合式 App(Hybrid App),用 Ember.js 搭配 jQuery Mobile 與 PhoneGap,讀取 RSS 源並以列表呈現。
https://feeds.adobe.com/xml/rss.cfm 的 XML 資料。


Ember.js 在渲染時會改寫 HTML,本質上是一個「侵入性」很強的框架;而 jQuery Mobile 同樣以改寫 DOM 著稱——它會把 <div data-role="header"></div> 變成 <div data-role="header" class="ui-header ui-bar-a" role="banner"></div>。兩個都想動同一份 DOM 的框架硬湊在一起,必然出現各種難以追蹤的錯誤,這正是代理層存在的理由。
App = Em.Application.create();
App.PageView = Mov.PageView.extend(); App.HeaderView = Mov.HeaderView.extend(); App.FooterView = Mov.FooterView.extend(); App.ContentView = Mov.ContentView.extend();
注意這裡的視圖並非直接繼承 Ember 原生類別,而是繼承自 Mov——這個命名空間就定義在 ember-bridge-jqm 之中。引入代理層後,原本需要手寫的 jQuery Mobile 骨架:
<div data-role="page"> <div data-role="header"></div> <div data-role="content"></div> <div data-role="footer"></div> </div>
就能改以 JavaScript 物件的方式宣告,交給 Ember 的模板系統去產生對應結構。
先定義與 RSS 節點對應的資料結構:
App.Articles = Ember.Object.extend({
title: null, link: null, desc: null, creator: null, date: null
});
接著負責抓資料的 ServicesModel:
App.ServicesModel = function (target, url) {
$.ajax({
type: "GET",
url: url,
success: function (xml) {
var json = $.xml2json(xml); // XML 轉 JSON
App.Json2Obj(target, json.item); // 轉為 Ember 物件
}
});
};
它做三件事:以 Ajax 抓取 RSS、把 XML 轉成 JSON、呼叫 Json2Obj。而 Json2Obj 則遍歷 JSON,逐筆建立 App.Articles 實例並塞進目標容器的 content:
App.Json2Obj = function (target, tmp) {
target.set('content', []);
$(tmp).each(function (index, value) {
var item = App.Articles.create({
title: value.title, link: value.link,
desc: value.description, creator: value.creator, date: value.date
});
target.pushObject(item);
});
};
pushObject 是 Ember 的方法,搭配 ArrayController 使用時,能讓寫入動作自動反映到已綁定的視圖上——這是 Ember 有別於同代框架的關鍵之處。
App.getArticlesController = Ember.ArrayController.create({
content: [],
init: function () {
App.ServicesModel(this, "https://feeds.adobe.com/xml/rss.cfm?query=byMostRecent&languages=5");
}
});
控制器在初始化時呼叫模型層,並傳入兩個參數:this(供 pushObject 使用)與 RSS 網址。
CSS 放在 <head>,而所有 <script> 一律放在 <body> 底部,以加快首屏載入。骨架只需要一個模板佔位與一個 page 容器:
<script type="text/x-handlebars" data-template-name="main"></script> <div data-role="page"></div>
這裡有個容易踩雷的細節:data-template-name 的值必須是 "main",且 PageView 的 templateName 與 id 也要照約定填寫,否則 jQuery Mobile 不會被正確初始化。
App.PageView = Mov.PageView.extend({
templateName: 'main',
id: 'page-view',
didInsertElement: function () {
$.mobile.changePage(this.$());
}
});
在 app.js 新增一個 ListView:
App.ListView = Mov.ListView.extend();
接著在模板中以 collection 形式綁定資料來源:
{{#view App.ContentView}}
{{#collection App.ListView contentBinding="App.getArticlesController"}}
<a {{bindAttr href="content.link"}} data-ajax="false">
<h3>{{content.title}}</h3>
<p>via {{content.creator}}</p>
<p>{{{content.desc}}}</p>
</a>
{{/collection}}
{{/view}}
幾個要點:因為綁定的來源是陣列型控制器,所以必須用 collection 而非 view;content.title 等欄位最終來自 Json2Obj 寫入的 App.Articles 物件;至於連結,請務必寫成 bindAttr href 而不是 <a href="{{content.link}}">——因為 Ember 注入程式碼時會插入 <script id="metamorph-x-start" type="text/x-placeholder"> 這類佔位節點,直接插值會產生非預期的結果。
本文只把 PhoneGap 當作打包工具,未呼叫任何原生 API,因此不必載入 cordova.js,直接打包即可。
Collection、pushObject 與模板引擎三者協作,資料變動時視圖自動同步,不必手動操作 DOM。