DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
Ember.js + jQuery Mobile + PhoneGap:動手做一個 HTML5 混合 App
編輯:HTML5詳解     

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

成品功能

  1. 抓取 https://feeds.adobe.com/xml/rss.cfm 的 XML 資料。
  2. 以列表形式呈現解析後的內容。
  3. 點擊任一項目即可跳轉到對應連結。

依賴套件

  • jQuery(1.8.2) — 官方網站 jquery.com,用來取代繁瑣的原生 JavaScript 語法。
  • jQuery Mobile(1.2.0 Final) — jquerymobile.com,負責 UI 建構。
  • Ember.js(0.9.8.1) — emberjs.com,負責 MVC 架構。
  • ember-bridge-jqm(0.1) — github.com/kenshin/ember-bridge-jqm。Ember.js 無法直接與 jQuery Mobile 並用,需要這層「代理」居中協調。
  • XML2JSON — 將 XML 轉為 JSON 的 jQuery 外掛。
  • PhoneGap(2.0.0) — phonegap.com,打包 App 時使用。

工程結構

  1. common:共用 JS 類庫,如 jQuery 與各類外掛。
  2. ember:Ember.js 相關類庫。
  3. Javascripts:對應 MVC 結構的自有程式碼。
  4. jqm:jQuery Mobile 相關類庫。
  5. phonegap:PhoneGap 相關類庫。
  6. stylesheets:CSS 檔。

為什麼需要 ember-bridge-jqm

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 的框架硬湊在一起,必然出現各種難以追蹤的錯誤,這正是代理層存在的理由。

Application(入口)

App = Em.Application.create();

Views(視圖)

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 的模板系統去產生對應結構。

Model(模型)

先定義與 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 有別於同代框架的關鍵之處。

Controller(控制器)

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 網址。

HTML 端:UI Binding 的魔法

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

本文只把 PhoneGap 當作打包工具,未呼叫任何原生 API,因此不必載入 cordova.js,直接打包即可。

結論與經驗

  1. Ember.js 與 jQuery Mobile 都屬侵入式框架,能避開就避開;若必須並用,一定要透過代理層(ember-bridge-jqm)。
  2. 受相容性所限,動態產生的 jQuery Mobile 元件無法直接寫進 HTML,得寫進 Handlebars 模板裡。
  3. 挑選搭配 Ember 的 UI 庫時,優先考慮非侵入式的選項,例如 Bootstrap。
  4. Ember 最強的一張牌是 UI Binding——透過 Collection、pushObject 與模板引擎三者協作,資料變動時視圖自動同步,不必手動操作 DOM。
  5. 如果你熟悉 Cocoa,會在 Ember 身上看到似曾相識的設計;如果你寫過 Flex,則會找回久违的 dataProvider 與 itemRenderer 概念。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved