AngularJS (1.x) 單頁應用 (SPA) 隨著功能增長,所有 Controller 集中載入會導致**首屏 JS 體積過大、啟動緩慢**。本文介紹基於 $controllerProvider.register、$routeProvider.resolve、$script.js 的**動態按需載入 Controller 完整方案**,實現路由級代碼分割,大幅提升首屏速度。
| 痛點 | 解決方案 |
|---|---|
| Controller 必須在模組啟動前註冊 | 利用 config 階段獲取 $controllerProvider,暴露 register 方法供後續動態註冊 |
| 路由切換時 Controller 尚未載入 | 在 resolve 中返回 Promise,阻塞路由直到 JS 載入並註冊完成 |
| 避免重複請求已載入 JS | 使用 $script.js (或 ocLazyLoad) 管理載入狀態,自動去重 |
var app = angular.module('myApp', ['ngRoute']);
app.config(function($controllerProvider, $compileProvider, $filterProvider, $provide) {
// 保存註冊器供運行期使用
app.register = {
controller: $controllerProvider.register,
directive: $compileProvider.directive,
filter: $filterProvider.register,
factory: $provide.factory,
service: $provide.service
};
});
app.config(function() {
// 版本號,用於緩存破壞
var v = '1.0.' + Date.now(); // 或從 package.json 讀取
app.asyncjs = function(jsPaths) {
return ['$q', '$route', '$rootScope', function($q, $route, $rootScope) {
var deferred = $q.defer();
var deps = Array.isArray(jsPaths) ? jsPaths : [jsPaths];
// 添加版本參數防緩存
deps = deps.map(function(p) { return p + '?v=' + v; });
// 使用 $script.js 載入 (需先引入 script.js)
$script(deps, function() {
$rootScope.$apply(function() {
deferred.resolve();
});
});
return deferred.promise;
}];
};
});
app.config(function($routeProvider) {
$routeProvider
.when('/plugin/:pluginName', {
templateUrl: function(params) {
return 'plugin/' + params.pluginName + '/index.html';
},
resolve: {
// 單個 controller
load: app.asyncjs('plugin/controller.js')
}
})
.when('/dashboard', {
templateUrl: 'views/dashboard.html',
resolve: {
// 多個依賴:controller + 日期選擇器插件
load: app.asyncjs([
'plugin/dashboard/controller.js',
'lib/jquery.ui.datepicker.js'
])
}
})
.otherwise({ redirectTo: '/' });
});
// 注意:不再用 angular.module(...).controller(...)
// 而是用運行期保存的 register 方法
app.register.controller('MyPluginCtrl', function($scope, $http) {
$scope.title = '動態載入的插件頁面';
$scope.loadData = function() {
$http.get('/api/data').then(function(res) {
$scope.items = res.data;
});
};
$scope.loadData();
});
<div ng-controller="MyPluginCtrl">
<h2>{{ title }}</h2>
<button ng-click="loadData()">重新載入</button>
<ul><li ng-repeat="item in items">{{ item.name }}</li></ul>
</div>
<script src="lib/script.js"></script> <!-- 必須先引入 -->
// $script 特性:
// 1. 並行載入多腳本,保證順序執行回調
// 2. 自動去重:同一 URL 只請求一次,後續直接觸發回調
// 3. 支援依賴鏈:$script('a.js', function() { $script('b.js', cb); });
// 4. 無依賴、極小 (1.5kb gzip)
若專案較大,建議直接使用 ocLazyLoad,它封裝了上述所有邏輯並支援:
requirejs、webpack 代碼分割產物ocLazyLoad.load() 程式化 APIui-router 的 resolve// ocLazyLoad 寫法
$ocLazyLoad.load({
name: 'myApp',
files: ['plugin/controller.js', 'plugin/style.css'],
cache: true
}).then(function() {
// 已註冊完成
});
若專案已遷移至 Webpack + AngularJS (透過 angular-webpack-plugin 或 @ngtools/webpack),請直接使用 **動態 import()**:
$routeProvider.when('/plugin/:name', {
templateUrl: ...,
resolve: {
load: ['$q', '$route', function($q, $route) {
var deferred = $q.defer();
import('./plugin/' + $route.current.params.name + '/controller.js')
.then(function() { deferred.resolve(); })
.catch(function() { deferred.reject(); });
return deferred.promise;
}]
}
});
| 現象 | 原因 | 解決 |
|---|---|---|
| Error: [ng:areq] Argument 'XCtrl' is not a function | Controller 未註冊就被路由實例化 | 確認 resolve 中 JS 已載入並呼叫了 app.register.controller |
| 路由切換無反應、無報錯 | JS 載入失敗、語法錯誤、Promise 未 resolve | Network 面板檢查 JS 是否 200;Console 看語法錯;添加 .catch(deferred.reject) |
| 重複進入同路由重複請求 JS | 未使用去重載入器 | 用 $script.js 或 ocLazyLoad 自動去重 |
| 模板 HTML 也需動態載入 | templateUrl 為函式返回路徑,瀏覽器會自動請求 | 確保模板靜態資源可訪問,或用 $templateCache 預載 |
AngularJS 動態載入 Controller 的核心在於:**config 階段保存註冊器 → resolve 階段異步載入 JS → JS 內部呼叫 register 完成註冊 → resolve 完成 → 路由繼續**。這套機制讓 SPA 具備了類似現代框架的**路由級代碼分割**能力。對於存量 AngularJS 專案,引入 ocLazyLoad 是性價比最高的升級路徑;新專務請直接選擇 Angular (2+)、React、Vue 等原生支援代碼分割的框架。