[教學] angular 官方教學資料導覽

angular 關於官方教學自己做的一個簡短筆記，在官方基本教學流程中，已經給予大家大致的輪廓，到底 angular 怎麼去執行程式流程，進行 html render 以及如何將 html 變成 object，甚至到後面的 route, HttpRequest 取得資料方式

以下把 angular 官方網站提供的基本教學，做一個大致流程導覽，給自己一個簡單的紀錄。

angular 基本教學

http://docs.angularjs.org/tutorial

step-0

這邊進行 angular 第一次接觸，教導如何 install angualr 以及，angular html template 如何進行運作。

Nothing here {{'yet' + '!'}}

網址

http://docs.angularjs.org/tutorial/step_00

ng-repeat step-2

加入 ng-model 了解， angular model 模型，如何使用 ng-model 與 html 進行互動

added
app/js/controller.js

<pre>
function PhoneListCtrl($scope) {
  $scope.phones = [
    {"name": "Nexus S",
     "snippet": "Fast just got faster with Nexus S."},
    {"name": "Motorola XOOM™ with Wi-Fi",
     "snippet": "The Next, Next Generation tablet."},
    {"name": "MOTOROLA XOOM™",
     "snippet": "The Next, Next Generation tablet."}
  ];
}
</pre>

網址

http://docs.angularjs.org/tutorial/step_02

$filter variable step-3, step-4

filter 的使用以及設定方式，使用 html attribute 使用 ng-filter 進行設定，以及和其他 ng-model 進行互動

ng-model tag attribute

從 filter 裡面設定的 searchText 可以對應到 ng-model 層級的資料進行過濾



   Search: 
    
      
Name Phone

        {{friend.name}}
        {{friend.phone}}

Name	Phone
{{friend.name}}	{{friend.phone}}

search

search 是另外一個使用的方式，可以透過 search 進行資料立即過濾以及比對，可以使用 search.attr 進行比對 ng-model 內部的屬性進行比對過濾。


    Any:  

    Name only 

    Phone only 

    
      
Name Phone

        {{friend.name}}
        {{friend.phone}}

Name	Phone
{{friend.name}}	{{friend.phone}}

網址

http://docs.angularjs.org/tutorial/step_03
http://docs.angularjs.org/tutorial/step_04
http://docs.angularjs.org/api/ng.filter:filter
http://docs.angularjs.org/api/ng.filter:orderBy

XHR & DI step-5

接下來開始進行 httpRequest 的部份，也就是大家比較熟悉的 AJAX 在 angular 裡面使用的物件稱為 $http ，這個章節會講解 $http 的使用方法

$http

Shortcut $http(method)

    $http.get('/someUrl').success(successCallback);
    $http.post('/someUrl', data).success(successCallback);

網址

http://docs.angularjs.org/tutorial/step_05
http://docs.angularjs.org/api/ng.$http

templating step-6

template 這邊開始會教導如何使用，如何透過 template 進行資料，屬性編輯，以及 DOM 的使用。
link, href="#/phones/{{phone.id}}"
for image, ng-src="{{phone.imageUrl}}"

<li ng-repeat="phone in phones | filter:query | orderBy:orderProp" class="thumbnail">
    <a href="#/phones/{{phone.id}}" class="thumb">
    <img ng-src="{{phone.imageUrl}}"></a>
    <a href="#/phones/{{phone.id}}">{{phone.name}}</a>
    <p>{{phone.snippet}}</p>
</li>

網址

http://docs.angularjs.org/tutorial/step_06

Route and partial template - step 7

Route 這邊開始進行前端 route 的設定，angular 已經同時在設定 route 之後，可以進行 PJAX (pushstate + AJAX) ，同時進行 template render ，基本操作在 route 的設定之下就可以完成。

angular.module('phonecat', []).

map to

<html lang="en" ng-app="phonecat">

Route setting

