摘要：從最重要的頁面開始吧錦標賽的表格。重啟你的應用，看看搜索框。然后我們加入兩個路由一個轉向錦標賽表格，另一個轉向車手詳情。你所需要做的只是創建一個名為的文件，然后將錦標賽表格放在那里。結論我們已經介紹了開發一個簡單應用所需的一切。

AngularJS是Google開源出來的一款 Javascript MVC 框架。利用AngularJS，你可以構建結構清晰、便于測試和維護的前端應用。

使用AngularJS，你可以通過directive去定義很多自己的HTML元素屬性。AngularJS無縫銜接了HTML(view)和Javascript(model)，這樣你就不需要去過多地關注Dom如何變化，你只需專注的處理你的數據。

AngularJS和服務器通信非常方便。和大多數Javascript的MVC框架一樣， 只要你的應用提供一個RESTful API，AngularJS就可以和你的服務器相配合。同時，AngularJS提供了基于XHR的服務，這將大大簡化你的代碼，也方便將可復用的服務抽象成API調用。

Raoni Boaventura提供了一個教程，一步一步地教你寫一個簡單的AngularJS應用，讓我們一起來看一下吧。

為了簡化問題，我們要做的是一個直接從網絡上拉取信息的應用，比如，一個查看方程式賽車比賽信息的應用。直接用Ergast的api獲取信息。

可以看一下這個demo，對我們要做一個什么樣的應用有個大致的概念。

推薦使用augular-seed，提供了一個很好的項目骨架。

我們的應用的骨架大概是這樣的：

現在要開始寫代碼了。從最重要的頁面開始吧：錦標賽的表格。

HTML大概是這個樣子的（為了提高可讀性，先忽略CSS）：

  

    

      
Drivers Championship Standings
    
    

      

        
{{$index + 1}}
        

          
          {{driver.Driver.givenName}} {{driver.Driver.familyName}}
        
        
{{driver.Constructors[0].name}}
        
{{driver.points}}
      
    
  

我想你會注意到模板里面有一些{{ 和 }} 之類的表達式。我們可以在里面做一些計算。舉一些例子吧：

{{ 1 + 1 }}
{{ 946757880 | date }}
{{ user.name }}

是不是和javascript很像？不過，雖然它們很強大，我們不應該用它們去實現一些高層級的邏輯——這該交給directive。

上面的模板里還有一些類似ng-attributes的語句，這些正是directive。

directive讓AngularJS把特定的行為附加到DOM元素中。讓我們看一下上面的模板中的例子：

ng-app 初始化你的應用，定義其作用域。在 AngularJS 中，同一頁面可以有多個應用，ng-app 指令表明應用的首尾位置。

ng-controller 定義視圖由哪個控制器負責。在我們的例子中，driversController提供了車手的列表（driversList）。

ng-repeat 這個最常用。當使用循環的時候，ng-repeat定義模板的范圍。在我們的例子中，就driversList中的每個車手，ng-repeat會生成重復的行。

當然，沒有控制器，我們的視圖什么也干不了。讓我們在controllers.js中添加一個driversController：

angular.module("F1FeederApp.controllers", []).
controller("driversController", function($scope) {
    $scope.driversList = [
      {
          Driver: {
              givenName: "Sebastian",
              familyName: "Vettel"
          },
          points: 322,
          nationality: "German",
          Constructors: [
              {name: "Red Bull"}
          ]
      },
      {
          Driver: {
          givenName: "Fernando",
              familyName: "Alonso"
          },
          points: 207,
          nationality: "Spanish",
          Constructors: [
              {name: "Ferrari"}
          ]
      }
    ];
});

你可能注意到了我們將$scope傳遞給了控制器。$scope變量將控制器和視圖相連接。事實上，它儲存了模板中會用到的所有數據。任何你加入的內容（比如我們的例子中的driversList）可以直接在視圖中訪問。現在我們先用一個靜態的數據數組，稍后我們會把它換成API服務。

在app.js中加入：

angular.module("F1FeederApp", [
  "F1FeederApp.controllers"
]);

這行代碼讓我們初始化了我們的應用，同時也登記了需要的依賴。稍后我們會回到這個文件。

好了，現在讓我們把這一切在index.html中整合起來：

  
  
  
  
  
  


  

    

      
Drivers Championship Standings
    
    

      

        
{{$index + 1}}
        

          
          {{driver.Driver.givenName}} {{driver.Driver.familyName}}
        
        
{{driver.Constructors[0].name}}
        
{{driver.points}}
      
    
  

