篇章一:[AngularJS] 使用AngularAMD動態載入Controller

前言

使用AngularJS來開發Single Page Application(SPA)的時候，可以選用AngularUI Router來提供頁面內容切換的功能。但是在UI Router的使用情景裡，需要開發人員將每個State所使用的Controller預先載入之後，才能正常的切換頁面內容。這也就代表開發人員所建立的SPA，必須要在啟動的當下，就先將整個SPA所用到的Controller都預先載入到瀏覽器之中。而這樣的預先載入所有Controller備用的動作，在大型的專案中很容易造成瀏覽器效能上的負擔，進而影響使用者的操作體驗。

本篇文章介紹如何使用AngularAMD來動態載入Controller，讓SPA的啟動過程更加輕量化，用以提升使用者的操作體驗。主要為自己留個紀錄，也希望能幫助到有需要的開發人員。

AngularAMD

安裝

AngularAMD使用bower來發佈套件本體與其相依套件。而要使用bower必須要先安裝Node.js、接著安裝npm、最後安裝bower，完成安裝步驟之後，開發人員就可以使用bower來下載套件。相關bower的安裝步驟，可以參考下列資料：

Gulp, Grunt, Bower以及npm - 黑暗執行緒

安裝完bower之後，開發人員就可以建立一個新的資料夾作為工作資料夾。接著開啟命令提示字元CD到這個工作資料夾之後，輸入下列指令，就可以使用bower來取得AngularAMD套件本體與其相依套件。

bower install angularAMD

安裝01

而因為後續範例需要使用AngularUI Router這個Angular套件，來提供頁面內容切換的功能，所以還需要使用下列指令，使用bower來取得AngularUI Router這個套件。

bower install angular-ui-router

安裝02

完成上列步驟後，開啟工作資料夾可以看到多出來一個bower_components資料夾，而這個資料夾內擺放了angularAMD套件本體、以及angular、require.js、angular-ui-router這三個套件。

安裝03

開發app.js

完成安裝步驟後，在工作資料夾內新增一個app.js檔案，用來定義系統運行時的相關參數、還有必要的啟動程式碼。

開發01

接著需要在app.js裡面加入require.js的設定參數，用來定義系統運行時使用的套件路徑、以及套件之間的相依性。(相關require.js的使用介紹，可以參考：require.js的用法 - 阮一峰的网络日志)

require.config({
    paths: {
        // angular
        "angular": "bower_components/angular/angular",

        // angular-ui
        "angular-ui-router": "bower_components/angular-ui-router/release/angular-ui-router",

        // angularAMD
        "angularAMD": "bower_components/angularAMD/angularAMD",
        "ngload": "bower_components/angularAMD//ngload"
    },
    shim: {         
        // angular
        "angular": { exports: "angular" },

        // angular-ui
        "angular-ui-router": ["angular"],

        // angularAMD
        "angularAMD": ["angular"],
        "ngload": ["angularAMD"]
    }
});

完成require.js設定之後，在同一個app.js裡，加入下列require語法用來載入專案使用的套件。(相關require語法的使用介紹，同樣可以參考：require.js的用法 - 阮一峰的网络日志)

// bootstrap
define(["angular", "angularAMD", "angular-ui-router"], function (angular, angularAMD) {        
    // ......
});

接著在require語法內，使用下列ui-router+angularAMD語法，來定義系統內ui-router的路由設定、以及預設的開啟路徑。(相關ui-router語法的使用介紹，可以參考：学习 ui-router管理状态 - bubkoo)

// routes
var registerRoutes = function($stateProvider, $urlRouterProvider) {

    // default
    $urlRouterProvider.otherwise("/home");

    // route
    $stateProvider

        // home
        .state("home", angularAMD.route({
            url: "/home",
            templateUrl: "home.html",
            controllerUrl: "home.js"
        }))

        // home
        .state("about", angularAMD.route({
            url: "/about",
            templateUrl: "about.html",
            controllerUrl: "about.js"
        }))
    ;           
};

最後，同樣在require語法內，使用下列angular+angularAMD語法，來啟動系統裡的angular套件，這就完成了系統的運行參數、啟動程式碼的相關設定。(相關angular的使用介紹，建議參考：AngularJS 建置與執行 - Shyam Seshadri, Brad Green)

// module
var app = angular.module("app", ["ui.router"]);

// config
app.config(["$stateProvider", "$urlRouterProvider", registerRoutes]);

// bootstrap
return angularAMD.bootstrap(app);

開發Template、Controller

建立定義運行參數與啟動程式碼的app.js之後，就可以著手使用angular+require語法，來建立系統內ui-router所要切換使用的頁面樣板(Template)、以及頁面控制(Controller)。(相關angular的使用介紹，建議參考：AngularJS 建置與執行 - Shyam Seshadri, Brad Green)

home.html

<h1>{{ title }}</h1>
<br/>
<button ui-sref="about">About</button>

home.js

define([], function () {

    // controller
    return ["$scope", function ($scope) {

        // properties
        $scope.title = "This is Home page";
    }]; 
});

開發02

開發index.html

完成上列步驟之後，還需要建立index.html來做為整個Single Page Application(SPA)的程式進入點。在這個index.html裡，最主要就是使用requirejs來載入與執行app.js，並且在body裡面加入一個用來讓ui-router擺放頁面內容的div。

<!DOCTYPE html>
<html>
<head>    
    <!-- meta -->
    <meta charset="utf-8">

    <!-- title -->
    <title></title>

    <!-- script -->
    <script data-main="app.js" src="bower_components/requirejs/require.js"></script>
</head>
<body>
    <!-- content -->
    <div ui-view></div> 
</body>
</html>