config(['$routeProvider', function($routeProvider) {

  $routeProvider.when('/phones', {templateUrl: 'partials/phone-list.html',   controller: PhoneListCtrl}).
  when('/phones/:phoneId', {templateUrl: 'partials/phone-detail.html', controller: PhoneDetailCtrl}).
  otherwise({redirectTo: '/phones'});
}]);

partial HTML data will be inject

<div ng-view></div>

網址

http://docs.angularjs.org/tutorial/step_07

more Templating - step 8

延續前一章節的流程，進行不同 view 更換的流程，同時可以根據 controller 進行 html render。

function PhoneDetailCtrl($scope, $routeParams, $http) {
    $http.get('phones/' + $routeParams.phoneId + '.json').success(function(data) {
        $scope.phone = data;
    });
}

Filter - step9

主要目的介紹 module 寫法，目標是自訂一個 filter ，前面是 angular 預設的 filter ，這邊介紹 angular module 寫法，進行 filter 的訂定。
Custom Filter

angular.module('phonecatFilters', []).filter('checkmark', function() {
    return function(input) {
        return input ? '\u2713' : '\u2718';
    };
});

app.js

angular.module('phonecat', ['phonecatFilters']).

html filter

<dl>
  <dt>Infrared</dt>
  <dd>{{phone.connectivity.infrared | checkmark}}</dd>
  <dt>GPS</dt>
  <dd>{{phone.connectivity.gps | checkmark}}</dd>
</dl>

$scope and Event handlers - step10

透過 $scope 可以在 html 中取得 function，又或者是 html 屬性也可以在 $scope 裡面取得對應資料。
in function, append a function to $scope

$scope.mainImageUrl = data.images

$scope.setImage = function(imageUrl) {
    $scope.mainImageUrl = imageUrl;
}

it will change mainImageUrl

<img ng-src="{{mainImageUrl}}" class="phone">

<img ng-src="{{img}}" ng-click="setImage(img)">

$service - step11

$resource ，用來訂定 RESTful service ，當每次程式都需要執行 $http 就會覺得重複的步驟太過冗長，因此可以採用 $resource 進行 RESTful service 訂定發送 AJAX。
need lib/angular/angular-resource.js

angular.module('phonecatServices', ['ngResource']).
factory('Phone', function($resource){
  return $resource('phones/:phoneId.json', {}, {
    query: {method:'GET', params:{phoneId:'phones'}, isArray:true}
  });
});

app/js/controllers.js. auto query method

function PhoneListCtrl($scope, Phone) {
  $scope.phones = Phone.query();
  $scope.orderProp = 'age';
}

build a Phone data object to instead of $http method.

$scope.phone = Phone.get({phoneId: $routeParams.phoneId}, function(phone) {
    $scope.mainImageUrl = phone.images[0];
});

後記

此篇文章給予初入門的朋友，也是給自己在整個流程後的隨手筆記及大綱提要，等到哪天需要回過頭來繼續開發 angular 的時候能夠有一個比較簡單參考資料。

以上資料如果有任何謬誤之處，還請各位多多協助修改指正。

這邊提一下自己對於 angular 的感想，angular 一開始入門看似容易，可是開始實作之後有許多必須要了解的基礎，才有辦法融會貫通，不然很容易造成遇到問題不得其解的狀況。特別是對於只有寫過 jQuery 的新手來說，會更為難以思考為什麼會有這種情況，為何 DI 還有變數可以自動帶入的魔法。

另外一提 angular 在 html & js 的情況下定位的更為複雜，讓初轉型 Front end 的人有個謬誤，到底是要將 method 寫在 html attribute 裡面比較好？還是 html & js 分離的架構比較容易懂？

在這邊 angular 定位於 web application，個人對於 angular 定下的 ng-app 以下都可以稱為是 web application skeleton ，可以視為是 angular 物件，與 js 並做太多抽離，只是另外一種呈現的方式而已，或許這樣說對於初學者很抽象，但是它就是如此。

熱血漢誌 - 技術新鮮人到技術經理人，必懂的事

搜尋此網誌