DIV CSS 佈局教程網

把 AngularUI 模板改造進既有專案的實作筆記
編輯:關於JavaScript     

目標:把 AngularUI 的樣板應用到既有專案上。以下記錄整個改造過程與中間踩到的坑。

步驟一:依功能表調整 demo 介面

步驟二:搞懂 AngularUI 的頁面載入機制

為了設定自訂的載入模板,先在 demo/demo.js 中找到這一段:

//當 # 為 /、/scroll 等等,請求 index.html 中 <base href=""> + home.html 的頁面
app.config(function($routeProvider) {
  $routeProvider.when('/',          {templateUrl: 'home.html', reloadOnSearch: false});
  $routeProvider.when('/scroll',    {templateUrl: 'scroll.html', reloadOnSearch: false});
  $routeProvider.when('/toggle',    {templateUrl: 'toggle.html', reloadOnSearch: false});
  $routeProvider.when('/tabs',      {templateUrl: 'tabs.html', reloadOnSearch: false});
  $routeProvider.when('/accordion', {templateUrl: 'accordion.html', reloadOnSearch: false});
  $routeProvider.when('/overlay',   {templateUrl: 'overlay.html', reloadOnSearch: false});
  $routeProvider.when('/forms',     {templateUrl: 'forms.html', reloadOnSearch: false});
  $routeProvider.when('/dropdown',  {templateUrl: 'dropdown.html', reloadOnSearch: false});
  $routeProvider.when('/drag',      {templateUrl: 'drag.html', reloadOnSearch: false});
  $routeProvider.when('/carousel',  {templateUrl: 'carousel.html', reloadOnSearch: false});
});

看完這段就清楚了:頁面載入由兩個因素決定——<base href> 設定的基準路徑,加上 hash 對應的路由規則。

步驟三:繼續讀 demo.js 的其他部分

往下閱讀執行腳本,可以整理出幾個區塊:

  • 拖拽項消失
  • 拖拽切換圖片
  • 主要控制器

其中 L195 的 $rootScope.$on('$routeChangeStart', function(){}) 與 L199 的 $rootScope.$on('$routeChangeSuccess', function(){}) 讓我學到:用 .$on() 可以綁定事件,而改變 hash 就能觸發這裡的程式碼。對比之後發現兩者做法基本一樣,唯一差別是先觸發 routeChangeStart,後觸發 routeChangeSuccess。

其他值得記下的功能點:

  • 滾動列表頁:捲動時載入資料,$scope.scrollItems = scrollItems;,scrollItems 是一個列表陣列;捲到底部的事件需要做下拉刷新。
  • 右側聊天側欄:有 JSON 資料控制顯示線上/離線狀態,以我目前的能力暫時還做不出聊天功能。
  • 表單頁面

步驟四:換掉原本的 Bootstrap 樣板

根據前面的分析,頁面載入取決於三個環節:

1. base 路徑 => base_url()
2. hash 對應的頁面路徑 => 控制器/方法
3. 隱藏 index.php

隱藏 index.php 的設定:

config/config.php:

$config['index_page'] = '';   //L29 設置為空

.htaccess:

RewriteEngine on
RewriteCond $1 !^(lightapp|lightapp\.php|index\.php|public|robots\.txt)   #允許 lightapp|lightapp.php 訪問
RewriteRule ^(.*)$ /index.php/$1 [L]

config.yaml:

- rewrite: if( !is_file() && !is_dir()) goto "index.php?%{QUERY_STRING}"
# 如果 url 既不是文件,也不是目錄,跳轉至 index.php?%{QUERY_STRING}
# 不能放在 cron 後面

接著修改 demo.js 中的菜單路由。

步驟五:替換資源路徑與檔案

  1. 把資源路徑中的 <?=__PUBLIC__?> 換掉,並複製 2 個 js、3 個 css 檔案。
  2. 新建 style 與 script 目錄,用來存放專案自己的 js 與 css。
  3. 把字體目錄 fonts 複製到 public 下。
  4. 把 home.html、sidebar.html 複製到視圖目錄。

總結

至此,專案的樣板就成功換成了 AngularUI。

回顧整個過程,最花時間的其實不是改程式碼,而是理解 Angular 的路由與 <base> 標籤如何共同決定模板的最終請求路徑。這件事想通了之後,後面的檔案搬移與路徑替換就只是機械性的工作了。另外值得一提的是,把 index.php 從網址中隱藏起來需要同時調整應用設定、.htaccess 與 config.yaml 三處,任何一處漏掉都會導致路由失效——這類「分散式設定」在整合框架時特別容易出錯,建議改完之後逐條路由都實際測一遍。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved