Angular

Introduction

Description

Angular désigne le "nouvel" Angular (version 2 et supérieure), et AngularJS désigne la version 1 de cet outil.

Dans Angular, les components sont partout : l'application est un Component qui affiche des components contenant des components… Bref, Angular, c'est des components, components et des components !

Angular peuvent être écrit en ES5, ES6, ou TypeScript. TypeScript est recommandé, c'est une surcouche de JavaScript permettant le typage des variables via des annotations (voir TypeScript).

Différences entre AngularJS et Angular

  1. contrôleurs : L'architecture traditionnelle MVC est remplacée par une architecture réactive à base de composants web.
  2. directives : La définition existante de l'objet Directive est retirée, et remplacée par trois nouveaux types de directives à la place: les composants, les directives d'attributs et les directives structurelles.
  3. $scope : Les scopes et l'héritage de scope sont simplifiés et la nécessité d'injecter des $scopes est retirée.
  4. modules : Les modules AngularJS sont remplacés par les modules natifs d'ES6.
  5. jQLite : Cette version plus légère de jQuery était utilisé dans AngularJS. Elle est retirée dans Angular, principalement pour des raisons de performance.
  6. two-way data-binding : Pour les même raisons de performances, cette fonctionnalité n'est pas disponible de base. Cependant, et il est toujours possible d'implémenter ce mécanisme avec Angular.

Elements de bases d'Angular

Nous allons voir quatre éléments à la base de toute application Angular :

  • Le Module
  • Le Composant. (ou 'Component' en anglais)
  • Le Template.
  • Les métadonnées. (ou annotation)

Installation

Angular-cli permet de créer un nouveau projet à l'aide d'une seule commande.

# Installer angular-cli en global
npm install --g @angular/cli@lastest

# Créer un nouveau projet
ng new my-app

# Lance le serveur de l'application
cd my-app
ng serve --open

