目標:把 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 對應的路由規則。
往下閱讀執行腳本,可以整理出幾個區塊:
其中 L195 的 $rootScope.$on('$routeChangeStart', function(){}) 與 L199 的 $rootScope.$on('$routeChangeSuccess', function(){}) 讓我學到:用 .$on() 可以綁定事件,而改變 hash 就能觸發這裡的程式碼。對比之後發現兩者做法基本一樣,唯一差別是先觸發 routeChangeStart,後觸發 routeChangeSuccess。
其他值得記下的功能點:
$scope.scrollItems = scrollItems;,scrollItems 是一個列表陣列;捲到底部的事件需要做下拉刷新。根據前面的分析,頁面載入取決於三個環節:
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 中的菜單路由。
<?=__PUBLIC__?> 換掉,並複製 2 個 js、3 個 css 檔案。至此,專案的樣板就成功換成了 AngularUI。
回顧整個過程,最花時間的其實不是改程式碼,而是理解 Angular 的路由與 <base> 標籤如何共同決定模板的最終請求路徑。這件事想通了之後,後面的檔案搬移與路徑替換就只是機械性的工作了。另外值得一提的是,把 index.php 從網址中隱藏起來需要同時調整應用設定、.htaccess 與 config.yaml 三處,任何一處漏掉都會導致路由失效——這類「分散式設定」在整合框架時特別容易出錯,建議改完之後逐條路由都實際測一遍。