Pokazywanie postów oznaczonych etykietą ng-click. Pokaż wszystkie posty
Pokazywanie postów oznaczonych etykietą ng-click. Pokaż wszystkie posty

niedziela, 7 października 2012

[HTML|JS|CSS] AngularJS: Event Handlers

Zdarzenia możemy obsługiwać zarówno czystym JavaScriptem, jak i przyjazną biblioteką jQuery, Dlaczego więc korzystać z Angulara ? Ponieważ kilka rzeczy otrzymujemy za darmo. Po pierwsze w sposób deklaratywny w widoku możemy wpisać wyrażenia, które będą ewaluowane, gdy dane zdarzenie będzie miało miejsce. Można też oczywiście przekazać callback, który będzie odpowiednią funkcją z kontrolera. Przykład poniżej.

<!doctype html>
<html ng-app>
<head>
<meta charset="utf-8">
 <script src="http://ajax.googleapis.com/ajax/libs/angularjs/1.0.2/angular.min.js"></script>
 <script src="scripts/myscript.js"></script>
</head>
<body ng-controller="eventsController"> 
 <div ng-click="counter = counter + 1">click test</div>
 <div ng-click="clicks()">display</div>
 <div ng-mousemove="mouse = mouse + 1"
  ng-mouseout ="display()">here move mouse</div>
</body>
</html>

Cały kod po stronie kontrolera to inicjalizacja zmiennych i deklaracja funkcji.

function eventsController($scope){
 $scope.counter = 0;
 $scope.mouse = 0;
 $scope.clicks = function(e){
  console.log('clicks  ' + $scope.counter);
 }
 $scope.display = function(e){
  console.log('mouse moves ' + $scope.mouse);
  $scope.mouse = 0;
 }
}

Zdarzenia AngularJS wywoływane są w kontekście danego scope, dlatego jeśli w danym zdarzeniu chcemy modyfikować model DOM, to zostanie on automatycznie odświeżony. Korzystając z innych bibliotek w połączeniu z Angularem nie mamy tego konfortu i należy wykorzystywać instrukcję $scope.$apply do automatycznego odświeżenia UI. Poniżej porównanie równoważnych funkcjonalnie handlerów w jQuery i AngularJS.

<body ng-controller="eventsController"> 
 <div ng-click="add()">add element </div>
 <div id="add">add element (bind) </div>
 <ul>
  <li ng-repeat="n in numbers">{{n}}</li>
 </ul>
</body>

function eventsController($scope){
 $scope.numbers = [1,2];
 $scope.add = function(e){
  $scope.numbers.push($scope.counter);
 }

 $('#add').click(function(e){
  $scope.$apply($scope.numbers.push($scope.counter));
 })
}

Ostatnią przydatną funkcjonalnością dotyczącą zdarzeń jest możliwość ich propagacji w górę lub w dół drzewa DOM. Służą do tego odpowiednio funkcje $emit oraz $broadcast. 

<div ng-click="$broadcast('myevent')">
 Click to broadcast down, emittedEvents: {{outerEvents}}
 <div ng-controller="innerController">
  <div ng-click="$emit('myevent2')">
   Emit up, broadcastedEvents: {{innerEvents}}
  </div>
 </div>
</div>

Obsługa w kontrolerze wykonywana jest dzięki instrukcji $on.

function eventsController($scope){
 $scope.outerEvents = 0;
 $scope.$on('myevent2', function() {
  $scope.outerEvents++;
 });
}

function innerController($scope){
  $scope.innerEvents = 0;
  $scope.$on('myevent', function() {
  $scope.innerEvents++;
 });
}

wtorek, 25 września 2012

[HTML|JS|CSS] AngularJS: Templates

Poniewż aplikacje tworzone w AngularJS powinny wykorzystywać wzorzec MVC, należy wydzielić komponenty widoku, kontrolera oraz modelu danych. Za widok odpowiada szablon html, który zostaje przekompilowany do ostatecznej postaci za pomocą dyrektyw biblioteki. Kontrolerem będzie funkcja w pliku .js, natomiast model danych zostanie zaaplikowany do obiektu $scope.

Przykładowy widok poniżej prezentuje działanie dyrektyw ng-repeat, ng-controller oraz ng-click.

<body ng-controller="CountriesController"> 
<ul>
   <li ng-repeat="country in countries">
      <div>
 <span>
 Name : <strong>{{country.name}}</strong>
 </span>
 <span>
 Capital City : <strong>{{country.capital}}</strong>
 </span>
      </div>
   </li>
</ul>
<p> Total countries in Benelux : {{countries.length}} </p>
<button ng-click="removeLast()">Remove last item</button> 
</body>

Aby wykonać data-binding, należy podać nazwę kontrolera, za pomocą atrybutu ng-controller umieszczanego wewnątrz tagu body. AngularJS po napotkaniu takiej dyrektywy zacznie poszukiwanie funkcji o identycznej nazwie w plikach js. Kolejna instrukcja to ng-repeat, czyli odpowiednik pętli foreach z języka C#, Umożliwia ona binding do kolekcji obiektów i stworzenie szablonu dla pojedynczego obiektu. Za pomocą ng-click, możemy podać jaka akcja ma się wykonać po kliknięciu w element. W powyższym przykładzie będzie to funkcja removeLast zdefiniowana w kontrolerze.

//funkcja konstruktora dla country
var Country = function(name,capital)
{
 this.name = name;
 this.capital = capital;
}

function CountriesController($scope) {
 $scope.countries = [
  new Country("Netherlands","The Hague"),
  new Country("Belgium","Brussels"),
  new Country("Luxembourg","Luxembourg")
  ];
 $scope.removeLast = function(){
  var index = $scope.countries.length - 1;
  $scope.countries.splice(index, 1);
 }
} 

Funkcja kontrolera wywoływana z parametrem $scope, definiuje model danych oraz zachowania poprzez odpowiednie funkcje. Zmiany przeprowadzane na kolekcji (np. usunięcie elementu), spowodują natychmiastowe odświeżenie widoku.

Kolejną prostą do dodania funkcjonalnością jest przeszukiwanie pełno-tekstowe (Full Text Search), które nie korzysta w żaden sposób z kontrolera (!).
Aby móc przeszukiwać kolekcję, do której wpięliśmy data-binding, należy zmodyfikować ng-repeat o dyrektywę filtru.

<li ng-repeat="country in countries | filter:query">

Dodatkowo wystarczy dodać element input, do którego użytkownik będzie mógł wpisać swoje zapytanie.

<input type="text" ng-model="query">

W przypadku kolekcji obiektów przeszukane zostaną wszystkie properties i element zostanie zwrócony, jeżeli jakakolwiek zawiera podaną przez użytkownika frazę.

Aby zastosować binding w dwie strony, wystarczy dodać property query do elementu $scope w kontrolerze. Dzięki temu możemy na przykład wypisywać i resetować zapytanie.
<label>{{query}}</label>
<!-- ... -->
<button ng-click="resetQuery()">Reset query</button> 

function CountriesController($scope) {
 $scope.query = '';
 $scope.resetQuery = function(){
  $scope.query = '';
 }
} 

Binding automatycznie odświeży zarówno UI, jak i filtr wyszukiwania.