Après création on retrouve à la racine du projet :

  • package.json : fichier déclarant les dépendances NPM tirées lors de l'installation du projet et nécessaire à la compilation et les tests.
  • .editorconfig : ce fichier est issu du projet EditorConfig. Il a pour but de maintenir une cohérence dans le code entre l'ensemble des éditeurs et IDE du marché. Le fichier fonctionne nativement sur certains éditeurs alors qu'un plugin sera nécessaire pour d'autres. Très peu d'éditeurs/IDE ne connaissent pas ce fichier ; c'est donc un standard de fait.
  • README.md : fichier de présentation du projet au format Markdown utilisé notamment sur Github.
  • .gitignore : fichier permettant de déclarer les fichiers qui ne doivent pas être commités sur le repository Git.
  • karma.conf.js : fichier de paramétrage du Test runner Karma. Karma est un outil permettant de lancer des tests sur une série de browser/device automatiquement. Il est déjà configuré pour être lancé sur le navigateur Chrome avec le framework de test Jasmine.
  • protractor.conf.js : fichier de paramétrage de l'outil de e2e Protractor. E2E, ou end-to-end, est une discipline permettant de réaliser des tests d'intégration ; il est ainsi possible de réaliser des tests simulant un utilisateur final utilisant l'application dans un browser type Chrome.
  • tslint.json : fichier définissant les règles de codage TypeScript. Tout comme le fichier .editorconfig, il est reconnu par la majorité des éditeurs de code.
  • .angular-cli.json : fichier de paramétrage central utilisé par Angular CLI. Ce fichier permet de définir où sont placées les sources de l'application, les différents fichiers de configuration, les scripts js et css tiers… Ce fichier est largement utilisé par la librairie webpack nouvellement ajoutée à Angular CLI.
  • src : à la racine du répertoire src, on retrouve les fichiers classiques index.html, favicon.ico, styles.css, mais également le main.ts (bootstrap d'Angular 2), le fichier de configuration de la compilation TypeScript tsconfig.json, un fichier de définition TypeScrit typings.d.ts, et un ensemble de polyfills utiles à Angular 2.
    • src/app : on retrouve les sources de notre premier projet, dont notre nouveau component : AppComponent.
    • src/assets : cet espace permet d'y placer tous les assets tels que les images. Lors de la compilation de l'application via Angular CLI, un dossier dist va être créé. Le contenu de ce dossier sera placé à la racine de dist.
    • src/environments : on retrouve les différents fichiers de configuration spécifiques aux environnements d’exécution.
    • src/environments : les fichiers contenus dans ce dossier permettent de définir les variables spécifiques à chaque environnement d'exécution (prod, dev, integration). Par défaut, l'environnement de dev sera utilisé (fichier environment.ts). Si l'on souhaite utiliser le fichier de production, il est nécessaire d'ajouter le paramètre -env=prod lors de l'appel de la commande ng build.

Migrer entre les versions Angular

https://update.angular.io/


Module

Un module est une brique de votre application, qui une fois assemblée avec d'autres briques, forme une application à part entière. Chaque module est dédié à une fonctionnalité particulière.

The module is a container for the different parts of an application.

Angular utilise System.js (module loader), cet outil s'occupe pour nous de charger les modules et leurs dépendances :

import { Component } from ‘@angular/core’ ; // @angular/core est un module Angular
import { MaClasse } from ‘./ce-dossier’ ;

Component

Conception des Web components

Depuis la finalisation de HTML5 (octobre 2014), les développeurs peuvent créer des composants graphiques réutilisables et totalement indépendants : Les Web components.

Pour y parvenir, plusieurs technologies du W3C sont utilisées :

  • Customs Elements : API permettant de déclarer de nouveaux éléments HTML et utiliser des lifecycle callbacks (création, modification, suppression).
  • HTML imports : permettent d’importer des fichiers HTML dans un autre.
  • HTML templates : permettent de charger une portion de HTML sans l’afficher tout de suite.
  • Shadow DOM : permet d'isoler plus facilement les composants entre eux via un système d’encapsulation. Angular utilise sa propre méthode, Emulated, qui simule le fonctionnement du Shadow DOM mais fonctionne sur tous les navigateurs.

Création d'un composant Angular

Avec l'angular-cli, on peut créer un composant à l'aide d'une seule commande :

ng g component my-new-component

Ce qui créé un ficher TypeScript my-new-component.component.ts dans /app :

# 1. Importation des modules
import { Component } from '@angular/core';

# 2. Décorateur 
@Component({
    selector: 'mon-premier-component',
    template: `
        <h2>Mon premier Component</h2>
        <img src="http://gabarit.developpez.be/images/logo.png" />
    `
})

# 3. Class du composant
export class MonPremierComponent  {
}

Composition d'un fichier d'un composant

  1. : Un espace réservé aux importations d'autres modules. Dans notre exemple, cet espace nous sert à charger la classe « Component » du module @angular/core qui n'est autre que le module « cœur » d'Angular.
  2. @Component est un décorateur. Pour @Component, les deux paramètres de configuration obligatoires sont selector (le Custom Element W3C) et template ou templateUrl (l'Import HTML W3C). Angular en a besoin pour lier le composant et son template.
  3. Une classe qui contrôle l'apparence et le comportement de notre Component. Cette classe est exportée pour pouvoir être utilisée par l'application et interagir avec la vue à travers un ensemble de propriétés et de méthodes.
ⓘ La notion de classe est une notion qui existe nativement en JavaScript depuis l'ES6.
ⓘ Il est recommandé de suffixer le nom des class composants par 'Component'. Plus facile de s'y retrouver quand il y a des classes de services, de modèles, ...

Utilisation du composant créé

Une fois le composant créé, il suffit de déclarer une balise HTML avec le nom du selector qui a été défini lors de la création du @Component.

<my-new-component>Loading...</my-new-component>

Template

C'est simplement une "vue", associée à un composant. Il contient du HTML et une forme de HTML spéciale qui dit à Angular ce que doit afficher le composant.

Expressions

AngularJS expressions sont écrites avec les doubles acccolades : {{ expression }}

ou dans la balise avec l'attribut ng-bind : ng-bind="expression".

ⓘ Utiliser data-ng-, à la place de ng-, pour que la page soit valide en HTML5.

https://blog.thoughtram.io/angular/2016/02/22/angular-2-change-detection-explained.html


Décorateur / Annotation

Les décorateurs sont issus du langage TypeScript. Ils permettent de rajouter un ensemble de propriétés à une classe et ses membres. Cet ensemble s'appelle les MetaDatas.

Le nom du décorateur indique à Angular comment il doit traiter la classe et ainsi différencier les class de composant, service ou modèle.

Tous les décorateurs sont préfixés par @.

@Component({
  selector: 'mon-app',
  template: '<p>Ici le template de mon composant</p>'
})

Il existe d'autres annotations : @Injectable, @Input ou encore @Pipe.

Les annotations ont souvent besoin d'un paramètre de configuration, un object qui contient les informations dont Angular.

Pour @Component les deux paramètres obligatoires lorsque vous définissez un composant sont selector et template. Angular en a besoin pour lier le composant et son template.

https://blog.thoughtram.io/angular/2015/05/03/the-difference-between-annotations-and-decorators.html


Observables

Promises + event

Liste des opérateurs sur Observable

https://blog.thoughtram.io/angular/2016/01/06/taking-advantage-of-observables-in-angular2.html


Directives


Modèles


Data-binding


Filtres


Services


Http


Routing


Performance

ChangeDetectionStrategy


Migrer vers la dernière version d'Angular

Pour générer angular.json :

npm install --save-dev @angular/cli@latest
ng update @angular/cli --migrate-only --from=1.7.4

Tuto migration :

- https://update.angular.io/

Librairies Angular

Angular CLI

ng generate

Angular CLI propose de nombreuses commandes pour générer du code (scaffolding). Il est ainsi possible de créer de nouveaux Components, Directives…

SCAFFOLD USAGE
Component ng g component my-new-component
Directive ng g directive my-new-directive
Pipe ng g pipe my-new-pipe
Service ng g service my-new-service
Class ng g class my-new-class
Interface ng g interface my-new-interface
Enum ng g enum my-new-enum
Module ng g module my-module

ng eject

La commande ng eject permet d’extraire la configuration webpack de votre projet et de revenir à un projet beaucoup moins adhérent au Angular CLI. Le fichier package.json sera modifié pour utiliser Webpack de façon directe, ainsi vous avez la main sur la configuration de vos projets.

Angular Materiel / NgBootstrap

Créer un composant Material avec le cli

ng generate @angular/material:material-nav –name=my-nav

Tutoriels