現在你可以嘗試運行下這個應用了。

如果你希望調試應用，建議看下Chrome的Batarang 插件。

既然我們已經知道如何展示這些數據了，現在該是我們從RESTful服務器獲取信息的時候了。

AngularJS提供的$http和$resource幫助我們和服務器通訊。
$http是以XMLHttpRequest和[JSONP]為基礎的抽象層，$resource則提供更高層的抽象。在這里我們使用$http。

為了將API調用從控制器中抽象出來，我們創建一個自己定制的服務，該服務將抓取我們需要的信息，將$http封裝起來。在services.js中加入：

angular.module("F1FeederApp.services", []).
  factory("ergastAPIservice", function($http) {

    var ergastAPI = {};

    ergastAPI.getDrivers = function() {
      return $http({
        method: "JSONP", 
        url: "http://ergast.com/api/f1/2013/driverStandings.json?callback=JSON_CALLBACK"
      });
    }

    return ergastAPI;
  });

開頭兩行，我們創建了一個名為F1FeederApp.services的新模塊，并在ergastAPIservice模塊內注冊了服務。注意，我們將$http傳遞給了該服務。這就告訴了Angular的依賴注入引擎我們的新服務依賴于$http服務。

類似地，我們需要讓Angular將我們的新模塊包含到應用中。在app.js注冊下即可：

angular.module("F1FeederApp", [
  "F1FeederApp.controllers",
  "F1FeederApp.services"
]);

現在我們只需調整一下controller.js，將ergastAPIservice作為依賴：

angular.module("F1FeederApp.controllers", []).
  controller("driversController", function($scope, ergastAPIservice) {
    $scope.nameFilter = null;
    $scope.driversList = [];

    ergastAPIservice.getDrivers().success(function (response) {
        //Dig into the responde to get the relevant data
        $scope.driversList = response.MRData.StandingsTable.StandingsLists[0].DriverStandings;
    });
  });

好了，重新啟動一下應用，看看結果如何。注意我們完全沒有改動模板，只是增加了一個nameFilter。讓我們把這個變量用起來。

好極了！我們的控制器已經可以工作了。但是它只能顯示一個車手的列表。讓我們加一些功能吧。我們來實現一個簡單的文本搜索框，可以過濾列表。將以下這行加入到index.html，加在標簽下面：

現在我們要用上 ng-model 指令了。這個指令將文本框綁定到$scope.nameFilter變量，并且確保該變量的值會及時更新。現在讓我們稍微調整下index.html，加上一行ng-repeat指令。

這一行告訴ng-repeat，在輸出數據之前，車手數組先要經過nameFilter的過濾。

此刻就是雙向數據綁定發揮威力的時候了：每次你在搜索框里鍵入一些值的時候，Angular會及時更新$scope.nameFilter的內容。由于綁定是雙向的，所以nameFilter更新的時候，相應的指令(ng-repeat)也會獲得新的數值，然后視圖會立刻更新。

重啟你的應用，看看搜索框。

注意，過濾器會搜索所有屬性中的關鍵詞，包括你不想包括的內容。假設你只想通過Driver.givenName和Driver.familyName過濾：首先，在driversController文件的$scope.driversList = [];下加入這樣一行：

$scope.searchFilter = function (driver) {
    var keyword = new RegExp($scope.filterName, "i");
    return !$scope.filterName || keyword.test(driver.Driver.givenName) || keyword.test(driver.Driver.familyName);
};

現在回到index.html，更新包括ng-repeat的那行：

重新啟動應用，現在你可以通過姓名搜索了。

接下來我們要創建一個車手詳情頁面，當我們點擊車手的時候，我們就可以看到關于他的一些詳細信息。

首先，我們在app.js里加入$routeProvider服務，這個服務將幫助我們處理應用路由。然后我們加入兩個路由：一個轉向錦標賽表格，另一個轉向車手詳情。

angular.module("F1FeederApp", [
  "F1FeederApp.services",
  "F1FeederApp.controllers",
  "ngRoute"
]).
config(["$routeProvider", function($routeProvider) {
  $routeProvider.
    when("/drivers", {templateUrl: "partials/drivers.html", controller: "driversController"}).
    when("/drivers/:id", {templateUrl: "partials/driver.html", controller: "driverController"}).
    otherwise({redirectTo: "/drivers"});
}]);

修改之后，訪問http://domain/#/drivers，這將加載driversController，然后在partials/drivers.html尋找需要渲染的部分視圖。等等！我們好像還沒有部分視圖？我們需要創建他們。

