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
- contrôleurs : L'architecture traditionnelle MVC est remplacée par une architecture réactive à base de composants web.
- 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.
- $scope : Les scopes et l'héritage de scope sont simplifiés et la nécessité d'injecter des $scopes est retirée.
- modules : Les modules AngularJS sont remplacés par les modules natifs d'ES6.
- 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.
- 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
- : 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.
@Componentest 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.- 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.
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".
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
- Tuto Developpez (FR)
- Learn Angular (FR)
- Blog Pierre Terrat (FR)
- Angular-2-training-book.rangle.io: doc complet (EN)
- Alligator.io: blog tuto anglais (EN)
- Blog officiel (EN)
- Blog techniques avancées (EN)
- Best practices (EN)