萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

AngularJS 多模塊動態加載:解決重複 bootstrap 導致的模塊衝突

問題背景

AngularJS 規定 angular.bootstrap 全頁面只能調用一次。若多個 Partial View 獨立引入各自的 angular.module(...).bootstrap(),第二次調用會報錯或無效,導致後續模塊無法工作。

錯誤示例

<!-- Partial A -->
<script>
  angular.module('moduleA', []).controller('CtrlA', ...);
  angular.bootstrap(document, ['moduleA']); // 第一次 OK
</script>

<!-- Partial B -->
<script>
  angular.module('moduleB', []).controller('CtrlB', ...);
  angular.bootstrap(document, ['moduleB']); // 報錯!已 bootstrap 過
</script>

解決方案:全局模塊註冊表 + 單次啟動

1. 全局初始化腳本(在 layout head 引入)

<script>
// angular-init.js
(function() {
  // 兼容舊瀏覽器 Array.indexOf
  if (!Array.prototype.indexOf) {
    Array.prototype.indexOf = function(val) {
      for (var i = 0; i < this.length; i++) if (this[i] === val) return i;
      return -1;
    };
  }

  window.ngModules = window.ngModules || []; // 全局模塊名註冊表

  window.registerNgModule = function(moduleName) {
    if (window.ngModules.indexOf(moduleName) === -1) {
      window.ngModules.push(moduleName);
    }
  };
})();
</script>

2. 各模塊文件不再 bootstrap,改為註冊

<!-- moduleA.js -->
angular.module('moduleA', []).controller('CtrlA', function($scope) { ... });
registerNgModule('moduleA'); // 替換 bootstrap

<!-- moduleB.js -->
angular.module('moduleB', []).controller('CtrlB', function($scope) { ... });
registerNgModule('moduleB');

3. 頁面底部統一啟動(layout tail)

<script>
(function() {
  // 等待所有模塊文件加載完成(或用 requirejs/ES6 module 管理依賴)
  document.addEventListener('DOMContentLoaded', function() {
    var app = angular.module('app', window.ngModules || []);
    angular.bootstrap(document, ['app']);
  });
})();
</script>

進階:配合 RequireJS 實現按需加載

// main.js
require.config({
  paths: { angular: 'lib/angular', jquery: 'lib/jquery' },
  shim: { angular: { exports: 'angular' } }
});

require(['angular', 'moduleA', 'moduleB'], function(angular) {
  var modules = ['moduleA', 'moduleB']; // 可動態收集
  var app = angular.module('app', modules);
  angular.bootstrap(document, ['app']);
});

// moduleA.js (AMD)
define(['angular'], function(angular) {
  return angular.module('moduleA', []).controller('CtrlA', ...);
});

原理解析

  • angular.bootstrap 會創建根 $injector,綁定到 document 上(document.querySelector('[ng-app]') 或傳入元素)。
  • 二次調用會拋出 App Already Bootstrapped 錯誤。
  • 將所有依賴模塊名收集到主模塊 ['moduleA','moduleB',...],一次性 bootstrap 根模塊 app,Angular 內部會遞歸加載所有依賴。

注意事項

  1. 模塊名唯一:避免重名導致覆蓋。
  2. 加載順序:註冊腳本必須在模塊文件之前執行,或用模塊加載器保證順序。
  3. 懶加載:若需運行時動態加載模塊,需用 ocLazyLoad 或升級到 Angular 2+。
  4. 多應用隔離:頁面確有多個獨立 Angular 應用時,分別 bootstrap 不同根元素 angular.bootstrap('#app1', ['app1'])。

總結

「全局註冊表 + 單次 bootstrap」是 AngularJS 多 Partial View 共存的標準變通方案。雖略顯「惡心」,但能完美解決模塊衝突,且不改變業務代碼結構。新項目建議直接使用 Angular (2+) 或 Vue/React,原生支持模塊化與懶加載。

copyright © 萬盛學電腦網 all rights reserved