AngularJS允許你將路由綁定到特定的控制器和視圖。不過我們首先需要告訴Angular在哪里渲染這些部分視圖。這需要使用ng-view指令。修改一下你的index.html：

現在，只要是通過應用路由瀏覽，Angular 就會加載相應的視圖，并且
在標簽處渲染。你所需要做的只是創建一個名為partials/drivers.html的文件，然后將錦標賽表格放在那里。同時我們也將將車手的姓名和詳情頁面連接起來。

  
Drivers Championship Standings


  

    
{{$index + 1}}
    

      
      
        {{driver.Driver.givenName}} {{driver.Driver.familyName}}
      
      
    
{{driver.Constructors[0].name}}
    
{{driver.points}}
  

最后，讓我們確定下詳情頁面要展示什么。一個總結了車手相關信息（比如生日、國籍）的頁面，同時包括一個最近成績的表格。在services.js里加入這些：

angular.module("F1FeederApp.services", [])
  .factory("ergastAPIservice", function($http) {

    var ergastAPI = {};

    ergastAPI.getDrivers = function() {
      return $http({
        method: "JSONP", 
        url: "http://ergast.com/api/f1/2013/driverStandings.json?callback=JSON_CALLBACK"
      });
    }

    ergastAPI.getDriverDetails = function(id) {
      return $http({
        method: "JSONP", 
        url: "http://ergast.com/api/f1/2013/drivers/"+ id +"/driverStandings.json?callback=JSON_CALLBACK"
      });
    }

    ergastAPI.getDriverRaces = function(id) {
      return $http({
        method: "JSONP", 
        url: "http://ergast.com/api/f1/2013/drivers/"+ id +"/results.json?callback=JSON_CALLBACK"
      });
    }

    return ergastAPI;
  });

這次我們把車手的ID提供給服務，這樣我們就可以獲取特定車手的信息了。修改一下controllers.js：

angular.module("F1FeederApp.controllers", []).

  /* Drivers controller */
  controller("driversController", function($scope, ergastAPIservice) {
    $scope.nameFilter = null;
    $scope.driversList = [];
    $scope.searchFilter = function (driver) {
        var re = new RegExp($scope.filterName, "i");
        return !$scope.filterName || re.test(driver.Driver.givenName) || re.test(driver.Driver.familyName);
    };

    ergastAPIservice.getDrivers().success(function (response) {
        //Digging into the response to get the relevant data
        $scope.driversList = response.MRData.StandingsTable.StandingsLists[0].DriverStandings;
    });
  }).

  /* Driver controller */
  controller("driverController", function($scope, $routeParams, ergastAPIservice) {
    $scope.id = $routeParams.id;
    $scope.races = [];
    $scope.driver = null;

    ergastAPIservice.getDriverDetails($scope.id).success(function (response) {
        $scope.driver = response.MRData.StandingsTable.StandingsLists[0].DriverStandings[0]; 
    });

    ergastAPIservice.getDriverRaces($scope.id).success(function (response) {
        $scope.races = response.MRData.RaceTable.Races; 
    }); 
  });

值得注意的是我們將$routeParams服務插入了車手控制器。這個服務允許我們使用$routeParams.id訪問URL參數（比如:id）。

現在我們已經有數據了，我們只需要處理一下局部視圖了。創建一個partials/driver.html:

  


    

      

        
Formula 1 2013 Results
      
      

        

          
Round
 
Grand Prix
 
Team
 
Grid
 
Race
        
        

          
{{race.round}}
          
{{race.raceName}}
          
{{race.Results[0].Constructor.name}}
          
{{race.Results[0].grid}}
          
{{race.Results[0].position}}
        
      
    
  

注意這次我們用上了ng-show。只有當你提供的表達式是true的時候，它才會顯示HTML元素。在我們的例子中，只有當控制器加載了車手對象后才會顯示頭像。

加上一些CSS之后，大致是這樣的效果：

現在你的應用已經可以上線了。確認下路由能工作。你可以在index.html加入一個靜態的菜單以加強導航。一切皆有可能。

我們已經介紹了開發一個簡單應用所需的一切。最后別忘了，Angular是一個非常強大的框架。我們只是試了試水而已。以后有機會將向大家展示Angular區別于其他前端MVC框架的特性：可測試性。我們將評測使用Karma編寫和運行測試的過程，介紹持續集成的工具Yeomen、Grunt和Bower，以及Angular的其他優勢。敬請期待。

原文 A Step-by-Step Guide to Your First AngularJS App

編譯 SegmentFault