I. Mémo Angular

Bienvenue sur le mémorandum du framework Angular de Google.

Version Angular : 10+
Version tutoriel : 1.46

II. Objectif de ce tutoriel

  • Ce tutoriel est sous la forme d'un mémo présentant les chapitres les plus importants du framework Angular.
  • Chaque chapitre est composé de codes sources agrémentés de diverses explications et points-clés à connaitre.
  • Ce mémo est destiné aux développeurs Angular débutants et aussi confirmés.
  • Connaissances prérequises :

    • TypeScript : débutant ;
    • Angular : débutant.

III. Angular

  • Angular est un framework JavaScript complet, il dispose de tous les outils nécessaires pour développer rapidement une application web dynamique de n'importe quelle taille.

IV. Les types d'applications que l'on peut créer

  • Single Page App (SPA) :

    • développer des sites web dynamiques, en front. On appelle cela le SPA ;
    • le navigateur du client exécute le code JavaScript et fait tourner l'application de façon dynamique, et ce, sur une seule page web.
  • Applications hybrides pour smartphone :

    • développer des applications hybrides pour smartphone avec Ionic 4 ou encore Angular for NativeScript.
  • Progressive Web Apps (PWA) :

    • on peut concevoir des PWA (Progressive web App), des applications de bureau ou smartphone qui ont l'avantage de se baser sur une URL pour être installée (avec sa petite icône de lancement) ;
    • et donc, pas besoin d'un système de store pour distribuer ces applications PWA.
  • Composants web :

    • des composants web qui peuvent être utilisés dans n'importe quels autres projets ou technologies web.

V. Les technologies qui composent le framework

  • Angular Universal et le Server-side rendering (SSR) :

  • Angular elements - Composant web réutilisable :

    • https://angular.io/guide/elements ;
    • il est possible de développer des composants graphiques (comme des widgets) afin de les intégrer dans un site web classique HTML, et ce, avec une simple balise ;
    • et donc, chaque composant contenu dans un seul fichier JS de quelques Ko contiendra tout le nécessaire (html, css, JS) pour un fonctionnement autonome dans une page web HTML quelconque.
  • Lazy loading :

    • le chargement différé : une partie d'un projet se charge quand l'utilisateur veut y accéder ;
    • une fois chargé, c'est mis en cache automatiquement ;
    • utile pour réduire le temps de chargement des gros projets ;
    • chargement rapide de la 1re page.
  • Packages Angular :

    • Angular propose divers packages aux développeurs (boîte à outils) pour aider à développer plus rapidement ;
    • ainsi, les principaux packages (librairies) disponibles sont sur les domaines suivants : Formulaires, Routing, HTTP, Tests…
  • angular-cli :

    • toute une série de commandes afin d'accélérer et faciliter le développement ;
    • https://cli.angular.io/ ;
    • dans une console, des commandes pour créer un projet, compiler, exécuter… ;
    • mais aussi d'autres commandes pour créer des fichiers de code (créer le squelette d'un composant, d'un service, d'un module, d'un fichier routing…) ;
    • live reload :

      • dans un projet, à chaque enregistrement de n'importe quel fichier (suite à une modification du code), le live-reload recompile automatiquement la partie modifiée et rafraichit automatiquement le navigateur.
  • Compilation AOT (Ahead of Time)

    • optimise le code (supprime le code inutilisé)
  • Environnements

    • plusieurs environnements : dev, prod…
  • La documentation officielle :

  • Côté développement, c'est :

    • la possibilité d'intégrer n'importe quelle librairie externe JavaScript pour pouvoir l'utiliser ;
    • utilise le Modèle Vue Contrôleur (MVC) pour la séparation des responsabilités. Plus précisément, c'est du MVVM :

      • MVC (Model-View-Controller) : le contrôleur manipule le modèle, la vue affiche le modèle,
      • MVVM (Model-View-ViewModel) : le modèle MVVM prend en charge la liaison de données bidirectionnelle entre View et ViewModel. Cela permet la propagation automatique de changement de ViewModel vers la vue ;
    • avec son architecture orientée MVC, on a l'avantage de l'homogénéité entre les projets ce qui apporte une grande maintenabilité ;
    • utilise l'injection de dépendances (DI) pour faciliter l'accès aux diverses librairies pour les composants ou pour les services d'un projet.

VI. L'ensemble des technologies qui gravitent autour d'Angular

  • Scully :

    • https://scully.io/ ;
    • Angular Universal permet du SSR ;
    • avec Scully, vous pouvez faire du SSG, c'est-à-dire du prérendu des pages pour plus de performances et la prise en compte du SEO ;
    • l'inconvénient du SSG c'est que seules les pages statiques seront référencées contrairement au SSR où en plus les pages dynamiques seront référencées ;
    • pour un site web statique, utilisez plutôt le SSG (avec Scully) sinon le SSR (avec Angular universal) :
  • TypeScript :

    • Angular utilise par défaut le langage TypeScript de Microsoft (JavaScript ES6, légèrement remanié) ;
    • ce qu'apporte TypeScript :

      • ajoute du typage fort,
      • ajoute la détection d'erreurs à la compilation (et non plus seulement à l'exécution comme avec JavaScript),
      • fournit les features qui sont dans ES6 et dans ES5 et a donc bien souvent une avance,
      • de façon générale, syntaxiquement, il y a peu de différences entre ES6 et TypeScript ,
      • le compilateur de TypeScript n'ajoute aucune dépendance à JavaScript,
      • le code JavaScript généré par TypeScript est d'une grande qualité,
      • en plein développement d'un projet, vous pouvez passer de TypeScript à ES6 sans problème.
  • Redux pour Angular (NgRx):

    • https://ngrx.io/ ;
    • NgRx se présente comme un système de centralisation des données et des actions ;
    • à savoir qu'on peut se passer de redux sur Angular parce que le framework Angular propose un mécanisme de communication le « two way data binding » que l'on associe à un service qui peut être utilisé comme store de données.
    • une alternative : ngxs est une version de redux pour angular basé sur le modèle CQRS https://www.ngxs.io/;
    • une autre alternative : Akita (que je recommande) est un système très simple de gestion de l'état https://datorama.github.io/akita/;
  • RXJS - La programmation réactive :

    • https://angular.io/guide/rx-library ;
    • le concept de RXJS repose sur l'émission de données depuis une ou plusieurs sources (producteurs) à destination d'autres éléments appelés consommateurs ;
    • elle repose sur le design pattern : Observable / Observer.
  • Webpack :

    • c'est le gestionnaire de ressources (CSS, images…) qui est intégré dans Angular.
  • Les tests unitaires :

    • Jasmine & Karma.
  • Bibliothèque CSS et de mise en page :

  • ngx ROCKET :

VII. Fonctionnement du framework

  • Le cœur d'Angular : les composants web :

    • Angular est un framework basé sur les composants web ;
    • principe : on imbrique les composants web les uns avec les autres pour construire un widget, une fonctionnalité, une page, un projet…
  • Les versions :

    • Google met à jour le framework tous les 6 mois,
    • mais n'ayez crainte, de version en version c'est compatible ;
  • Angular et l'apprentissage :

    • Angular est un framework complet donc il faut un certain temps pour le maitriser, mais c'est le cas pour n'importe quel autre framework quand on veut aborder tous les sujets.
  • Comment fonctionne techniquement la mise à jour dynamique sur Angular :

    • Angular 10+ fonctionne avec le nouveau moteur ivy qui utilise la technique de «l'Incremental DOM» ;
    • Incremental DOM : chaque composant est compilé dans une série d'instructions. Ces instructions créent des arborescences DOM et les mettent à jour sur place lorsque les données changent.

VIII. Angular : ce qu'il faut pour démarrer

  • node.js :

    • https://nodejs.org/en/ ;
    • installer node.js (de préférence, la version LTS) ;
    • npm est la commande de node.js dans une console ;
    • pour connaitre la version de npm installé sur votre système :
      npm -v
    • pourquoi node.js ?

      • quand vous allez installer node.js sur votre système d'exploitation celui-ci va installer un dossier : «node_modules»,
      • ce dossier est en quelque sorte le dossier global qui contiendra tous les modules nécessaires (du code, des outils…) pour faire fonctionner diverses applications,
      • par exemple, angular-cli est un module qui se retrouve dans ce dossier node_modules, car il ne doit pas faire partie d'un quelconque projet Angular mais être disponible pour tous les projets Angular ;
    • Remarques

      • Vous remarquerez qu'un projet Angular dispose aussi d'un dossier  node_modules, qui n'a rien à voir avec celui en global. Ce dossier est réservé uniquement aux packages utiles au bon fonctionnement du projet en question ;
      • par exemple dans un projet, on peut avoir besoin un package de conversion HTML en PDF et donc nous allons mettre ce package dans  ./node_modules du projet ,
      • il y a donc le dossier node_modules global installé sur le système et le dossier  node_modules d'un projet.
  • Installation d'angular-cli :

    • https://cli.angular.io/ ;
    • angular CLI permet de lancer des commandes en ligne (via la commande ng) pour effectuer diverses tâches comme :

      • créer un projet Angular,
      • compiler et lancer un projet,
      • ajouter au projet des squelettes de fichiers de types : composants, directives, services, modules, pipes, interfaces…
    • nous voulons utiliser angular-cli pour tous nos projets Angular, donc nous allons l'installer en global ;
    • pratique :
      npm install -g @angular/cli
    • remarque :

      • « -g » pour indiquer de mettre le package en global (le dossier node_modules du système d'exploitation) ;
    • pour connaitre la version d'angular CLI installée sur son système :
      ng version

IX. Quelques outils pour développer

  • Éditeur de code :

    • https://code.visualstudio.com/ ;
    • je recommande Visual Studio Code de Microsoft qui est gratuit ;
    • installer une extension à VS pour mieux prendre en compte Angular et typeScript
 
Sélectionnez
1.
2.
3.
4.
5.
fichier -> preferences -> extensions

en haut à gauche, dans la barre de recherche: EXTENSIONS
tapez : angular
choisissez´: Angular Essentials (Version 9) et cliquez sur le bouton  installer
  • Éditeur de code online :

    • https://stackblitz.com ;
    • un éditeur basé sur un navigateur ;
    • cela permet de tester rapidement une idée, partager des démos, une application complète, des extraits de code, ou écrire du code lorsque vous êtes loin de votre propre machine ;
    • utile aussi pour partager le code sur un forum d'entraide.
  • Developer Tool pour navigateur (Google Chrome ou Mozilla Firefox) :

X. Description des fichiers d'un projet Angular

  • Créer un projet que l'on nommera :
    angular-skeleton1
 
Sélectionnez
1.
2.
3.
4.
ng new angular-skeleton1
strict ? NO
routing ? YES
SCSS

cd angular-skeleton1

X-A. Description du dossier angular-skeleton1

/angular-skeleton1

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
/dist                           // dossier contenant les sources pour le déploiement (qui a été généré avec la commande ng build --prod)
/e2e                            // stock des scripts pour effectuer des tests unitaires
/node_modules                   // tous les plugins node.js qui ont été installés via npm (packages Angular et des packages utiles pour notre projet que l'on installe)
/src     
    /app                        // app est le premier composant, Angular démarre sur celui-ci
        app.component.scss      // le CSS appliqué uniquement à ce composant : app.component.html
        app.component.html      // Le V de MVC (la vue)
        app.component.ts        // Le C de MVC  (similaire à un contrôleur)
        app.component.spec.ts   // fichier pour les tests (peut être supprimé si on ne fait pas de test)
        app.module.ts           // le module (import de librairies et configuration pour le bon fonctionnement du composant app)
        app-routing.module.ts   // le module pour la gestion du routing (correspondance URL / composant)
    /assets             // les ressources : images...
    /environments       // environnements d’exécution : prod, dev ou test...
    browserslist   
    favicon.ico  
    index.html          // le fichier de démarrage qui sera chargé par le navigateur du client
    karma.conf.js       // fichier de paramétrage du Test runner Karma (les tests unitaires)
    main.ts             // contient l'ensemble du projet en typescript
    polyfills.ts        // normalisation entre les différents navigateurs
    styles.scss         // le CSS global qui sera accessible à tous les composants
    test.ts    
    tsconfig.app.json   // configuration typescript
    tsconfig.spec.json
    tslint.json         // règles d'écriture du code typescript
.gitignore              // les fichiers et dossiers à ignorer pour GIT
angular.json            // fichier de configuration utilisé par Angular CLI
package.json            // en lien avec le dossier /node_modules - liste les dépendances npm
package-lock.json       // en lien avec le dossier /node_modules - liste les versions exactes des dépendances - 'npm install' se base sur ce fichier
README.md               // présentation du projet en markdown pour github
tsconfig.json           // fichier de configuration pour le compilateur de TypeScript
tslint.json             // les règles de codage TypeScript
                        // permet de vérifier les fichiers TypeScript

X-B. Plus qu'à lancer :

ng serve

ou en lançant automatiquement le projet sur le navigateur par défaut

ng serve -o

http://localhost:4200/

Welcome to angular-skeleton1!

X-C. Le point de départ

/src/index.html

 
Sélectionnez
1.
2.
3.
...
<app-root></app-root>               
...
  • le fichier index.html est l'unique page que le navigateur chargera ;
  • ce fichier contient une balise : <app-root></app-root> ;
  • c'est dans cette balise qu'est projetée toute l'application Angular

/src/app
Dans ce dossier, il y a le composant racine : app.component… (css, html, ts)
Et son module : app.module.ts

 
Sélectionnez
1.
2.
index.html        <app-root></app-root>                   // est la balise qui représente le composant racine  /app/app.component.html
                                                          // ne jamais modifier le fichier index.html

/src/app/app.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
import { Component } from '@angular/core';

@Component({                                        // un décorateur '@Component', qui permet de configurer la classe AppComponent.ts avec selector, templateUrl et styleUrls
    selector: 'app-root',                           // le nom du sélecteur: 'app-root'      --> le même nom qu'on retrouve comme balise dans le fichier:  /src/index.html -> <app-root></app-root>
    templateUrl: './app.component.html',            // indication de la vue associée 
    styleUrls: ['./app.component.scss']              // indication du fichier CSS (qui sera appliqué uniquement à app.component.html)
})
export class AppComponent {
    title = 'angular-skeleton1';                    // déclarer une variable title 
                                                    // qui sera uniquement disponible dans la vue app.component.html
}

/src/app/app.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
...
<h1>Welcome to {{ title }}!</h1>

<router-outlet></router-outlet>   // facultatif, mais doit être présent pour du routing
                                  // toutes pages du routing seront projetées ici

// {{ title }} sera remplacé par le texte de la variable : title = 'angular-tuto1';

X-D. Principe

  • on déclare une variable dans le : …component.ts et on l'affiche dans sa vue : …component.html

X-E. Conclusion

  • app.component.ts est le composant racine et il lui est associé son module racine  app.module.ts. L'ensemble représente le point de départ d'un projet.
  • index.html est l'unique page qui sera chargée. Ensuite, le projet fonctionnera de façon dynamique.
  • index.html contient la balise  <app-root></app-root>, le sélecteur où est projeté le composant racine  app.component.

X-E-1. Schéma

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
  index.html                      // la seule page qui sera chargée par le navigateur
    -------------------------
      <app-root></app-root>           // dans cette balise sera projeté le projet Angular compilé en JavaScript (1) 
      ...                             // en quelque sorte, c'est : app.module qui est le module de démarrage, 
                                      // celui qui va contenir tous les autres composants web
      ...
      ...
      ...
      <script src="main.js">...       (1) contient tout le projet Angular compilé en JavaScript
    -------------------------

X-F. Remarques

  • Depuis la version 10 d'Angular, pour économiser des Ko, la spécification ES5 n'est plus prise en compte donc ça ne tournera plus sur IE11 (mais il est possible de le prendre en compte).
  • Nous verrons plus loin, comment organiser un projet avec ses modules, composants…

XI. Théorie sur les modules

Un peu de théorie sur les modules pour vous mettre un peu le concept dans la tête avant d'aller plus loin.

  • IMPORTANT : il faut diviser un projet en plusieurs modules de fonctionnalités.
  • En principe, un module = une fonctionnalité.

XI-A. À savoir

  • app.module a pour seule fonctionnalité : le « point de démarrage ».

XI-A-1. Description d'un module Angular

  • Le module racine : app.module.ts représente le contexte de démarrage de l'application et ne dispose que d'un seul composant : app.component

/src/app/app.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';

@NgModule({
  declarations: [               // *1
    AppComponent,                    
  ],
  imports: [                    // *2
    BrowserModule,                              // BrowserModule :    le composant racine s'exécutera dans un navigateur
  ],
  exports: [                    // *3

  ],
  providers: [                  // *4

  ],                
  bootstrap: [AppComponent]     // **5          // à indiquer uniquement dans le module racine : app.module.ts
})
export class AppModule { }
 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
en général, voici les tâches que l'on peut faire dans un module:

*1      déclarer tous les composants que l'on a besoin d'utiliser       
*2      importer d'autres modules provenant de son propre projet ou provenant de sources externes comme celui d'un package npm (dossier /node_modules du projet)  
        ici on importe le package BrowserModule, car Angular va s'exécuter dans un navigateur  
*3      indiquer ici les composants web qui doivent être accessibles lors d'un import de ce module         
*4      c'est ici qu'on déclare nos services pour qu'ils soient disponibles dans nos composants 
**5     uniquement présent dans le module racine.
          - Dans 'bootstrap', on doit indiquer quel composant est le point d'entrée 
          - rappel:  app.component.ts est le 1er composant projeté dans la balise : <app-root></app-root> du fichier: index.html

XI-B. Exemple

Le module de démarrage + deux autres modules.

XI-B-1. Schéma

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
app.module.ts (contexte de la fonctionnalité de démarrage)
...........................................................................
|       <app-root></app-root>             <-----  (app.component.html)            
|       _______________________________________________________________        
|                                                                                 
|           functionality1.module.ts    (contexte de la fonctionnalité 1)
|           ...............................................................
|           |   <app-x></app-x>                                           |
|           |   ___________________________                               |
|           |      ...                       <-----  (x.component.html)
|           |   ___________________________
|           |                                                                  
|           |   <app-y></app-y>               
|           |   ___________________________
|           |       ...                       <-----  (y.component.html)   |
|           |   ___________________________                                |                 
|           ................................................................           
|
|           functionality2.module.ts    (contexte de la fonctionnalité 2)
|                                       (package pdf)
|           ................................................................
|           |    <app-z></app-z>                                            |
|           |    ___________________________                                |
|           |       ... utilise pdf            <-----  (z.component.html)
|           |    ___________________________                                |            
|           ................................................................|        
|       _______________________________________________________________            
..............................................................................
  • Le contexte d'exécution de démarrage  app.module.ts est composé de son composant  app.component.ts et de deux modules : functionality1.module.ts et functionality2.module.ts.
  • functionality1.module.ts déclare deux composants : x et y.
  • functionality2.module.ts déclare un composant  z et importe un package externe : pdf.

XI-B-2. Remarques

  • Nous aurions très bien pu mettre tous les composants dans app.module.
  • Dans ce cas, nous aurions eu ça :
 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
app.module.ts (contexte de la fonctionnalité de démarrage)
              (package pdf)
........................................................................
|       <app-root></app-root>             <-----  (app.component.html)  
|       _______________________________________________________________  
|               <app-x></app-x>                                         
|           |   ___________________________                            
|           |      ...                       <-----  (x.component.html)
|           |   ___________________________
|                                                                             
|               <app-y></app-y>               
|           |   ___________________________
|           |       ...                       <-----  (y.component.html
|           |   ___________________________                                            
|                                                                         
|                <app-z></app-z>                                        
|           |    ___________________________                              
|           |       ... utilise pdf           <-----  (z.component.html)
|           |    ___________________________                                             
|       _______________________________________________________________         
........................................................................

problèmes:
- app.module est le module de démarrage donc il n'a pas pour fonction de gérer des composants
- le package pdf est disponible pour tous les composants alors que seul le composant : app-z en a besoin

XI-B-3. Conclusion

  • Un module = une fonctionnalité.
  • Un module est aussi en quelque sorte un contexte d'exécution que l'on paramètre (le contexte d'une fonctionnalité).
  • Un module dispose de certains composants qui s'exécutent dans un contexte.

Mais aussi :

  • dans un projet, on peut avoir plusieurs modules (ou chaque module dispose de ses propres composants et de ses propres packages externes) ;
  • on emboîte les composants entre eux pour former un projet ;
  • les deux grands avantages des modules :

    • rendre les modules (avec ses composants) indépendants les uns des autres,
    • cette indépendance permet de pouvoir réutiliser l'ensemble (module + composants) ailleurs dans un autre projet,
    • réduire en plusieurs modules permet une meilleure maintenance.

Nous verrons plus loin sur les modules dans un autre chapitre.

XI-C. Remarques générales

  • Dans le tutoriel, pour un souci de clarté et pour ne pas complexifier, parfois, je ne respecterai pas la bonne pratique évoquée en haut (de ne pas tout mettre dans app.module).

XII. Les composants web

Les composants web sont un ensemble de normes qui permettent à JavaScript de s'exécuter dans un nœud DOM isolé. De cette façon, vous pouvez créer par programme un widget ou même une application entière. Comme pour tout autre nœud DOM, vous utilisez des événements simples et des attributs / propriétés pour communiquer avec le monde extérieur. Pour le reste de la page HTML, le composant web n'est qu'une simple balise :

  • les composants web sont les briques pour construire une application Angular ;
  • chaque composant est composé de quatre fichiers : .ts, .html, .css. et .spec.ts (test) ;
  • le composant web fonctionne de façon indépendante, il a son propre CSS, son propre contrôleur, son propre template ;
  • on construit l'ensemble d'un projet en emboîtant les composants web.

XII-A. Pratique

Créer un nouveau projet : angular-first-component1

 
Sélectionnez
1.
2.
3.
4.
ng new angular-first-component1
strict ? NO
routing ? NO
SCSS

Pour débuter, on va créer un composant : app-first.component et on va l'ajouter directement dans le module racine  app.module.ts.

XII-A-1. Schéma

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
    app-module (contexte de démarrage)
    ........................................................
        app-root  (app.component.html)
        ______________________________________

              app-first  (first.component.html)
              __________________________
                ...
              __________________________ 
        _______________________________________
    ........................................................

XII-A-2. Remarques

Le composant : app-first cherche son contexte vers le haut. Il cherche d'abord un module dans le dossier sur lequel il se trouve, n'en trouvant pas, il remonte et arrive sur  app-module.module.ts

 
Sélectionnez
1.
2.
3.
app.module.ts
    app.component.ts
      first.component.ts                // le nouveau composant (qui est inclus dans app.component)

Utilisons angular-cli et sa commande : ng

 
Sélectionnez
1.
2.
3.
ng generate component components/first --module=app
// ou la version raccourcie :
ng g c components/first --module=app

// '--module=app' permet d'ajouter automatiquement la déclaration du composant : 'first.component.ts' dans le module  'app.module.ts'.
(Pas besoin de faire cette tâche nous-mêmes à la main, merci angular-cli.)

XII-B. Description

Quatre fichiers ont été créés (first.component…: html, ts, css, spec) et un fichier: 'app.module.ts' a été modifié

 
Sélectionnez
1.
2.
le contrôleur       first.component.ts          // code métier, récupération de données... et fournit des données à la vue  
la vue              first.component.html        // la vue doit se contenter d'afficher les données reçues du contrôleur

XII-B-1. Allons voir :

/app/app.module.ts // le fichier qui a été modifié

 
Sélectionnez
1.
2.
3.
4.
5.
...
  declarations: [
      AppComponent,
      FirstComponent,               // le composant 'first' a bien été ajouté, il peut donc être utilisé 
...

/app/app.component.html // app.component étant le composant de démarrage

 
Sélectionnez
1.
<app-first></app-first>             <!-- on indique l'utilisation du composant: first.component -->

XII-B-2. Remarques

  • Pourquoi la balise avec ce nommage : <app-first> ?
  • Allez voir dans le composant : first.component.ts et regardez la ligne : selector: 'app-first',
  • la balise : <app-first></app-first> correspond au selector : 'app-first'.

XII-C. Allons un peu plus loin avec ce composant

  • Nous allons enrichir le composant en décrivant différentes manières de passer des variables à la vue.
  • Pour cela, on va utiliser un modèle et une classe service dans lesquels on va stocker des valeurs.

XII-C-1. À savoir

  • Un modèle de données est une sorte de contenant permettant de définir certaines valeurs. Dans un projet, on manipule des modèles de données.
  • Un service (provider en anglais), est une classe où l'on met son code métier, pour stocker des valeurs et pour communiquer avec d'autres services ou composants.

XII-D. Le modèle de données

ng g i models/model-x

/models/model-x.ts

 
Sélectionnez
1.
2.
3.
4.
5.
export interface ModelX {
  name: string;             // obligatoire
  firstname: string;        // obligatoire
  job?: string;             // facultatif.   avec ?, 'job' est rendu optionnel
}

XII-D-1. À savoir

  • En programmation orientée objet, une interface permet de donner un comportement à une classe.

XII-E. Les services

  • Un service contient du code métier (propriétés, fonctions).
  • Les composants web utilisent le code métier des services.

XII-E-1. Pratique

Notre composant web : app-first.component va utiliser ce service afin d'y stocker des valeurs

ng g s services/stored1

/services/stored1-service.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
import { Injectable } from '@angular/core';
import { ModelX } from '../models/model-x';

@Injectable({
  providedIn: 'root'            // le service sera une instance singleton de niveau : root c'est-à-dire depuis la racine du projet
})                              // et donc la même instance sera fournie aux composants qui la demandent
export class Stored1Service {

  public storedValue1 = 'texte1 from service';                    // on précise : public donc il sera accessible depuis une autre classe
  storedValue2 = 'texte2 from service';                           // les propriétés sont par défaut en : private
  storedModel1: ModelX = {name: 'shrader', firstname: 'Hank'};    // on précise que storedModel1 est du type: ModelX
                                                                  // remarquez qu'on ne renseigne pas : job, car il est optionnel
  constructor() { }

  getStoredValue2(): string {                                         // les fonctions sont par défaut en : public
    return this.storedValue2;
  }

  getStoredModel1(): ModelX {                                         // : ModelX, pour préciser le type de retour : ModelX
    return this.storedModel1;
  }
}

/app/first.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
<p>first works!</p>
<hr>
<p>(1) variable1={{variable1}}</p>
<p>(2) array1={{array1}}</p>
<p>(3) objet1={{objet1|json}} | objet1.val1={{objet1.val1}} | objet1.val2={{objet1.val2}}</p>
<p>(4) dataObs={{dataObs$|async}}</p>
<hr>
<p>(5) model1={{model1|json}} avec job: model1.job={{model1.job}}</p>
<p>(6) model2={{model2|json}}</p>
<hr>
<p>(7) value1Service={{value1Service}}</p>
<p>(8) value2Service={{value2Service}}</p>
<p>(9) storedModel1={{storedModel1|json}}</p>
<hr>
<p>(10) dataFn1()={{dataFn1()}}</p>
<hr>
<p>(11) privValue= </p>
<hr>
<p>(12) stored2Service.storedValue1={{stored2Service.storedValue1}}</p>
<p>(12) stored2Service.getStoredModel1()={{stored2Service.getStoredModel1()|json}}</p>
<hr>
<p>(13) data2={{data2|json}}</p>

/app/first.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
import { Component, OnDestroy, OnInit } from '@angular/core';
import { Observable, of, Subscription } from 'rxjs';                           //  ne pas oublier d'importer les classes
import { ModelX } from '../../models/model-x';                                 //  que l'on va utiliser dans le composant
import { Stored1Service } from '../../services/stored1.service';               //

@Component({
  selector: 'app-first',
  templateUrl: './first.component.html',
  styleUrls: ['./first.component.scss']
})
export class FirstComponent implements OnInit, OnDestroy {
  // par défaut, les variables et les fonctions du composant sont déclarées en: public
  //
  // public variable1 = 'hello from variable';
  variable1 = 'hello from variable';                                        // (1) une variable
  array1 = [10, 'Breaking bad', 30];                                        // (2) un tableau
  objet1 = {val1: 'Ehrmantraut', val2: 'Mike'};                             // (3) un objet quelconque
  dataObs$: Observable<string> = of('text from observable A');  // (4) avec un observable, la vue souscrit automatiquement à l'observable pour obtenir les données
                                                                //     par convention on met un $ à la fin de la variable pour indiquer que c'est un observable (facultatif)
                                                                //     sachez également que la vue se désabonne automatiquement quand le composant auquel il appartient n'est plus utilisé
                                                                //     et donc pas besoin de se désabonner dans ngOnDestroy()
  model1: ModelX = {name: 'White', firstname: 'Walter', job: 'chimiste'};   // (5) un objet qui implémente un modèle - (voir /models/model-x.ts)
  model2: ModelX = {name: 'Pinkman', firstname: 'Jesse'};                   // (6) idem - avec une propriété en moins
  value1Service: string = this.stored1Service.storedValue1;                 // (7) depuis la propriété d'un service (qui doit être public)
  value2Service: string = this.stored1Service.getStoredValue2();            // (8) depuis une fonction d'un service
  storedModel1: ModelX;                                                     // (9) initialisé dans : ngOnInit()
  private privValue = 100;                                                  // (11) n'est pas accessible depuis la vue
  subData2: Subscription;                                                     // (13) pour pouvoir se désabonner
  dataObs2$: Observable<ModelX> = of({name: 'Fring', firstname: 'Gustavo'});  // (13) l'observable qui va transmettre un objet de type : Modelx aux souscripteurs
  data2: ModelX;                                                              // (13) en lien avec la vue

                                                            // constructor(.......)
                                                            // automatiquement, l'injection de dépendance (DI) a injecté l'instance de Stored1Service
                                                            // stored1Service contient l'instance qui va être utilisée n'importe où dans le composant avec : this.stored1Service
  constructor(
    private stored1Service: Stored1Service,                                 // on le met en private pour le protéger afin qu'il ne soit accessible qu'ici (dans le contrôleur)
    public stored2Service: Stored1Service                                   // (12) mauvaise pratique : en public, le service: stored2Service est accessible depuis la vue
  ) { }

  ngOnInit(): void {
    this.storedModel1 = this.stored1Service.getStoredModel1();   // (9) à l'initialisation du composant, on appelle la fonction du service pour récupérer la variable : storedModel1

    this.subData2 = this.dataObs2$.subscribe((data: ModelX) => {    // (13) on souscrit à l'observable pour récupérer la valeur. subData2 contient cette souscription
      // ici, on effectue un éventuel traitement...                 //
      this.data2 = data;                                            //      on transmet la valeur reçue à data2 pour la vue
    });
  }

  dataFn1(): string {                                               // (10) une fonction peut aussi être appelée dans la vue (par défaut une fonction est public)
    return 'texte de la fonction';                                  //      il faut donc retourner une valeur
  }

  ngOnDestroy(): void {
    this.subData2.unsubscribe();                                    // (13) il faut toujours se désabonner à un observable que l'on a souscrit manuellement
                                                                    //      sinon il y a un risque de fuite de mémoire
  }
}

XII-E-2. Remarques

  • (9) Voyez le typage de la variable storedModel1 storedModel1: ModelX; et de la fonction du service  getStoredModel1(): ModelX {...}

    • le typage permet de sécuriser la variable et la fonction contre les erreurs ;
    • la donnée que l'on manipule ne peut être que du type ModelX sinon une erreur arrive à la compilation.
  • (4) et (13) permet de faire la même chose sur un observable. La méthode (4) est plus réduite en code. On privilégie la méthode (13) quand on a un traitement à effectuer sur les données reçues de l'observable.
  • À propos de cette écriture :
 
Sélectionnez
1.
constructor(private monService: MonService) {  }

en réalité, sachez que c'est un raccourci syntaxique pour :

 
Sélectionnez
1.
2.
3.
4.
5.
private monService: MonService;

constructor(monService: MonService) { 
  this.monService = monService;
}

XII-E-3. Résultat

 
Sélectionnez
1.
ng serve

http://localhost:4200/

à l'écran, vous obtenez :

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
(1) variable1=hello from variable
(2) array1=10,Breaking bad,30
(3) objet1={ "val1": "Ehrmantraut", "val2": "Mike" } | objet1.val1=Ehrmantraut | objet1.val2=Mike
(4) dataObs=text from observable A
(5) model1={ "name": "White", "firstname": "Walter", "job": "chimiste" } avec job: Model1.job=chimiste
(6) model2={ "name": "Pinkman", "firstname": "Jesse" }
(7) value1Service=texte1 from service
(8) value2Service=texte2 from service
(9) storedModel1={ "name": "shrader", "firstname": "Hank" }
(10) dataFn1()=texte de la fonction
(11) privValue=
(12) stored2Service.storedValue1=texte1 from service
(12) stored2Service.getStoredModel1()={ "name": "shrader", "firstname": "Hank" }
(13) data2={ "name": "Fring", "firstname": "Gustavo" }

XII-F. Conclusion

  • Vous avez vu ce que sont : un composant, un modèle de données et un service.
  • De plus, depuis un composant, vous avez vu différentes façons de passer des données à son template.

XIII. Création du 1er module et de ses composants

  • Dans un projet, nous avons un module racine : app.module.ts et son composant: app.component.ts.

XIII-A. Exemple : créer un nouveau module et lui attacher deux composants

voici le schéma :

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
    app-module
    ............................................................
        <app-root  (app.component.html)
        ______________________________________

            partial-module
            ....................................................

                <app-header  (header.component.html)
                __________________________
                    ...
                __________________________
                ... 
                ...
                <app-footer  (footer.component.html)
                __________________________
                    ...
                __________________________      
            .....................................................
        _______________________________________
    .............................................................

dossiers:

/app
  app.module.ts                         // le module racine, est toujours présent
                                        // on importe : partial.module.ts (pour utiliser les composants de ce module)
                                        // sinon on ne pourrait pas utiliser : app-header et app-footer
  app.component...(ts,html...)          // app-root : le composant racine
/partials
  partial.module.ts                             // header et footer doivent être déclarés dans son module : partial.module.ts (pour être utilisés dans son module)
                                                // header et footer doivent être rendus exportables dans son module : partial.module.ts (pour être utilisés dans un autre module)
  /header
    header.component....(ts,html...)      // app-header
  /footer
    footer.component....(ts,html...)      // app-footer

XIII-B. Pratique

 
Sélectionnez
1.
2.
3.
4.
ng new angular-module1
strict ? NO
routing ? NO
SCSS

XIII-B-1. Création du nouveau module

Donc nous mettons le module et ses composants dans un dossier : /partials :

  • on commence par créer le module : partials-module où l'on va mettre nos composants
 
Sélectionnez
1.
ng g m partials --module=app
  • avec : --module=app on indique à angular-cli de rajouter l'import dans le module app.module.ts (comme ça, on n'a pas à le faire) ;
  • quand on crée un module, un dossier du même nom est créé ;

    • on obtient bien : /partials/partials.module.ts.

XIII-B-2. Allons voir :

/app/app.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
import { BrowserModule } from '@angular/platform-browser';                    
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';
import { PartialsModule } from './partials/partials.module';

@NgModule({
  declarations: [AppComponent],
  imports: [
    BrowserModule,
    PartialsModule,                           // c'est OK ! pour utiliser les composants : header.component et footer.component dans la page: app.component.html
  ],
  providers: [],
  bootstrap: [AppComponent],
  schemas: [  ],
})
export class AppModule { }

XIII-B-3. Ensuite, créons les deux composants

Ajoutons deux composants au module : partials-module

 
Sélectionnez
1.
2.
ng g c partials/header --module=partials
ng g c partials/footer --module=partials

XIII-B-4. Allons voir

/partials/partials.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
import { NgModule } from '@angular/core';                    
import { CommonModule } from '@angular/common';
import { HeaderComponent } from './header/header.component';
import { FooterComponent } from './footer/footer.component';

@NgModule({
  declarations: [HeaderComponent, FooterComponent],             // c'est ok !
  imports: [
    CommonModule
  ]
})
export class PartialsModule { }

XIII-B-5. Résultat

 
Sélectionnez
1.
ng serve

Allons voir : http://localhost:4200/

  • Rien ne se passe à l'écran, c'est normal.
  • On a créé et paramétré les composants, mais il faut indiquer où ils doivent être intégrés dans les vues.
  • Nous utilisons ces composants dans le composant racine : app.component.html, car le header et le footer sont toujours présents, quelle que soit la page où l'on se trouve.

/app/app.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
<app-header></app-header>               <!-- on est dans : app.component du module : app.module -->
<hr>                                    <!-- donc : app.module doit connaitre l'existence de ces composants : app-header et app-footer -->
<h1>Welcome to {{ title }}!</h1>        <!-- pour cela dans : app.module on importe le module : partials.module (qui contient ces composants) -->
<hr>
<app-footer></app-footer>

Vous constaterez des erreurs dans la console des outils dev de votre navigateur et des erreurs à l'écran

 
Sélectionnez
1.
2.
'app-header' is not a known element
'app-footer' is not a known element
  • C'est normal. Il y a une chose en plus que vous devez connaitre :

partials-module

 
Sélectionnez
1.
2.
3.
4.
5.
  declarations: [HeaderComponent, FooterComponent],       // OK, on a déclaré les deux composants !
  imports: [
    CommonModule
  ]
  ...

app-module

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
  declarations: [
    AppComponent,
  ],
  imports: [
    BrowserModule,
    PartialsModule              // OK, on a importé : PartialsModule !
  ],                            //, mais sachez que quand on importe d'un côté, il faut exporter de l'autre
  ...                           // chose que nous n'avons pas faite
  • Pour importer, il faut exporter.
  • Réécrivons le module : partials-module.

partials-module.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
...
@NgModule({
  declarations: [HeaderComponent, FooterComponent],
  imports: [
    CommonModule
  ],
  exports: [HeaderComponent, FooterComponent]             // ici, on rend exportables les composants que l'on souhaite
                                                          // afin qu'ils soient importables dans un autre module    
...

XIII-B-6. Conseils

  • Quand vous manipulez les modules, il faut toujours relancer : ng serve (car les modifications des modules ne sont pas toujours prises en compte dans le live reload).

XIII-B-7. Remarques

  • Pourquoi doit-on rendre exportable un composant, ne peut-il pas se faire automatiquement ?
  • Pour des raisons de sécurité, on veut avoir le choix de ne pas rendre exportable un composant afin qu'il soit restreint de n'être utilisable que dans son module.

XIII-B-8. Voyons le résultat à l'écran :

 
Sélectionnez
1.
2.
3.
4.
5.
header works!
________________________________
Welcome to angular-tuto1!
________________________________
footer works!

XIII-C. Conclusion

  • Création d'un module et de ses composants.
  • Depuis un module « supérieur » : on importe ce nouveau module.
  • Depuis le nouveau module : on déclare les composants (pour qu'ils soient rendus utilisables).
  • Depuis le nouveau module : on exporte les composants (pour qu'ils soient pris en compte dans l'import d'un autre module).

XIV. Communication entre les composants

On peut avoir besoin de communiquer entre deux composants pour passer des données de l'un vers l'autre.

XIV-A. Les différentes techniques

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
- le Two-way Data Binding :                une technique pour communiquer du parent vers l'enfant et de l'enfant vers le parent
                                          Les deux composants doivent être imbriqués, un est considéré comme le parent et l'autre, l'enfant
- par service avec une variable :          un ou plusieurs composants peuvent communiquer avec un ou plusieurs autres composants à travers une variable                                      
- par service avec un observable :         un ou plusieurs composants peuvent communiquer avec un ou plusieurs autres composants à travers un observable
                                          avantages avec l'observable :
                                              - on peut envoyer une donnée ou un flux de données (une valeur puis une autre)
                                              - les clients (composants, services...) qui ont souscrit à cet observable reçoivent la ou les valeurs et peuvent ainsi agir

XIV-B. Two-way Data Binding

Communication : parent vers enfant ou enfant vers parent.

XIV-B-1. Pratique

 
Sélectionnez
1.
2.
3.
4.
ng new angular-two-way1
strict ? NO
routing ? NO
SCSS
 
Sélectionnez
1.
2.
ng g c parent --module=app
ng g c child --module=app

Mettons en place :

  • le parent contenant l'enfant ;
  • la communication parent vers enfant : avec différents types de données (number, string, observable…) ;
  • la communication enfant vers parent : avec un EventEmitter.

app.component.html

 
Sélectionnez
1.
<app-parent></app-parent>

parent.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
<div style="background: lavender;">
  <p>parent works!</p>

  <app-child
    [myMessage1]="'hello toto!'"
    [myVariable1]="variable1"
    [myData1]="data1"
    [myData2]="data2"
    [myDataObs$]="dataObs$"
    [myDataFn]="dataFn()"

    (sendMessage1)="receptionFromChild($event)"
  ></app-child>
  <p>message provenant de l'enfant ---> (7) messageReceptionFromChild=<b>{{ messageReceptionFromChild }}</b></p>

  <hr>
  <h2>test de ngOnChanges</h2>
    <button (click)="clickUpdateMyMessage()">(8) cliquez ici ! modification de la variable: variable1(2) et voir si l'enfant a détecté la modification dans ngOnChanges()  (voir console)</button>
</div>

parent.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
import { Component, OnInit } from '@angular/core';
import { Observable, of } from 'rxjs';

@Component({
  selector: 'app-parent',
  templateUrl: './parent.component.html',
  styleUrls: ['./parent.component.scss']
})
export class ParentComponent implements OnInit {
  // envoi vers enfant
  variable1 = 'hello from child variable';                                // (2) (8)
  data1 = [10, 'coucou', 30];                                             // (3)
  data2 = {name: 'joe', firstanme: 'black'};                              // (4)
  dataObs$: Observable<string> = of('text from observable A');            // (5)

  // réception de l'enfant
  messageReceptionFromChild: string;                                      // (7)

  dataFn(): string {                                                      // (6)
    return 'text from function';
  }

  constructor() { }

  ngOnInit(): void { }

  receptionFromChild(event: string): void {                               // (7)
    this.messageReceptionFromChild = event;
  }

  clickUpdateMyMessage(): void {                                          // (8)
    this.variable1 = '***** texte de variable1 modifié ******';           // on modifie : variable1 pour déclencher la détection dans le composant enfant
  }
}

child.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
<div style="background: gainsboro; margin-left: 24px;">
  <p>child works!</p>

  <h2>réception enfant:</h2>
  <p>(1) myMessage1={{myMessage1}}</p>
  <p>(2) myVariable1={{myVariable1}}</p>
  <p>(3) myData1={{myData1|json}}</p>
  <p>(4) myData2={{myData2|json}}</p>
  <p>(5) myDataObs$={{myDataObs$|async}}</p>
  <p>(6) myDataFn={{myDataFn}}</p>

  <hr>
  <h2>vers le parent:</h2>
  <button (click)="clickSendMessage()">(7) cliquez ici ! envoi d'un message du composant enfant vers le parent</button>
</div>

child.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
import { Component, OnInit, Input, Output, EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
import { Observable } from 'rxjs';

@Component({
  selector: 'app-child',
  templateUrl: './child.component.html',
  styleUrls: ['./child.component.scss']
})
export class ChildComponent implements OnInit, OnChanges  {
  // @Input()       ->   réception d'une donnée en entrée
  @Input() myMessage1: string;                    // (1)
  @Input() myVariable1: string;                   // (2)
  @Input() myData1: any;                          // (3)
  @Input() myData2: any;                          // (4)
  @Input() myDataFn: string;                      // (5)
  @Input() myDataObs$: Observable<string>;        // (6)

  // @Output()      ->    envoi vers le parent
  @Output() sendMessage1 = new EventEmitter<string>();            // (7) une sortie vers le parent qui écoute

  constructor() { }

  ngOnInit(): void {
  }

  clickSendMessage(): void {                                      // (7)
    this.sendMessage1.emit('text from child');                    // émission de données sur la sortie : @Output() sendMessage1
  }

  ngOnChanges(changes: SimpleChanges): void {                     // (8) ngOnChanges détecte le changement de valeur uniquement avec les variables d'entrées : @Input() .......
    console.log('--------------------------');                    //
    //
    // afficher toutes les variables qui ont été modifiées
    for (const propName in changes) {                             // Angular met dans "changes" toutes les variables qui ont été modifiées
      const change = changes[propName];
      console.log('propriété qui a été modifiée=' + propName);
      console.log('ancienne valeur=' + change.previousValue);
      console.log('nouvelle valeur=' + change.currentValue);
    }
    //
    // disons que je veux savoir si la variable: myVariable1 est modifiée  (les autres variables ne m'intéressent pas)
    for (const propName in changes) {
      if (propName === 'myVariable1') {                           // la variable qui m'intéresse
        console.log('=============================');
        console.log('myVariable1 a été modifié=' + propName);     // forcement propName = 'myVariable1'
        const change = changes[propName];
        console.log('ancienne valeur=' + change.previousValue);
        console.log('nouvelle valeur=' + change.currentValue);
      }
    }
  }
}
 
Sélectionnez
1.
ng serve

XIV-B-2. On obtient ceci à l'écran

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
parent works!

        child works!
        réception enfant:
        (1) myMessage=hello toto!
        (2) myVariable=hello from child variable
        (3) myData1=[ 10, "coucou", 30 ]
        (4) myData2={ "name": "joe", "firstanme": "black" }
        (5) myDataObs$=text from observable A
        (6) myDataFn=text from function
        vers le parent:
        bouton [(7) envoi d'un message du composant enfant vers le parent]

message provenant de l'enfant ---> (7) messageReceptionFromChild=     

test de ngOnChanges
bouton [(8) modification de la variable: variable1(2) et voir si l'enfant a détecté la modification dans ngOnChanges()  (voir console)]

XIV-B-3. Conclusion

  • La plupart des communications dont on a besoin dans un projet sont une communication parent / enfant.
  • Two-way Data Binding est uniquement valable pour des composants imbriqués parent / enfant.
  • On peut détecter le changement de valeur des variables en entrée (@Input()…) dans le composant enfant via : ngOnChanges().

XIV-C. Communication par service (technique par observable ou par variable)

  • Plusieurs composants peuvent communiquer entre eux, quel que soit leur emplacement (imbriqués ou pas).

XIV-C-1. Schéma

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
      app.module.ts (contexte d'exécution) - avec une instance du service : stored1.service.ts
      .........................................................
      |     app-root
      |     ___________________________________________________
      |         app-comp1       <--- accès au service : stored1.service.ts
      |         ________________________________
      |             ...
      |         ________________________________  
      |  
      |         app-comp2       <--- accès au service : stored1.service.ts
      |         ________________________________
      |              app-comp3  <--- accès au service : stored1.service.ts
      |               __________________________
      |                     ...
      |               __________________________    
      |         ________________________________                  
      |     ___________________________________________________    
      |
      .........................................................
XIV-C-1-a. Principes
  • Les composants : app-comp1, app-comp2, app-comp3 font partie du module : app.module.ts.
  • On indique que le service est en 'root' donc une seule et même instance (singleton) de : stored1.service.ts sera injectée à tous ceux qui le demandent.
  • Ces trois composants peuvent modifier ou lire la variable qui se trouve dans le service : stored1.service.ts.
  • Il y a une imbrication entre : app-comp2 et app-comp3, mais ça importe peu vu que nous utilisons la communication par service (contrairement au two way data binding).

XIV-C-2. Pratique

 
Sélectionnez
1.
2.
3.
4.
ng new angular-service-com1
strict ? NO
routing ? NO
SCSS
 
Sélectionnez
1.
2.
3.
4.
5.
6.
cd angular-service-com1
ng g c comp1 --module=app
ng g c comp2 --module=app
ng g c comp3 --module=app
ng g s services/stored1
ng g i models/i-user

/app/app.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
import { BrowserModule } from '@angular/platform-browser';                    
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';
import { Comp1Component } from './comp1/comp1.component';
import { Comp2Component } from './comp2/comp2.component';
import { Comp3Component } from './comp3/comp3.component';

@NgModule({
  declarations: [
    AppComponent,
    Comp1Component,           // c'est OK !
    Comp2Component,           // les composants sont bien déclarés ici
    Comp3Component            //
  ],
  imports: [
    BrowserModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

/models/i-user.ts

 
Sélectionnez
1.
2.
3.
4.
5.
export interface IUser {
  name: string;
  firstname: string;
  genre: 'madame' | 'monsieur' | 'mademoiselle';
}

/app/services/store1.service.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
import { Injectable } from '@angular/core';
import { BehaviorSubject, Subject } from 'rxjs';
import { IUser } from '../models/i-user';

@Injectable({
  providedIn: 'root'        // l'instance du service sera du niveau 'root' c.-à-d. la même instance dans tout le projet
})                          // tous les composants du projet auront accès à la même instance du service
export class Stored1Service {
  private message1 = 'avec une variable du service : texte initial';                                                                // (1) par service
  private messageSubject: BehaviorSubject<string> = new BehaviorSubject<string>('avec un observable du service: texte initial');   // (2) par observable
                                                                                                                                    // BehaviorSubject = initialiser avec une valeur
  private dataSubject: Subject<IUser> = new Subject<IUser>();                                               // (4) par observable
                                                                                                            // Subject = pas d'initialisation de valeur

  constructor() { }

  getMessage1(): string {                                   // (1)
    return this.message1;
  }

  setMessage1(message1: string): void {                     // (1)
    this.message1 = message1;
  }

  getMessageSubject(): BehaviorSubject<string> {            // (2)
    return this.messageSubject;
  }

  getDataSubject(): Subject<IUser> {                        // (4)
    return this.dataSubject;
  }

  emitDataSubject(user: IUser): void {                      // (4)
    this.dataSubject.next(user);
  }
}
XIV-C-2-a. Remarques générales
  • Bonne pratique : on met les propriétés d'un service en private.
  • Pour récupérer une propriété depuis l'extérieur de la classe, private oblige à faire appel à une fonction comme getData1().
  • Idem si on veut affecter une valeur à une propriété, private oblige de passer par une fonction comme setData1(….).
  • BehaviorSubject, est un observable/observer (les deux à la fois). :

    • BehaviorSubject : on peut à la fois l'écouter avec .subscribe() ou émettre une valeur avec .next(..).
  • BehaviorSubject doit être obligatoirement initialisé à la création :
 
Sélectionnez
1.
2.
3.
private dataBSubject: BehaviorSubject<string> = new BehaviorSubject<string>('par observable: texte initiale');
                                                                                    ^  valeur initialisée   ^
<string>    ---> pour indiquer que la valeur des données que l'on manipule dans l'observable sera du type string.
  • L'instance du service sera du niveau 'root' c.-à-d. la même instance dans tout le projet :

    • donc tous les composants du projet auront accès à la même instance du service. C'est pour cela que si un composant X modifie une propriété d'un service, le composant Y peut accéder à la valeur qui a été modifiée (puisque c'est la même instance) ;
    • il est possible de configurer un service pour n'avoir une instance qu'au niveau composant (ainsi un composant X peut avoir une instance d'un service A et un autre composant Y peut avoir une autre instance d'un même service A).

app.component.html

 
Sélectionnez
1.
2.
3.
<app-comp1></app-comp1>
<hr>
<app-comp2></app-comp2>

comp1.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
<div style="background: pink;">
  <p>comp1 works!</p>
  <p>(1) réception par variable     -------------> getMessage1()={{getMessage1()}}</p>
  <p>(2) réception par observable -------------> messageSubject={{messageSubject|async}}</p>
  <p>(3) message={{message}}</p>
  <button (click)="choice(1)">monsieur dexter holland</button>
  <button (click)="choice(2)">madame agnes obel</button>
</div>
XIV-C-2-b. comp1.component
 
Sélectionnez
1.
2.
{{dataBSubject|async}}      le pipe async permet à angular de souscrire de façon automatique à dataBSubject et ainsi récupérer la valeur de l'observable
                            le pipe async écoute l'observable

comp1.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
import { Component, OnDestroy, OnInit } from '@angular/core';
import { Stored1Service } from '../services/stored1.service';
import { BehaviorSubject, Subscription } from 'rxjs';
import { IUser } from '../models/i-user';

@Component({
  selector: 'app-comp1',
  templateUrl: './comp1.component.html',
  styleUrls: ['./comp1.component.scss']
})
export class Comp1Component implements OnInit, OnDestroy {
  messageSubject: BehaviorSubject<string>;                          // (2) un BehaviorSubject est un observable un peu "spécial"
  messageSubscription: Subscription;                                // (3) pour le désabonnement
  message: string;                                                  // (3) une variable string pour la vue

  constructor(private stored1Service: Stored1Service) { }

  ngOnInit(): void {
    this.messageSubject = this.stored1Service.getMessageSubject();    // (2) on récupère l'observable du service et on l'affecte à une variable local : dataBSubject du composant
                                                                      //     afin qu'il soit accessible par la vue (c'est le pipe |async de la vue qui va souscrire à l'observable)

    this.messageSubscription = this.stored1Service.getMessageSubject().subscribe((txt: string) => {   // (3) ou on souscrit soi-même à l'observable (on écoute l'observable)
      //
      // ici, on peut appliquer divers traitements
      //
      this.message = txt;                                                   // (3) et on affecte à la variable du composant : dataBSubject3 la valeur reçue de l'observable data
    });

    //
    //  avec (2) et (3) on obtient le même résultat, sachez juste qu'il est possible de faire de ces deux manières
    //
  }

  getMessage1(): string {                                         // (1) on retourne une variable dans un service
    return this.stored1Service.getMessage1();                     //     il sera accessible par la vue
  }

  ngOnDestroy(): void {
    this.messageSubscription.unsubscribe();                       // (3)  toujours se désabonner quand on souscrit manuellement dans un composant
  }

  choice(nb: number): void {
    const data1: IUser = { name: 'Holland', firstname: 'Dexter', genre: 'monsieur'};
    const data2: IUser = { name: 'Obel', firstname: 'Agnes', genre: 'madame'};

    if (nb === 1) {
      this.stored1Service.emitDataSubject(data1);
    } else if (nb === 2) {
      this.stored1Service.emitDataSubject(data2);
    }
  }
}
XIV-C-2-c. comp2.component
  • On optera pour la méthode (3) pour des données complexes ou il faudra les traiter avant de les transmettre à la vue.

comp2.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
<div style="background: yellow;">
  <p>comp2 works!</p>
  <p>(1) réception par variable      -------------> getMessage1()={{getMessage1()}}</p>
  <button (click)="cliqueUpdateService()">changer le texte par variable</button>
  <br>
  <br>
  <p>(2) réception par observable -------------> messageSubject={{messageSubject|async}}</p>
  <button (click)="cliqueUpdateObservable()">changer le texte par l'observable</button>
  <hr>
  <button (click)="resetAll()">reset</button>
  <hr>

  <app-comp3></app-comp3>
</div>

comp2.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
import { Component, OnInit } from '@angular/core';
import { BehaviorSubject } from 'rxjs';
import { Stored1Service } from '../services/stored1.service';
import { IUser } from '../models/i-user';

@Component({
  selector: 'app-comp2',
  templateUrl: './comp2.component.html',
  styleUrls: ['./comp2.component.scss']
})
export class Comp2Component implements OnInit {
  messageSubject: BehaviorSubject<string>;                                // (2)

  constructor(private stored1Service: Stored1Service) { }

  ngOnInit(): void {
    this.messageSubject = this.stored1Service.getMessageSubject();          // (2)
  }

  getMessage1(): string {                                       // (1)
    return this.stored1Service.getMessage1();
  }

  cliqueUpdateService(): void {
    this.stored1Service.setMessage1('par variable : *** texte changé par le composant: comp2 ***');                     // (1)
  }

  cliqueUpdateObservable(): void {
    this.stored1Service.getMessageSubject().next('par observable : <<< texte changé par le composant: comp2 >>>');     // (2)
  }

  resetAll(): void {
    this.stored1Service.setMessage1('');                        // (1)
    this.stored1Service.getMessageSubject().next('');           // (2) mauvaise pratique on fait le next... dans le composant
    this.stored1Service.emitDataSubject(null);                  // (4) bonne pratique : on demande au service d'effectuer le next...
  }                                                             //                     car c'est le service qui est chargé d'effectuer des actions sur les observables
}
XIV-C-2-d. comp3.component

comp3.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
<div style="background: azure; margin-left: 24px;">
  <p>comp3 works!</p>
  <p>(1) réception par variable      -------------> getMessage1()={{getMessage1()}}</p>
  <p>(2) réception par observable ------------> messageSubject={{messageSubject|async}}</p>
  <p>(4) réception par observable ------------> dataSubject={{dataSubject|async|json}}</p>
</div>

comp3.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
import { Component, OnInit } from '@angular/core';
import { Stored1Service } from '../services/stored1.service';
import { BehaviorSubject, Subject } from 'rxjs';
import { IUser } from '../models/i-user';

@Component({
  selector: 'app-comp3',
  templateUrl: './comp3.component.html',
  styleUrls: ['./comp3.component.scss']
})
export class Comp3Component implements OnInit {
  messageSubject: BehaviorSubject<string>;                              // (2)
  dataSubject: Subject<IUser>;                                          // (4)

  constructor(private stored1Service: Stored1Service) { }

  ngOnInit(): void {
    this.messageSubject = this.stored1Service.getMessageSubject();      // (2)
    this.dataSubject = this.stored1Service.getDataSubject();            // (4)
  }

  getMessage1(): string {                                               // (1)
    return this.stored1Service.getMessage1();
  }
}

XIV-C-3. Résultat

  • Vous avez constaté que lorsque l'on modifie les variables dans le service, tous les composants se mettent à jour automatiquement.

XIV-C-4. À savoir

  • Ce qui se passe c'est qu'à chaque modification, Angular déclenche la détection de changement des données pour chaque composant.
  • La différence entre la communication service par variable et par observable :

    • Par variable

      • Avantages ;
      • très simple : quand on modifie la valeur de la variable du service, tous les composants qui l'affichent mettent à jour la nouvelle valeur dans sa vue.
        Inconvénients :
      • si on utilise des centaines de variables, Angular doit surveiller la modification du moindre changement sur une de ces variables et déclencher la mise à jour dans tous les composants qui l'utilisent. Ça peut donc être coûteux en performances. (Cette technique ne doit donc être utilisée que pour quelques variables.)

      Par observable

      • Avantages :

        • pas besoin d'utiliser la détection de changement de valeur d'Angular. Avec les observables, on émet une valeur et tous les clients observeurs qui ont souscrit reçoivent la nouvelle donnée et la mettent à jour. Pour les performances, c'est beaucoup mieux ;
        • de plus, on peut effectuer une action quand une valeur est reçue par un client qui a souscrit à l'observable (voir point (3)).

        Inconvénients :

        • il faut écrire autant d'observables qu'il y a de variables, mais il y a une astuce. On regroupe les données dans des modèles de données, de toute façon, la plupart du temps, on gère des modèles de données (voir point (4)). On émet le groupe dont une ou des valeurs ont été modifiées. Cela permet de gérer par paquets et donc, si on a des centaines de variables, c'est plus pratique et performant.

          • Remarque : utiliser la technique par regroupement pour le système par variable ne sert à rien parce que Angular doit quand même surveiller la modification de l'ensemble des valeurs des paquets.

XIV-C-5. Conclusion

  • Les composants communiquent en s'échangeant des données à travers un service via la technique de la variable ou de l'observateur.
  • Il n'y a qu'une seule instance du service qui est partagée par tous les composants.
  • Il faut privilégier la technique par observable (Subject ou BehaviorSubject).
  • Subject : à la souscription, attend la prochaine valeur qui sera émise.
  • BehaviorSubject : à la souscription, récupère la dernière valeur et attend la prochaine valeur qui sera émise.
  • Il faut privilégier : BehaviorSubject pour fournir une valeur à la souscription ou lorsque vous avez du routing.
  • En effet, pour le routing, lors d'une émission de donnée sur une page quand vous changez de page la souscription au BehaviorSubject vous enverra la dernière valeur émise (celle de la page précédente).

XV. Accès au composant enfant

  • Depuis le composant parent, il est possible d'accéder aux propriétés, aux fonctions et au DOM du composant enfant.

XV-A. Pratique

 
Sélectionnez
1.
2.
app.component                     composant parent
  child.component                 composant enfant
 
Sélectionnez
1.
2.
3.
4.
ng new angular-viewchild1
strict ? NO
routing ? NO
SCSS

ng g c child

app.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
<p><b>parent: app.component.ts</b></p>

<h2>partie 1 : accès à n'importe quel composant enfant</h2>
<app-child #child1></app-child>

<hr>

<h2>partie 2 : accès à n'importe quel élément HTML</h2>
<input #someInput placeholder="Votre langage de dév préféré">

app.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
import { Component, ViewChild, AfterViewInit, OnInit, ChangeDetectorRef, ElementRef, Renderer2 } from '@angular/core';
import { ChildComponent } from './child/child.component';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.scss']
})
export class AppComponent implements AfterViewInit,  OnInit   {
  // partie 1
  @ViewChild(ChildComponent) childComponent: ChildComponent;      // : ChildComponent     --> accès au composant enfant (le contrôleur .ts)
                                                                  // dans la vue il correspond à : <app-child #child1></app-child>
                                                                  //, car il y a qu'une seule balise : <app-child
  // s'il y a plusieurs balises <app-child dans la vue, pour cibler la bonne, il faut utiliser cette syntaxe:
  // @ViewChild('child1') childComponent: ChildComponent;    // 'child1' == #child1
  // et un autre composant: @ViewChild('child2') childComponent: ChildComponent;   // avec dans la vue :  <app-child #child2></app-child>


  @ViewChild('child1', { read: ElementRef, static: false }) childElementRef: ElementRef;   // : ElementRef    --> accès au DOM
                                                                                          // donc on peut faire : this.childElementRef.nativeElement.__(élément DOM)___
  // partie 2
  @ViewChild('someInput') someInput: ElementRef;                  // 'someInput'    --> correspond à : #someInput dans la vue
                                                                  // : ElementRef    --> de type elementRef (accès au DOM)

  constructor(private cd: ChangeDetectorRef) {  }

  // composant enfant :  depuis le composant parent, ViewChild permet d'accéder aux propriétés, aux fonctions et au DOM du composant enfant
  // ngAfterViewInit : pour accéder et modifier un composant enfant

  ngOnInit(): void {  }


  ngAfterViewInit(): void {                             // ngAfterViewInit :  tous les composants enfants ont été initialisés et vérifiés
    // partie 1 : accès au composant enfant
    console.log("*** cycle ngAfterViewInit");

    // accès à une variable
    console.log(this.childComponent.data);              // c'est le bon endroit pour accéder à un composant, car il a été initialisé
                                                        // on accède bien au composant enfant et à sa propriété : data
    // accès à une fonction
    this.childComponent.myFunctionChild();              // on accède à une fonction du composant enfant

    // setter une variable
    this.childComponent.data = 'modifié par le parent';
    this.cd.detectChanges();                            // IMPORTANT : après modification, toujours lancer la détection
                                                        // sinon on a une erreur de type : Expression has changed after it was last checked
                                                        // cela est dû au fait que quand on modifie une variable directement, le système de détection est dans la confusion
                                                        // quelle est la bonne valeur ? Celle-ci ou celle du composant enfant
                                                        // donc on lance la détection pour dire que c'est celle-ci

    // allez voir dans la console le DOM que l'on peut modifier
    console.log(this.childElementRef.nativeElement);

    // on modifie la couleur du composant enfant
    this.childElementRef.nativeElement.style.color = 'white';     // à éviter, utiliser plutôt la technique des directives pour modifier du DOM

    // partie 2: accès au DOM depuis n'importe quel élément
    console.log(this.someInput);                                            // aller voir le contenu dans la console
    this.someInput.nativeElement.value = 'du parent';                       // on modifie directement la value de la balise: input
  }
}

XV-B. Remarques

  • ViewChild

    • permet de récupérer n'importe quelle balise enfant du composant.
  • ElementRef

    • est la classe qui représente le DOM de n'importe quel composant ou élément HTML ;
    • c'est donc cet ElementRef que l'on manipule pour accéder ou modifier le DOM de l'élément.
  • ChildComponent

    • est la classe du composant, on peut donc accéder aux propriétés et aux fonctions de ce composant.

/child/child.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
<div style="background: brown; margin-left: 24px; z-index: 10; padding: 12px;">
  <p>child works!</p>
  <p><b>enfant: child.component.ts</b></p>

  <button (click)="data = 'modifié par l\'enfant'">modifier data</button>
  <p>data = {{data}}</p>
</div>

/child/child.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
import { Component, OnInit } from '@angular/core';

@Component({
  selector: 'app-child',
  templateUrl: './child.component.html',
  styleUrls: ['./child.component.scss']
})
export class ChildComponent implements OnInit {
  data = 'initialisation from child';         // une variable, ici,  dans le composant enfant
                                              // le composant parent pourra accéder à cette variable
  constructor() { }

  ngOnInit(): void {  }

  myFunctionChild(): void {                     // une fonction
    console.log('myFunctionChild()');           // le composant parent va accéder à cette fonction
  }
}

XV-C. Conclusion

  • Depuis le composant parent, avec @ViewChild :

    • on peut accéder à n'importe quel composant enfant ;
    • on peut accéder aux variables, aux fonctions et aux DOM de n'importe quel composant enfant.
  • Les accès et modifications doivent se faire dans le cycle ngAfterViewInit().

XVI. API WEB (récupération de données) et les fichiers d'environnement (DEV et PROD)

  • Nous allons voir comment récupérer des données en interrogeant une API externe.
  • Nous aurons donc besoin d'un service API qui retourne du JSON, pour cela il existe une API en ligne où l'on peut faire des tests de récupération.
  • https://jsonplaceholder.typicode.com.
  • Sur votre navigateur : https://jsonplaceholder.typicode.com/todos/1 vous verrez que le JSON du todo ayant id=1 est affiché en JSON.

Avant de voir l'API, faisons un petit tour sur les environnements DEV et PROD, car on va en avoir besoin.

XVI-A. Environnements DEV et PROD

XVI-A-1. À savoir

  • Angular propose deux environnements par défaut : environment.ts (environnement de dév) et environment.prod.ts (de production donc).
  • Quand on lance :
 
Sélectionnez
1.
2.
3.
ng serve          // c'est l'environnement de dev qui est lancé donc c'est le fichier environment.ts  qui est pris en compte
ng serve --prod   // c'est l'environnement de prod qui est lancé donc c'est le fichier environment.prod.ts  qui est pris en compte
ng build --prod   // compile tout le projet et envoie le résultat dans le dossier: /dist pour le déploiement, donc c'est le fichier environment.prod.ts  qui est pris en compte

XVI-A-2. Pratique

  • Nous allons créer un composant qui sera chargé de récupérer une liste de todos ou un todo précis.
  • Nous allons voir différentes manières et astuces pour y arriver.
  • J'ai décidé de faire de cette fonctionnalité un module afin qu'il soit exporté et qu'il puisse être utilisé dans un autre module/fonctionnalité
 
Sélectionnez
1.
2.
3.
4.
ng new angular-api1
strict ? NO
routing ? NO
SCSS
 
Sélectionnez
1.
2.
3.
4.
ng g m todo
ng g c /todo/todo-display
ng g i /todo/models/todo
ng g s /todo/services/todo-http
  • Dans le fichier environnement, on indique divers paramètres du projet. C'est en quelque sorte là où on met les variables globales d'un projet.
  • Nous allons mettre dans ce fichier l'URL de l'API externe

/environments/environment.prod.ts

 
Sélectionnez
1.
  urlApi: 'https://jsonplaceholder.typicode.com',

/environments/environment.ts

 
Sélectionnez
1.
2.
  urlApi: 'https://jsonplaceholder.typicode.com',           // normalement en dev, on met une URL d'un serveur de dev ou de test
                                                            //, mais comme je n'en ai pas sous la main et que de toute façon c'est un faux serveur de prod, on utilise le même que celui en prod

/todo/todo.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
import { CommonModule } from '@angular/common';
import { HttpClientModule } from '@angular/common/http';
import { TodoDisplayComponent } from './todo-display/todo-display.component';

@NgModule({
  declarations: [TodoDisplayComponent],
  imports: [
    CommonModule,
    HttpClientModule,                         // on a besoin du package Http pour effectuer nos requêtes à l'API
  ],
  exports: [TodoDisplayComponent],            // on exporte le composant afin que depuis un autre module on puisse l'importer et l'utiliser
  providers: [  ],
})
export class TodoModule { }

XVI-A-3. Remarques

  • Comprenez bien le fait d'avoir créé un module pour le composant :

    • ça le rend exportable ;
    • dans ce module : todo.module, on importe le module : HttpClientModule, car seuls les composants de ce module ont besoin du package HttpClientModule (en considérant que les autres fonctionnalités (ou modules) du projet n'en ont pas besoin).

XVI-B. Le modèle de données

/todo/models/todo.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
export interface Todo {
  userId: number;
  id: number;
  title: string;
  completed: boolean;
}

XVI-C. Remarque

XVI-D. Le service

  • Un service qui ne va contenir uniquement que des requêtes HTTP pour interroger l'API et donc nous le nommons : todo-http.service.ts.
  • Si besoin, on pourrait écrire un autre service pour y mettre du code métier autre.
  • Bonne pratique : un service = code métier du même thème

/todo/services/todo-http.service.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
import { Injectable } from '@angular/core';                
import { environment } from '../../../environments/environment';  // importer le fichier d'environnement, car on en a besoin
                                                                  // automatiquement, si on est en développement ou en production
                                                                  // est chargé soit le fichier environment.ts soit le fichier : environment.prod.ts
import { HttpClient } from '@angular/common/http';
import { Observable } from 'rxjs';
import { Todo } from '../models/todo';

@Injectable({
  providedIn: 'root'
})
export class TodoHttpService {

  private urlApi: string = environment.urlApi;            // on récupère l'URL du fichier d'environnement (dev ou prod)

  constructor(private http: HttpClient) {                 // utiliser le package HTTP d'Angular
  }

  getTodos(): Observable<Todo[]> {                        // la fonction: getTodos() accepte en retour un observable ayant pour type de données : Todo[]

    return this.http.get<Todo[]>(`${this.urlApi}/todos`); // l'observable que l'on récupère du get doit contenir des données du type : Todo[]
  }

  getTodo(id: number): Observable<Todo> {                 // ici, c'est un simple : Todo

    return this.http.get<Todo>(`${this.urlApi}/todos/${id}`);
  }

  getTodosWithAny(): Observable<any> {                    // any est à éviter
                                                          // il faut toujours utiliser un typage
    return this.http.get(`${this.urlApi}/todos`);
  }
}

XVI-E. Composant

/todo/todo-display.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
<p>comp-a1 works!</p>

<h3>par observable</h3>
<p>A1: todo1 = {{todo1$ | async | json}}</p>          <!-- | async: souscrit à l'observable et récupère les données -->
<p>A1: todo1.title = {{(todo1$ | async)?.title}}</p>  <!-- (todo1$ | async)    d'abord on souscrit -->
                                                      <!-- ?.title             ensuite on accède à la propriété -->
                                                      <!-- ? (facultatif: permet d'éviter une erreur si todo1$ est null) -->



<h3>par variable</h3>
<p>A2: <ng-container *ngIf="todo2">todo2 = {{todo2 | json}}</ng-container></p>   <!-- |json : convertit un objet en texte -->
<p>A2: todo2.title = {{todo2?.title}}</p>
                                      <!-- pour un objet on utilise un *ngIf (*ngIf="todo2") -->
                                      <!-- et pour une propriété d'un objet, on utilise '?' (todo2?.title) -->
                                      <!-- todo2 est asynchrone, il met quelques ms pour avoir une réponse de l'API -->
                                      <!-- durant ces ms, la vue pense que todo2 est undefined et affiche une erreur -->

<p>en utilisant *ngIf (sans utiliser ?)</p>    <!-- à la place d'utiliser le '?' : {{todo2?.title}}, une autre façon est d'utiliser *ngIf="..."" -->
<ng-container *ngIf="todo2">A2: todo2.title = {{todo2.title}}</ng-container>   <!-- *ngIf="todo2"  si todo2 existe -->

<hr>

<h2>les todos de l'utilisateur : 6</h2>
<h3>B1 : par observable</h3>
<ul>
  <li *ngFor="let todo of todosByUser$ | async">todo.title = {{todo.title}}</li>
</ul>

<h3>B2 : par variable</h3>
<ul>
  <li *ngFor="let todo of todosByUser">todo.title = {{todo.title}}</li>
</ul>

<hr>

<h2>Cas particulier : liste de todos qui est filtrée dans la vue</h2>                 <!-- on filtre par la vue (on aurait pu filtrer directement à la source) -->
<h2>B1 : par observable les todos de l'utilisateur: 6 ayant été complétés</h2>       <!-- mais c'est pour l'exemple -->
<ul>
  <ng-container *ngFor="let todo of todosByUser$ | async">        <!-- ng-container est une balise "fantôme", juste un "container" (n'est pas inséré dans le DOM) -->
                                                                  <!-- il sert à ne pas casser la structure <ul> / <li> -->
    <li *ngIf="todo.completed">todo.title = {{todo.title}}</li>   <!-- on filtre avec le *ngIf -->
  </ng-container>                                                 <!-- pas besoin du '?' puisqu'on utilise un *ngIf -->
</ul>

<hr>

<h2>C1 : par observable: les todos de l'utilisateur (Avec: Any)</h2>       <!-- avec any, ça fonctionne, mais il faut éviter et utiliser le typage -->
<ng-container *ngFor="let todo of todosWithAny$ | async">
  <p *ngIf="todo.completed">todo.title = {{todo.title}}</p>
</ng-container>

XVI-E-1. Remarques

  • On utilise *ngIf=…« … » pour tester la variable avant l'affichage.
  • Ou on utilise : '?' avec monObjet?.maPropriete. '?' : indique d'effectuer un test d'existence pour les données asynchrones (requêtes HTTP ).
  • La balise : <ng-container ...> est une balise neutre, on aurait pu utiliser un <div ....> avec une balise : <div>
 
Sélectionnez
1.
2.
3.
<div *ngFor="let todo of todosWithAny$ | async">
  <p *ngIf="todo.completed">todo.title = {{todo.title}}</p>
</div>
  • On aurait dans le DOM :
 
Sélectionnez
1.
2.
3.
<div><p>titre 1</p></div>
<div><p>titre 2</p></div>
<div><p>titre 3</p></div>
  • avec une balise : <ng-container>
 
Sélectionnez
1.
2.
3.
<ng-container *ngFor="let todo of todosWithAny$ | async">
  <p *ngIf="todo.completed">todo.title = {{todo.title}}</p>
</ng-container>
  • on aurait dans le DOM :
 
Sélectionnez
1.
2.
3.
<p>titre 1</p>
<p>titre 2</p>
<p>titre 3</p>

ng-container = aucune balise = juste un container qui n'a pas d'impact dans le DOM

/todo/todo-display.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
import { Component, OnDestroy, OnInit } from '@angular/core';                    
import { Observable, Subscription,  } from 'rxjs';
import { map } from 'rxjs/operators';
import { TodoHttpService } from '../services/todo-http.service';
import { Todo } from '../models/todo';

@Component({
  selector: 'app-todo-display',
  templateUrl: './todo-display.component.html',
  styleUrls: ['./todo-display.component.scss']
})
export class TodoDisplayComponent implements OnInit, OnDestroy {

  //  un todo par son id
  todo1$: Observable<Todo>;               // A1 : la donnée de l'observable doit être de type: Todo
  todo2: Todo;                            // A2 : la variable doit être du type: Todo
  subTodo2: Subscription;                 // A2 : pour le désabonnement

  // les todos appartenant à un utilisateur
  todosByUser$: Observable<Todo[]>;       // B1 : doit être un observable dont les données doivent être un tableau de type Todo[]
  todosByUser: Todo[];                    // B2 : la variable doit être un tableau de type Todo[]
  subTodosByUser: Subscription;           // B2 : pour le désabonnement

  // tous les todos (de tous les utilisateurs)
  todosWithAny$: Observable<any>;         // C1 : à éviter avec 'any'. Il faut utiliser le typage avec des modèles
  todos$: Observable<Todo[]>;             // D1
  todos: Todo[];                          // D2
  subTodos: Subscription;                 // D2 : pour le désabonnement

  constructor(private todoHttpService: TodoHttpService) { }

  ngOnInit(): void {                      // c'est dans ngOnInit qu'on initialise les données

    // -----------------------------------------------------
    // un todo par son id
    const userId1 = 2;

    // A1 : retourne un observable
    this.todo1$ = this.todoHttpService.getTodo(userId1);    // A1
                                                            // todo1$ est passé à la vue sous forme d'observable
                                                            // c'est la vue qui va souscrire à l'observable via le pipe async
    // A2 : retourne les données brut
    this.subTodo2 = this.todoHttpService.getTodo(userId1).subscribe((todo: Todo) => {   // A2
      this.todo2 = todo;                                                                // todo2 est passé à la vue sous forme de données brutes
    });

    // -------------------------------------------------------------------------
    // les todos appartenant à un utilisateur
    // cas d'utilisation : si l'API envoi qu'une liste de todos et qu'on ne puisse pas récupérer un todo par l'id
    const userId2 = 6;

    // B1 : retourne un observable
    this.todosByUser$ = this.todoHttpService.getTodos().pipe(     // B1
      map((todos: Todo[]) =>                                      // récupère les todos[]
        todos.filter((todo: Todo) => todo.userId === userId2)     // pour chaque élément : todo on filtre avec la condition: todo.userId === 6
      ));                                                         // retourne un observable (contenant les données qui ont été filtrées)

    // B2 : retourne les données brutes
    this.subTodosByUser = this.todoHttpService.getTodos().pipe(   // B2
      map((todos: Todo[]) =>
        todos.filter((todo: Todo) => todo.userId === userId2)
      )
    ).subscribe((todos: Todo[]) => this.todosByUser = todos );    // retourne des données brutes

    // ----------------------------------------------------------------------------
    // tous les todos (de tous les utilisateurs)

    // C1 : retourne un observable
    this.todosWithAny$ = this.todoHttpService.getTodosWithAny();  // C1

    // D1 : retourne un observable
    this.todos$ = this.todoHttpService.getTodos();                // D1

    // D2 : retourne les données brutes
    this.subTodos = this.todoHttpService.getTodos().subscribe((todos: Todo[]) => {  // D2
      this.todos = todos;
    });
  }

  ngOnDestroy(): void {                           // il faut toujours se désabonner aux observables que l'ont a souscrits manuellement
    this.subTodo2.unsubscribe();                  // A2
    this.subTodosByUser.unsubscribe();            // B2
    this.subTodos.unsubscribe();                  // D2
  }
}

XVI-E-2. Remarques

  • Les méthodes d'interrogation de l'API via des requêtes HTTP sont des observables, car on obtient les données quelques millisecondes plus tard : c'est asynchrone.
  • On peut soit envoyer un observable à la vue pour qu'il se charge automatiquement de souscrire.
  • Ou on peut souscrire soi-même à l'observable et envoyer les données brutes à la vue.
  • À savoir : syntaxe raccourcie du constructeur :
 
Sélectionnez
1.
2.
3.
constructor(private todoService: TodoService) {                                       
}
// on accède dans les fonctions avec : this.todoService.

équivaut à :

 
Sélectionnez
1.
2.
3.
4.
5.
6.
private todoService: TodoService

constructor(todoService: TodoService) {
  this.todoService = todoService;
}
// dans les fonctions on accède avec this.todoService.

app.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
import { BrowserModule } from '@angular/platform-browser';                    
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';
import { TodoModule } from './todo/todo.module';

@NgModule({
  declarations: [
    AppComponent
  ],
  imports: [
    BrowserModule,
    TodoModule,                   // importer le module : todo.module.ts
  ],                              // pour pouvoir utiliser le composant (qui a été rendu exportable)
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

app.component.html

 
Sélectionnez
1.
2.
<app-todo-display></app-todo-display>       <!-- le composant : app-todo-display appartient au module: todo.module.ts -->
                                            <!-- on peut l'utiliser dans app parce qu'on a importé le module en question -->

XVI-E-3. Remarques

  • Nous importons le module : todo.module.ts là où on a besoin de sa fonctionnalité.

XVI-F. Résultat

Voyez les résultats des différents points…

XVII. SCSS

Maintenant, voyons comment est géré le CSS dans les composants.

XVII-A. À savoir sur le SCSS :

  • Le SCSS est une amélioration du css.
  • Le SCSS est converti en CSS (car seul le CSS est compris par le navigateur).
  • Le SCSS apporte une écriture plus puissante, utilisation de variables…

XVII-B. Le css et un projet Angular

  • Chaque composant dispose de son propre css.
  • Il existe une classe CSS en global : styles.scss. Le CSS dans ce fichier est accessible depuis tous les composants du projet.
  • Il faut éviter d'utiliser le fichier : styles.css. C'est une question d'organisation, ce fichier ne doit pas être un fourre-tout pour tous les composants.

XVII-C. Pratique

  • Dans le projet, nous mettons une même classe css : 'bg-1' dans le fichier global styles.scss, 'bg-1' dans comp1.component.scss et 'bg-1' dans comp2.component.scss.
  • Nous allons voir comment se comporte l'ensemble du projet quand une classe est nommée de façon identique partout.
 
Sélectionnez
1.
2.
3.
4.
ng new angular-scss1
strict ? NO
routing ? YES
SCSS
 
Sélectionnez
1.
2.
3.
ng g c comp1
ng g c comp2
ng g c comp3

app.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
<app-comp1></app-comp1>
<hr>
<app-comp2></app-comp2>
<hr>
<app-comp3></app-comp3>

/src/styles.scss

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
.bg-global-almond {
  padding: 12px;
  background: blanchedalmond;
}

.bg-1 {
  padding: 12px;
  background: magenta;
  color: black;
  border: 1px solid black;
}

/comp1/comp1.component.html

 
Sélectionnez
1.
2.
3.
<p>comp1 works!</p>
<div class="bg-global-almond">classe css : bg-global-almond   du fichier global : /src/style.scss</div>
<div class="bg-1">prise en compte de la classe css : bg-1 du composant : comp1.component.scss</div>

/comp1/comp1.component.scss

 
Sélectionnez
1.
2.
3.
4.
5.
.bg-1 {
  padding: 12px;
  background: blue;
  color: white;
}

XVII-C-1. Remarques pour comp1.component

  • Une classe css : 'bg-1' est définie dans comp1.component.scss.
  • Il a le même nom : 'bg-1' que celui du composant comp2 et également du fichier global styles.scss.
  • Sachez que la classe : 'bg-1' du composant comp1 a la priorité sur celui du global styles.scss

/comp2/comp2.component.html

 
Sélectionnez
1.
2.
3.
<p>comp2 works!</p>

<div class="bg-1">prise en compte de la classe css : 'bg-1' du composant : comp2.component.scss</div>

/comp2/comp2.component.scss

 
Sélectionnez
1.
2.
3.
4.
5.
.bg-1 {
  padding: 12px;
  background: green;
  color: white;
}

XVII-C-2. Remarques pour comp2.component

  • Une classe CSS : 'bg-1' est définie dans : comp2.component.scss.
  • Il a le même nom : 'bg-1' que celui du composant comp1 et du fichier global : styles.scss.
  • Sachez que la classe : 'bg-1' du composant comp2 a la priorité sur celui du global : styles.scss

/comp3/comp3.component.html

 
Sélectionnez
1.
2.
3.
<p>comp3 works!</p>

<div class="bg-1">prise en compte de la classe css : 'bg-1' du fichier global : styles.scss (car 'bg-1' est absent du composant : comp3.component.scss)</div>

/comp3/comp3.component.scss

XVII-C-3. Remarques pour comp3.component

  • Ici, aucune classe CSS : 'bg-1' est définie dans le composant : comp3.component.scss.
  • Résultat : c'est la classe CSS : 'bg-1' du fichier global : styles.scss qui est prise en compte.

XVII-D. Résultat

Plus qu'à constater les résultats à l'écran.

XVII-E. Conclusion

  • La classe CSS du composant a la priorité absolue.
  • Si un composant ne trouve pas la classe CSS dans son fichier… component.scss, alors il va la chercher dans le fichier global styles.scss.

XVIII. Routing

Comment écrire le routing sur un projet Angular ?

XVIII-A. À savoir

  • Quand on parle de routing, on parle de page, on associe une page à une URL.
  • Sachez qu'une page n'est rien de plus qu'un composant (un composant qui est conçu comme une page : son header, son contenu, son footer…).
  • Le routing consiste à associer une URL à un composant (ou page).
  • Quand on demande de changer de page via une URL, c'est sa page (composant) correspondante qui est projetée en avant (et remplace l'ancienne page).
  • Les pages (composants) sont projetées dans la balise : <router-outlet></router-outlet> du composant racine app.component.html.

XVIII-B. Pratique

  • On va voir les principales manières de gérer le routing dans un projet.
 
Sélectionnez
1.
2.
3.
4.
ng new angular-routing1
strict ? NO
routing ? YES
SCSS
 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
ng g c comp1
ng g c comp1/comp11m
ng g c comp1/comp12m
ng g c comp1u
ng g c comp2
ng g c comp3
ng g c page-not-found

XVIII-C. Schéma

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
    app.component.html
      <router-outlet></router-outlet> 
      --------------------------------------------------------------------------------------------------------------------------------------------------------------  
    page comp1                          /comp1                le composant: comp1 sera projeté dans: <router-outlet></router-outlet> de : app.component.html
      <router-outlet></router-outlet>   
                                        /comp1/comp11m        le composant: comp11m sera projeté dans: <router-outlet></router-outlet> de : comp1.component.html
                                        /comp1/comp12m        le composant: comp12m sera projeté dans: <router-outlet></router-outlet> de : comp1.component.html
    page comp1u                         /comp1/comp1u         le composant: comp1u sera projeté dans: <router-outlet></router-outlet> de : app.component.html
    page comp2                          /comp2                le composant: comp2 sera projeté dans: <router-outlet></router-outlet> de : app.component.html
    page comp3                          /comp3/5              le composant: comp3 sera projeté dans: <router-outlet></router-outlet> de : app.component.html

    remarques:
    dans le composant: comp1 on projette soit comp11m avec l'URL : /comp1/comp11, soit : comp12m avec l'url : /comp1/comp12m (pas les 2 en même temps)
    donc ça peut être utile quand on veut obligatoirement associer une zone d'un composant à une URL
    par exemple, on veut qu'un système d'onglets fonctionne ainsi : l'onglet 1 est associé à l'URL : /comp1/comp11m, l'onglet 2 est associé à l'URL : /comp1/comp12m

app-routing.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
import { Routes, RouterModule } from '@angular/router';
import { Comp1Component } from './comp1/comp1.component';
import { Comp2Component } from './comp2/comp2.component';
import { Comp3Component } from './comp3/comp3.component';
import { Comp11mComponent } from './comp1/comp11m/comp11m.component';
import { Comp12mComponent } from './comp1/comp12m/comp12m.component';
import { Comp1uComponent } from './comp1u/comp1u.component';
import { PageNotFoundComponent } from './page-not-found/page-not-found.component';

const routes: Routes = [
  { path: 'comp1', component: Comp1Component,       // comp1 possède des enfants, donc il faudra mettre <router-outlet></router-outlet> dans comp1.component.html
    children: [       
      { path: 'comp11m', component: Comp11mComponent },           // sera projeté dans <router-outlet> de : comp1.component.html
      { path: 'comp12m', component: Comp12mComponent },           // sera projeté dans <router-outlet> de : comp1.component.html
    ]
  },
  { path: 'comp1/comp1u', component: Comp1uComponent },         // une URL à 2 niveaux : /comp1/comp1u associée à un composant
  { path: 'comp2', component: Comp2Component },                 // une URL à 1 niveau : /comp2 associée à un composant
  { path: 'comp3/:comp3Id', component: Comp3Component },        // ':' pour indiquer que c'est une variable qui peut prendre n'importe quelle valeur
  { path: '',   redirectTo: '/comp1', pathMatch: 'full' },      // en l'absence d'URL sur le navigateur, on redirige vers : /comp1
  { path: '**', component: PageNotFoundComponent },             // une route inconnu --> route for a 404 page
];
@NgModule({
  imports: [RouterModule.forRoot(routes)],
  exports: [RouterModule]
})
export class AppRoutingModule { }

app.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
<!-- dans le fichier: app-routing.module.ts il y a l'association: url/composant -->
<!-- donc si on a l'url, on a son composant -->

<nav>
  <ul>
    <li><a [routerLink]="['/comp1']">aller à la page: /comp1</a></li>                        <!-- /comp1, son composant(ou page) sera projeté dans le <router-outlet> du composant racine : app.component.html, donc ici même (voir plus bas) -->

    <li><a [routerLink]="['/comp1/comp11m']">aller à la page mixte : /comp1/comp11m</a></li>  <!-- /comp1, son composant(ou page) sera projeté dans le <router-outlet> du composant racine: app.component.html, donc ici même (voir plus bas) -->
                                                                                      <!-- /comp11m, son composant sera projeté dans le <router-outlet> qui se trouve dans le composant précédent : comp1.component.html (voir fichier) -->

    <li><a [routerLink]="['/comp1/comp12m']">aller à la page mixte : /comp1/comp12m</a></li>  <!-- /comp1, son composant(ou page) sera projeté dans le <router-outlet> du composant racine: app.component.html, donc ici même (voir plus bas) -->
                                                                                      <!-- /comp12m, son composant sera projeté dans le <router-outlet> qui se trouve dans le composant précédent : comp1.component.html (voir fichier) -->

    <li><a [routerLink]="['/comp1/comp1u']">aller à la page : /comp1/comp1u</a></li>          <!-- son composant: comp1u.component sera projeté dans le <router-outlet> du composant racine: app.component.html, donc ici même (voir plus bas) -->

    <li><a [routerLink]="['/comp2']">aller à la page : /comp2</a></li>                        <!-- /comp2, son composant(ou page) sera projeté dans le <router-outlet> du composant racine: app.component.html, donc ici même (voir plus bas) -->

    <li><a [routerLink]="['/comp3/1999']">aller à la page : /comp3/1999 (on passe la valeur 1999)</a></li>  <!-- cette fois, nous passons une valeur dans l'url -->
                                                                                                    <!-- la valeur sera récupérée dans le composant : comp3.component.ts -->

    <li><a [routerLink]="['/comp3', comp3Id]">aller à la page : /comp3/...via variable comp3Id du composant...</a></li>  <!-- comp3Id est une variable du composant actuel: app.component.ts (puisqu'on est dans la page: app.component.html) -->
                                                                                                                        <!-- la valeur de comp3Id sera passée au composant : comp3component.ts -->
  </ul>
</nav>
<button (click)="goToPageComp3()">aller à la page /comp3/...(génère valeur au hasard)...</button>

<hr>

<router-outlet></router-outlet>    <!-- c'est ici que sont injectées les pages -->

app.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppRoutingModule } from './app-routing.module';
import { AppComponent } from './app.component';
import { Comp1Component } from './comp1/comp1.component';
import { Comp11mComponent } from './comp1/comp11m/comp11m.component';
import { Comp12mComponent } from './comp1/comp12m/comp12m.component';
import { Comp2Component } from './comp2/comp2.component';
import { Comp3Component } from './comp3/comp3.component';
import { PageNotFoundComponent } from './page-not-found/page-not-found.component';
import { Comp1uComponent } from './comp1u/comp1u.component';

@NgModule({
  declarations: [
    AppComponent,
    Comp1Component,
    Comp11mComponent,
    Comp12mComponent,
    Comp2Component,
    Comp3Component,
    PageNotFoundComponent,
    Comp1uComponent,
  ],
  imports: [
    BrowserModule,
    AppRoutingModule,            // le fichier du routing
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

app.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
import { Component } from '@angular/core';
import { Router } from '@angular/router';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.scss']
})
export class AppComponent {
  comp3Id = 2024;

  constructor(private router: Router) {}

  goToPageComp3(): void {
    const itemId = Math.floor(Math.random() * Math.floor(2500));

    this.router.navigate(['/comp3', itemId]);
  }
}

/comp1/comp1.component.html

 
Sélectionnez
1.
2.
3.
<h2 style="background: lightsalmon;">comp1 works!</h2>

<router-outlet></router-outlet>           <!-- c'est ici que seront projetés les composants : comp11m.component et comp12m.component -->

/comp1/comp11m/comp11m.component.html

 
Sélectionnez
1.
<h2 style="background: lightcyan;">comp11m works!</h2>

/comp1/comp12m/comp12m.component.html

 
Sélectionnez
1.
<h2 style="background: lightgreen;">comp12m works!</h2>

/comp3/comp3.component.html

 
Sélectionnez
1.
2.
<h2>comp3 works!</h2>
<p>id de l'URL={{id}}</p>

/comp3/comp3.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
import { Component, OnInit } from '@angular/core';    
import { ActivatedRoute } from '@angular/router';

@Component({
  selector: 'app-comp3',
  templateUrl: './comp3.component.html',
  styleUrls: ['./comp3.component.scss']
})
export class Comp3Component implements OnInit {
  id: string;

  constructor(private route: ActivatedRoute) { }        // le package pour gérer la route actuelle, celle qui est activée en ce moment
                                                        // forcément dans ce composant, on est sur l'URL : /comp3/....
  ngOnInit(): void {
    this.route.paramMap.subscribe(params => {           // on souscrit au paramMap de l'objet : route pour accéder à toutes les informations de celui-ci
      this.id = params.get('comp3Id');                  // on récupère : comp3Id que l'on affecte à id pour qu'il soit visible dans la vue
    });
  }
}

XVIII-D. Conseils

  • Tout comme avec les modules, quand on touche au routing il vaut mieux relancer la commande : ng serve

XIX. Formulaires

Pour une gestion des formulaires, on utilise le formBuilder pour créer des formulaires et lui associer des champs.
Ensuite, dans la vue, les champs input sont liés aux champs définis dans le contrôleur ci-dessus.

  • formBuilder est le créateur de formulaire.
  • FormGroup est l'objet qui représente un formulaire.
  • FomControl est l'objet qui représente un champ.
  • validator est une contrainte de validation.

XIX-A. Les formulaires + la gestion des erreurs + Angular Material

Le projet consiste à créer un formulaire d'enregistrement classique avec l'affichage des messages d'erreurs.

XIX-A-1. Principes de base

Côté contrôleur :

  • un objet : FormGroup peut contenir des objets FormControl et aussi d'autres objets : FormGroup
  • un objet : FormControl est un champ sur lequel on peut lui appliquer un validator
 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
myForm: FormGroup; 
...
...
this.myForm = this.formBuilder.group({                                      
    mycontrol1: ['', Validators.required],                                             
    mycontrol2: [''],

    // pour l'exemple : avec mynested1 on imbrique un formulaire dans un autre (nested1 dans myForm)
    mynested1: this.formBuilder.group({               //  pour cela, on mentionne un noeud 'mynested1' de type FormGroup
        mycontrol11: ['', Validators.required],     
        mycontrol12: [''],             
    })
});
...
onSubmit() {
...

Côté vue :

  • la balise <form> est le formGroup ;
  • chaque champ input de la vue est lié à un champ FormControl du FormGroup par la directive : formControlName.
 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
<form [formGroup]="myForm" (ngSubmit)="onSubmit()">
    <input formControlName = "mycontrol1">
    <input formControlName = "mycontrol2">

    <div formGroupName="mynested1">                 <!-- c'est important de mentionner le noeud d'imbrication : 'mynested1' -->
        <input formControlName = "mycontrol11">
        <input formControlName = "mycontrol12">
    </div>

    <button type="submit">Valider</button>
</form>

XIX-A-2. Pratique

 
Sélectionnez
1.
2.
3.
4.
ng new angular-form1
strict ? NO
routing ? NO
SCSS

Histoire d'avoir un joli formulaire, utilisons le package angular material.

 
Sélectionnez
1.
2.
3.
ng add @angular/material
- styles ? NO
- animations ? NO
 
Sélectionnez
1.
2.
3.
ng g m register --module=app
ng g c register/form-register --module=register
ng g m shared/material-design --module=register

/shared/material-design.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
import { NgModule } from '@angular/core';                
import { CommonModule } from '@angular/common';
// Material
import { MatGridListModule } from '@angular/material/grid-list';
import { MatInputModule } from '@angular/material/input';
import { MatButtonModule } from '@angular/material/button';
import { NoopAnimationsModule } from '@angular/platform-browser/animations';
import { MatFormFieldModule } from '@angular/material/form-field';
import { MatCheckboxModule } from '@angular/material/checkbox';

@NgModule({
  declarations: [],
  imports: [
    CommonModule,

    MatFormFieldModule,               // on importe uniquement les composants dont on a besoin
    MatGridListModule,                // inutile de tout importer
    NoopAnimationsModule,
    MatInputModule,
    MatButtonModule,
    MatCheckboxModule,

  ],
  exports: [
    MatFormFieldModule,               // ne pas oublier d'exporter pour qu'il puisse être importé dans le module qui le demande
    MatGridListModule,
    NoopAnimationsModule,
    MatInputModule,
    MatButtonModule,
    MatCheckboxModule,

  ]
})
export class MaterialDesignModule { }

app.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';
import { RegisterModule } from './register/register.module';

@NgModule({
  declarations: [
    AppComponent,
  ],
  imports: [
    BrowserModule,
    RegisterModule,                           // on importe le module register pour pouvoir utiliser son composant : form-register.component
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

app.component.html

 
Sélectionnez
1.
<app-form-register></app-form-register>

/register/register.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
import { NgModule } from '@angular/core';
import { CommonModule } from '@angular/common';
import { FormRegisterComponent } from './form-register/form-register.component';
import { ReactiveFormsModule } from '@angular/forms';
import { MaterialDesignModule } from '../shared/material-design/material-design.module';
import { NoopAnimationsModule } from '@angular/platform-browser/animations';

@NgModule({
  declarations: [FormRegisterComponent],
  imports: [
    CommonModule,
    ReactiveFormsModule,          // IMPORTANT : le module Angular pour les formulaires
                                  // si vous utilisez les formulaires dans plusieurs composants
                                  // vous pouvez importer ce module à un niveau plus haut, par exemple dans : app.module.ts
                                  // car il faut éviter d'importer un module dans plusieurs endroits

    MaterialDesignModule,         // le module material de : /shared/material-design/material-design.module.ts
    NoopAnimationsModule,         // pas d'animation
  ],
  exports: [
    FormRegisterComponent,        // on exporte le composant pour qu'il soit disponible à la racine (qui va l'importer)
  ]
})
export class RegisterModule { }

/register/validators/must-match.validator.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
import { FormGroup } from '@angular/forms';

export function MustMatchValidator(controlName: string, matchingControlName: string) {       // correspond aux champs: password et confirmPassword
    return (formGroup: FormGroup) => {
        const control = formGroup.controls[controlName];                            // password
        const matchingControl = formGroup.controls[matchingControlName];            // confirmPassword

        if (matchingControl.errors && !matchingControl.errors.mustMatch) {    // si déjà trouvé une erreur ailleurs dans un autre champ
            return;                                                           // alors pas besoin d'analyser le contrôle des mots de passe
        }

        if (control.value !== matchingControl.value) {                        // si les 2 mots de passe ne correspondent pas
            matchingControl.setErrors({ mustMatch: true });                   // il y a une erreur
        } else {
            matchingControl.setErrors(null);                                  // sinon il n'y a pas d'erreur
        }
    }
}

/register/form-register/form-register.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
86.
87.
88.
89.
90.
91.
92.
93.
94.
95.
96.
97.
98.
99.
100.
101.
102.
103.
104.
105.
106.
107.
108.
109.
110.
111.
112.
113.
114.
115.
116.
117.
118.
119.
120.
121.
<p>register-form works!</p>

<!--    version simplifiée (sans le design du material)

<form [formGroup]="registerForm" (ngSubmit)="onSubmit()">
  <div formGroupName="identity">
    <select formControlName = "title">
      <option value="mr">Mr</option>
      <option value="mme">Mme</option>
    </select>
    <input formControlName = "lastName">
    <input formControlName = "firstName">
  </div>

  <input formControlName = "email">
  <input formControlName = "password">
  <input formControlName = "confirmPassword">

  <button type="reset" (click)="onReset()">Annuler</button>
  <button type="submit">S'enregistrer</button>
</form>

-->

<form [formGroup]="registerForm" (ngSubmit)="onSubmit()">           <!-- IMPORTANT: indiquer le formulaire de base qui englobe tous les champs -->

  <div id="container">                      <!-- FLEXBOX (voir le fichier .scss) -->

    <div class="bloc">                      <!-- 1er élément de FLEXBOX (bloc à gauche) -->
      <div formGroupName="identity">        <!-- IMPORTANT : indiquer le noeud d'une imbrication du formulaire -->
              <div>
                <mat-form-field appearance="fill">
                  <mat-label>Civilité</mat-label>
                  <select matNativeControl formControlName = "title" [ngClass]="{ 'is-invalid': submitted && f_identity.title.errors }">
                    <option value="mr">Mr</option>
                    <option value="mme">Mme</option>
                  </select>
                  <mat-error *ngIf="submitted && f_identity.title.errors" class="invalid-feedback">
                    <div *ngIf="f_identity.title.errors.required">La civilité est <strong>obligatoire</strong></div>
                  </mat-error>
                </mat-form-field>
              </div>

              <div>
                <mat-form-field appearance="fill" class="example-full-width">
                  <mat-label>Nom</mat-label>
                  <input matInput placeholder = "Entrez votre nom" formControlName = "lastName" class="form-control" [ngClass]="{ 'is-invalid': submitted && f_identity.lastName.errors }">
                  <mat-error *ngIf="submitted && f_identity.lastName.errors" class="invalid-feedback">
                    <div *ngIf="f_identity.lastName.errors.required">Le nom est <strong>obligatoire</strong></div>
                  </mat-error>
                </mat-form-field>
              </div>

              <div>
                <mat-form-field appearance="fill" class="example-full-width">
                  <mat-label>Prénom</mat-label>
                  <input matInput placeholder = "Entrez votre prénom" formControlName = "firstName" class="form-control" [ngClass]="{ 'is-invalid': submitted && f_identity.firstName.errors }">
                  <mat-error *ngIf="submitted && f_identity.firstName.errors" class="invalid-feedback">
                    <div *ngIf="f_identity.firstName.errors.required">Le prénnom est <strong>obligatoire</strong></div>
                  </mat-error>
                </mat-form-field>
              </div>
      </div>
    </div>

    <div class="bloc">                   <!-- 2ème élément de FLEXBOX (bloc à droite) -->
            <div>
              <mat-form-field appearance="fill" class="example-full-width">
                <mat-label>email</mat-label>
                <input matInput placeholder = "Entrez votre email" formControlName = "email" class="form-control" [ngClass]="{ 'is-invalid': submitted && f.email.errors }">
                <mat-error *ngIf="submitted && f.email.errors" class="invalid-feedback">
                  <div *ngIf="f.email.errors.required">L'email est <strong>obligatoire</strong></div>
                  <div *ngIf="f.email.errors.email">L'email doit être dans un format valide</div>
                </mat-error>
              </mat-form-field>
            </div>

            <div>
              <mat-form-field appearance="fill" class="example-full-width">
                <mat-label>Password</mat-label>
                <input matInput #password placeholder = "mot de passe" formControlName = "password" class="form-control" [ngClass]="{ 'is-invalid': submitted && f.password.errors }">
                <mat-hint>{{password.value?.length || 0}} caractère(s) (6 minimum)</mat-hint>
                <mat-error *ngIf="submitted && f.password.errors" class="invalid-feedback">
                  <div *ngIf="f.password.errors.required">Le mot de passe est <strong>obligatoire</strong></div>
                  <div *ngIf="f.password.errors.minlength">Le mot de passe doit contenir au moins 6 caractères</div>
                </mat-error>
              </mat-form-field>
            </div>

            <div>
              <mat-form-field appearance="fill" class="example-full-width">
                <mat-label>Confirme Password</mat-label>
                <input matInput placeholder = "confirmation" formControlName = "confirmPassword" class="form-control" [ngClass]="{ 'is-invalid': submitted && f.confirmPassword.errors }">
                <mat-error *ngIf="submitted && f.confirmPassword.errors" class="invalid-feedback">
                  <div *ngIf="f.confirmPassword.errors.required">La confirmation est <strong>obligatoire</strong></div>
                  <div *ngIf="f.confirmPassword.errors.mustMatch">Les mots de passe sont différents</div>
                </mat-error>
              </mat-form-field>
            </div>

            <div style="height: 24px;"></div>

            <div>
              <mat-checkbox id="acceptTerms" formControlName = "acceptTerms">Check me!</mat-checkbox>
              <mat-error *ngIf="submitted && f.acceptTerms.errors" class="invalid-feedback">
                <div *ngIf="f.acceptTerms.errors.required">Vous devez <strong>accepter</strong> les termes</div>
              </mat-error>
            </div>

            <div style="height: 24px;"></div>

            <div>
              <button mat-raised-button color="accent" type="reset" (click)="onReset()">Annuler</button>
              &nbsp;
              <button mat-raised-button color="primary" type="submit">S'enregistrer</button>
            </div>
    </div>

  </div>

</form>

/register/form-register/form-register.component.scss

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
#container {
  display: flex;
  justify-content: center;
}

.bloc {
  margin: 24px;
}

/register/form-register/form-register.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
import { Component, OnInit } from '@angular/core';
import { FormBuilder, FormGroup, Validators } from '@angular/forms';
import { MustMatchValidator } from '../validators/must-match.validator';   // import un validator personnalisé

@Component({
  selector: 'app-form-register',
  templateUrl: './form-register.component.html',
  styleUrls: ['./form-register.component.scss']
})
export class FormRegisterComponent implements OnInit {

  registerForm: FormGroup;          // le groupe de champs pour la vue
  submitted = false;                // un indicateur pour savoir si le formulaire à été soumis ou pas

  constructor(private formBuilder: FormBuilder) { }

  ngOnInit(): void {        // c'est dans ngOnInit, qu'on initialise les données nécessaires au bon fonctionnement du composant
                            // ngOnInit est appelé qu'une seule fois et avant l'affichage de la vue

      this.registerForm = this.formBuilder.group({                              // registerForm = contient des FormControl et FormGroup
                                                                                // et on indique les validations sur les champs si besoin
        identity: this.formBuilder.group({                                      // une imbrication de formulaire avec un noeud de type : FormGroup nommé : 'identity'
            title: ['', Validators.required],
            firstName: ['', Validators.required],
            lastName: ['', Validators.required],
        }),

        email: ['', [Validators.required, Validators.email]],
        password: ['', [Validators.required, Validators.minLength(6)]],
        confirmPassword: ['', Validators.required],
        acceptTerms: ['', Validators.requiredTrue]
      }, {                                                      // on met ici les validators personnalisés pour analyser la validité de plusieurs champs
          validator: MustMatchValidator('password', 'confirmPassword')   // un validator personnalisé:   (voir /register/validators/must-match.validator.ts)
                                                                // qui permet de comparer les 2 champs: 'password' et 'confirmPassword' si identique ou pas ?
      });

      this.registerForm.get('identity.lastName').setValue('heisenberg');  // on initialise le champs: lastName avec la valeur: 'heisenberg'

      this.registerForm.valueChanges.subscribe((formValues: any) => { // si le formulaire est modifié (quel que soit le champ)
        console.log(formValues);                                      // on affiche dans la console le formulaire entier
      });

      this.registerForm.get('identity.lastName').valueChanges.subscribe((lastName: string) => {   // si le champ: lastName est modifié
        console.log(lastName);                                                           // on affiche dans la console la valeur du champ
      });
  }

  get f_identity() {                                                // astuce: un raccourci pour la vue
    return this.registerForm['controls']['identity']['controls'];   // au lieu d'écrire à chaque fois: registerForm['controls']['identity']['controls']
                                                                    // on écrit à la place : f_identity
  }

  get f() {                                     // astuce: un raccourci pour la vue
    return this.registerForm.controls;          // au lieu d'écrire à chaque fois: registerForm.controls
                                                // on écrit à la place : f
  }

  onSubmit(): void {                        // à la soumission du formulaire, clique sur le bouton: "s'enregistrer"
      this.submitted = true;

      // on arrête ici si le formulaire est invalide
      if (this.registerForm.invalid) {      // s’il y a une erreur, le formulaire est invalide
          return;
      }

      // affiche une alerte avec le contenu du formulaire en json
      alert('SUCCESS!! :-)\n\n' + JSON.stringify(this.registerForm.value, null, 4));
  }

  onReset(): void {                 // clique sur le bouton: "annuler"
      this.submitted = false;
      this.registerForm.reset();    // on efface tout le formulaire
  }
}

XIX-B. Les formulaires dynamiques

Avec les formulaires dynamiques, on peut leur ajouter des champs et en supprimer.

XIX-B-1. Principes de base

Avec FormArray on peut lui ajouter des champs (FormControl) ou des groupes de champs (FormGroup).

XIX-B-2. Remarques

Dans cet exemple, nous ne nous occupons pas du design ni des erreurs.

XIX-B-3. Pratique

  • on crée à la volée un certain nombre de champs.
  • cliquer sur le bouton '+' pour ajouter un nouveau champ.
  • cliquer sur le bouton '-' pour supprimer un champ.

Dans le même projet que le précédent, on va créer un nouveau composant :

 
Sélectionnez
1.
2.
3.
cd angular-form1

ng g c dynamic-form1 --module=app

On ajoute le module ReactiveFormsModule dans app.module.ts
En effet, le composant dynamic-form1 n'a pas de module, donc il remonte au niveau supérieur pour en trouver un, et dans la hiérarchie c'est app.module

app.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
import { AppComponent } from './app.component';
import { RegisterModule } from './register/register.module';
import { ReactiveFormsModule } from '@angular/forms';
import { MaterialDesignModule } from './shared/material-design/material-design.module';
import { DynamicForm1Component } from './dynamic-form1/dynamic-form1.component';

@NgModule({
  declarations: [
    AppComponent,
    DynamicForm1Component,      // le formulaire dynamique
  ],
  imports: [
    BrowserModule,
    RegisterModule,             // on importe le module register pour pouvoir utiliser son composant: form-register.component
    ReactiveFormsModule,        // le module Angular pour les formulaires
    MaterialDesignModule,
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

app.component.html

 
Sélectionnez
1.
2.
3.
<app-form-register></app-form-register>
<hr>
<app-dynamic-form1></app-dynamic-form1>

/dynamic-form1/dynamic-form1.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
<p>dynamic-form1 works!</p>

<form [formGroup]="myForm" (ngSubmit)="onSubmit()">

  <input type="text" formControlName = "name" placeholder = "name">

  <div formArrayName="items">
    <div *ngFor="let item of items.controls; let i=index" class="bg-item">  <!-- comme c'est un tableau on peut définir un index -->
      <input type="text" [formControlName] = "i">                           <!-- et nommer le name de l'input avec le numéro d'index -->

      <button (click)="removeItem(i)"><b>-</b></button>
    </div>
  </div>

  <button (click)="addItem()"><b>+</b></button>
  <button type="submit">Valider</button>
</form>

/dynamic-form1/dynamic-form1.component.scss

 
Sélectionnez
1.
2.
3.
.bg-item {
  margin: 6px;
}

/dynamic-form1/dynamic-form1.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
import { Component, OnInit } from '@angular/core';
import { FormBuilder, FormGroup, Validators, FormArray, FormControl } from '@angular/forms';

@Component({
  selector: 'app-dynamic-form1',
  templateUrl: './dynamic-form1.component.html',
  styleUrls: ['./dynamic-form1.component.scss']
})
export class DynamicForm1Component implements OnInit {

  myForm: FormGroup;

  constructor(private formBuilder: FormBuilder) { }

  ngOnInit(): void {

    this.myForm = this.formBuilder.group({
      name: new FormControl('', [Validators.required]),
      items: new FormArray([])                            // contenir les nouveaux champs
    });

    for (let i=0; i<2; i++) {                             // on ajoute pour l'exemple 2 champs
      this.addItem();
    }
  }

  get items() {
    return this.myForm.get("items") as FormArray;
  }

  onSubmit() {
    alert(JSON.stringify(this.myForm.value));
  }

  addItem() {
    const arrForm = this.myForm['controls'].items as FormArray;         // le contenu de : this.myForm['controls'].items est un simple tableau d'objets
                                                                        // on veut pouvoir accéder aux méthodes : push(), removeAt() qui se trouvent dans FormArray
                                                                        // donc on caste le contenu avec 'as FormArray'

    arrForm.push(                                                       // arrForm est du type FormArray donc on peut faire appel à sa méthode push()
      new FormControl('', [Validators.required])
    );

    return false;
  }

  removeItem(index: number) {
    const arrForm = this.myForm['controls'].items as FormArray;
    arrForm.removeAt(index);
  }
}

XX. Les filtres (PIPES)

  • Dans la vue, on veut pouvoir formater ou appliquer un petit traitement sur les données que l'on affiche.
  • Pour cela, Angular propose certains filtres (pipes).
  • Mais il est possible de créer ses propres filtres personnalisés.

XX-A. Pratique

 
Sélectionnez
1.
2.
3.
4.
ng new angular-pipe1
strict ? NO
routing ? NO
SCSS
 
Sélectionnez
1.
2.
3.
ng g p pipes/only-valid
ng g p pipes/low-price
ng g p pipes/new-collection

app.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';
import { OnlyValidPipe } from './pipes/only-valid.pipe';
import { LowPricePipe } from './pipes/low-price.pipe';
import { NewCollectionPipe } from './pipes/new-collection.pipe';

@NgModule({
  declarations: [
    AppComponent,
    OnlyValidPipe,          // les filtres doivent être déclarés
    LowPricePipe ,          //
    NewCollectionPipe,
  ],
  imports: [
    BrowserModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

app.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
<h1>filtres Angular</h1>
<p>(1) now={{now}}</p>
<p>(1) now={{now | date:"dd/MM/yyyy"}}</p>
<p>(2) text1={{text1 | uppercase}}</p>
<p>(3) value1={{value1 | currency:'EUR'}}</p>
<p>(4) object1={{object1 | json | uppercase}}</p>

<hr>

<h1>filtres personnalisés</h1>
<h3>(5) listObject1 avec le filtre personnalisé : onlyValid (est valide)</h3>
<ul>
  <li *ngFor="let obj of listObject1 | onlyValid">{{obj|json}}</li>                       <!-- filtre perso sur : est valide -->
</ul>

<h3>(5) listObject1 avec le filtre personnalisé : lowPrice  (est valide et prix <= 20)</h3>
<ul>
  <li *ngFor="let obj of listObject1 | lowPrice:20:true">{{obj|json}}</li>                <!-- filtre perso sur le prix est <= 20 et qui est valide -->
</ul>

<h3>(5) listObject1 avec 2 filtres personnalisés : lowPrice et newCollection</h3>
<ul>
  <li *ngFor="let obj of listObject1 | lowPrice:20:true | newCollection: true">{{obj|json}}</li>  <!-- utilisation de 2 filtres -->
</ul>

app.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
import { Component } from '@angular/core';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.scss']
})
export class AppComponent {
  now = Date();                             // (1)
  text1 = 'hello world';                    // (2)
  value1 = 105.90;                          // (3)
  object1 = { name: 'toto', job: 'dev'};    // (4)
  listObject1 = [                           // (5)
    {name: 'objet1', valid: false, price: 49.90, newCollection: false, },
    {name: 'objet2', valid: true,  price: 19.90, newCollection: true, },
    {name: 'objet3', valid: true,  price: 79.20, newCollection: false, },
  ];
}

/pipes/only-valid.pipe.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
import { Pipe, PipeTransform } from '@angular/core';                
@Pipe({
  name: 'onlyValid'
})
export class OnlyValidPipe implements PipeTransform {

  transform(values: any, args?: any): any {

    return values.filter((value: any) => value.valid);        // filtre sur la propriété valid qui doit être à true
  }
}

/pipes/low-price.pipe.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
import { Pipe, PipeTransform } from '@angular/core';

@Pipe({
  name: 'lowPrice'
})
export class LowPricePipe implements PipeTransform {

  transform(values: any, args1: number, args2: boolean): any {  // utilisation dans la vue : | lowPrice:20:true
    const price = args1;                                        // attention à l'ordre : 20 est args1 et true est args2
    const valid = args2;                                        //

    if (price && valid) {
      return values.filter((value: any) => value.valid === valid && value.price <= price);        // filtre sur la propriété valid qui doit être à true
    }
    return;
  }
}

/pipes/new-collection.pipe.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
import { Pipe, PipeTransform } from '@angular/core';

@Pipe({
  name: 'newCollection'
})
export class NewCollectionPipe implements PipeTransform {

  transform(values: any, args1: number): any {
    const newCollection = args1;
    return values.filter((value: any) => value.newCollection === newCollection);        // filtre sur la propriété newCollection
  }

}

XX-B. Résultat

 
Sélectionnez
1.
ng serve

XX-C. Conclusion

  • Pour un maximum de performances, il faut privilégier les filtres Angular et des filtres personnalisés.

XXI. Les directives

XXI-A. Description

  • les directives sont un moyen très puissant pour manipuler des balises, il faut toujours privilégier cette technique dans votre développement ;
  • ils permettent de développer des fonctionnalités dynamique via du code (au lieu de mettre le code directement dans la vue);
  • par exemple, on voudrait mettre en vert un article si l'utilisateur connecté est l'auteur, en gris s'il est admin et normal pour le reste. En plus de cela, on voudrait ajouter un bouton d'édition s'il est l'auteur. On pourrait faire ça directement dans la vue avec un système de IF, et si on avait besoin de l'utiliser dans une autre page ? On se retrouverait vite avec du code html complexe. Bien sur, on pourrait résoudre ça via des composants, c'est parfaitement valable mais les directives sont vraiment spécialisés dans cette tâche et donc, profitons en. De plus sachez, qu'une directive est en réalité rien d'autre qu'un composant sans la vue (puisqu'on manipule la vue via le code).

mais encore :

  • avec une directive, on peut agir grace a du code sur une balise, on pourra ainsi modifier son style, ajouter une classe, ajouter une balise, du texte... tout est possible ;
  • dans une directive, on peut aussi réagir à des évenements (clics...) ;
  • il existe deux types de directives, chacune spécialisé dans une tâche :

    • la directive d'attribut : pour gérer le style, les classes ;
    • la directive structurelle : pour gérer la structure du DOM, ajouter des balises, la faire apparaitre ou pas...
  • mais sachez que, si besoin, rien n'empeche de gérer également le style ou les classes dans une directive structurelle ;
  • la différence est que la directive d'attribut et structurelle aborde la balise sur laquelle elle est appliqué d'une manière différente :

    • avec une directive d'attribut : on accède directement à la balise (pour la modifier) sur laquelle la directive est appliqué ;
    • avec une directive structurelle : on obtient une representation virtuelle de la balise (pour la manipuler) sur laquelle la directive est appliqué. Elle n'apparait donc pas à l'écran, c'est le code qui va décider ce que l'on va en faire ;

XXI-B. Théorie

XXI-B-1. La directive d'attribut

remarques :

 
Sélectionnez
1.
2.
3.
4.
5.
6.
<p appDirective1="toto"></p>        // sans les crochets   toto est considéré comme du texte.
                                    // attention : on ne peut pas faire réference à une variable JavaScript
<p [appDirective1]="'toto'"></p>    // avec les crochets, c'est interpreté en JavaScript donc il faut mettre des accolades
<p [appDirective1]="message"></p>   // avec les crochets, c'est interpreté en JavaScript donc on peut y mettre une variable (venant de son composant)
    ...components.ts
      message = 'tutu';

utilisation d'une directive sur la balise p

 
Sélectionnez
1.
2.
3.
4.
<p [appArticleBg]="'toto'" otherParam="'tutu'">
  <span>un article</span>
  <span>le contenu de la balise</span>
</p>

app-article-bg.directive.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
...
@Directive({
  selector: '[appArticleBg]'                    // appArticleBg : le nom de la directive à utiliser dans la vue
})
export class AppArticleBgDirective {

  @Input() appArticleBg: string;    // "toto"
  @Input() otherParam: string;      // "tutu"

  constructor(
    private el: ElementRef,     // l'élément du DOM sur lequel la directive est appliqué, ici c'est l'élément de la balise p

    ...,                        // utiliser l'injection de dépendance 
    ...,                        // pour accèder à des services si besoin
  ) { }

  @HostListener('click') onClick() {   // un écouteur sur le clic est positionné sur l'élément
    //
    //  on fait un traitement ici si un clic se produit sur l'élément
    //  
  }

  ngOnInit() {
    // ici on fait le traitement initial que l'on souhaite
    // si besoin, on utilise les paramètres d'entrées  appArticleBg et otherParam
    // si besoin, on utilise les services du constructeur
    // on agit sur el (qui représente la balise p et son contenu)
    // el est un arbre de noeud, il contient :
    //     le noeud d'origine : p
    //        qui contient : le noeud span (le 1er span) 
    //        qui contient : le noeud span (le 2eme span)
    // on peut donc agir sur n'importe quel noeud :      
    //    - en modifiant son apparence (style, classe)
    //    - en lui ajoutant du texte, des données ou d'autres noeuds (balises)

    console.log(this.el.nativeElement);  // pour voir l'arbre du noeud p
  }
}

XXI-B-2. La directive structurelle

  • on met une * pour une directive structurelle
  • la balise de la directive structurelle et son contenu n'est pas affiché, c'est une représentation virtuelle que l'on va se servir dans le code de la directive.
  • la balise de la directive structurelle est aussi un contenant ou un emplacement, avec cette representation virtuelle si besoin on va modifier son apparence, son contenu et ceci une fois fait, on va l'inserer ici à cet emplacement et ce, une fois ou même plusieurs fois si besoin. Tout est possible.

utilisation :

 
Sélectionnez
1.
2.
3.
<div *appUnless="condition">
  Show this sentence unless the condition is true.
</div>
 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
...
@Directive({ selector: '[appUnless]'})
export class UnlessDirective {
  private hasView = false;

  constructor(
    private templateRef: TemplateRef<any>,      // la representation virtuelle 
    private viewContainer: ViewContainerRef,    // le contenant (ou emplacement)

    ...,                        // utiliser l'injection de dépendance 
    ...,                        // pour accèder à des services si besoin    
  ) { }

  @Input() set appUnless(condition: boolean) {
    //  accès aux données input
    //  accès aux services du constructeur
    //
    //  traitement de la representation virtuelle : templateRef
    //    - en modifiant son apparence (style, classe)
    //    - en lui ajoutant du texte, des données ou d'autres noeuds (balises)
    //
    //  ajout de templateRef dans le contenant : viewContainer
    //  c'est à ce moment que le templateRef apparait à l'écran
    //
  }
}

XXI-C. Pratique

XXI-C-1. La directive d'attribut

  • les directives d'attributs permettent de manipuler le CSS.
  • ngClass, ngStyle sont des directives d'attributs Angular.
  • on peut créer ses propres directives d'attributs.
  • il faut utiliser le plus possible cette fonctionnalité dans un projet, car c'est très puissant et ça permet d'avoir un impact visuel réduit dans le code de la vue.
XXI-C-1-a. Pratique
  • dans la 1re partie, nous allons voir plusieurs manières d'utiliser les directives Angular : ngStyle, style, ngClass, class.
  • dans la 2e partie, nous allons créer une directive d'attribut personnalisée.
 
Sélectionnez
1.
2.
3.
4.
5.
6.
ng new angular-directives-attributes1
strict ? NO
routing ? NO
SCSS

ng g d directives/highlight

app.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';
import { HighlightDirective } from './directives/highlight.directive';

@NgModule({
  declarations: [
    AppComponent,
    HighlightDirective,       // comme les composants, les directives doivent être déclarées pour être utilisées
  ],
  imports: [
    BrowserModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

app.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
<h1>PARTIE 1: ATTRIBUTES DIRECTIVES ANGULAR</h1>

<h2>ngStyle</h2>

<p>(1) appliquer plusieurs styles</p>
<div [ngStyle]="{'background-color': 'yellow', 'color': 'blue'}">"message in a bottle" (The police)</div>
<hr>

<p>(2) appliquer un style précis</p>
<div [style.color]="'red'">"C'est pas ma guerre !" (Rambo)</div>
<hr>

<p>(3) changer un style précis suivant une condition</p>
<button (click)="changeStyle3()">changer le style - flag3={{flag3}}</button>
<div [style.color]="flag3 ? colorA : colorB">"C'est des malades !" (Les visiteurs)</div>      <!-- flag3=true ou false. si true -> la classe : colorA sinon la classe : colorB -->

<hr>
<h2>NgClass</h2>

<p>(4) appliquer simplement une classe</p>
<div [className]="'maClasse4'">"Luke, je suis ton père…" (Dark vador)</div>       <!--  voir la classe: maClasse4 dans : app.component.css -->
<div [className]="dataClasse4">"Luke, je suis ton père…" (Dark vador)</div>       <!--  voir la variable dataClasse4 dans : app.component.ts qui contient la classe -->
<hr>

<p>(5) (une condition)? 'classeX' : 'classeY"</p>
<button (click)="this.flag5 = !this.flag5">changer la classe - flag5={{flag5}}</button>
<div [className]="(flag5) ? 'maClasse51' : 'maClasse52'">"J’ai les mains faites pour l’or, et elles sont dans la merde !" (Scarface)" </div>
<hr>

<p>(6) une classe précise, (une condition)?</p>
<button (click)="changeClasse6()">changer la classe - flag6={{flag6}}</button>
<div [class.maClasse6]="flag6">"On se serait shooté à la vitamine C si cela avait été illégal" (Trainspotting )</div>
<hr>

<p>(7) plusieurs classes, plusieurs (conditions)?</p>
<button (click)="flag71 = !flag71">changer la 1re condition - flag71={{flag71}}</button>
<button (click)="flag72 = !flag72">changer la 2e condition - flag72={{flag72}}</button>
<div [ngClass]="{'maClasse71': flag71 == flag72, 'maClasse72': !flag71 && !flag72}">"C’est à moi que tu parles ? C’est à moi que tu parles ??..." (Taxi driver)</div>

<hr>
<hr>

<h1>PARTIE 2 : ATTRIBUTES DIRECTIVES PERSONNALISES</h1>

<p>(8) <span appHighlight>"survolez-moi!" - par défaut</span></p>
<p>(9) <span [appHighlight]="'pink'">"survolez moi!" - en précisant directement une couleur</span></p>
<p>(10) <span [appHighlight]="color">"survolez-moi!" - en précisant une couleur défini dans le contrôleur</span></p>
<br><br><br>

app.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
import { Component } from '@angular/core';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.scss']
})
export class AppComponent {
  flag3 = false;                  // (3)
  colorA = 'darkblue';            // (3)
  colorB = 'darkslategrey';       // (3)
  //
  dataClasse4 = 'maClasse4';      // (4)
  //
  flag5 = false;                  // (5)
  //
  flag6 = false;                  // (6)
  //
  flag71 = false;                 // (7)
  flag72 = false;                 // (7)
  //
  color = 'yellow';                // (10)

  changeStyle3() {                 // (3)
    this.flag3 = !this.flag3;
  }

  changeClasse6() {                // (6)
    this.flag6 = !this.flag6;
  }
}

app.component.css

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
.maClasse4 {
  border: 1px solid red;
}
.maClasse51 {
  background: dodgerblue;
}
.maClasse52 {
  background: gold;
}
.maClasse6 {
  color: darkred;
}
.maClasse71 {
  background: red;
  color: white;
}
.maClasse72 {
  background: green;
  color: white;
}

/directives/highlight.directive.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
import { Directive, ElementRef, HostListener, Input } from '@angular/core';

@Directive({
  selector: '[appHighlight]'
})
export class HighlightDirective {

  constructor(private el: ElementRef) {
    console.log(el);                                        // allez voir dans la console l'élément
  }

  @Input('appHighlight') highlightColor: string;            // @Input -> récupère les données passées à la directive de la vue: [appHighlight]="...données..."

  @HostListener('mouseenter') onMouseEnter() {              // l'événement : 'mouseenter' qui correspond au survol de la balise sur laquelle est appliquée la directive
    this.highlight(this.highlightColor || 'red');           // prend d'abord le 1er paramètre : this.highlightColor
  }                                                         // si celui-ci est vide: 'undefined' alors par défaut il prend le 2e : 'red'

  @HostListener('mouseleave') onMouseLeave() {              // l'événement : 'mouseleave'
    this.highlight(null);
  }

  private highlight(color: string) {
    this.el.nativeElement.style.backgroundColor = color;    //  on met à jour le background de l'élément sur lequel est appliquée la directive
  }
}
XXI-C-1-b. À savoir
 
Sélectionnez
1.
constructor(private el: ElementRef) {

Dans le constructeur, on peut utiliser l'injection de dépendance pour récupérer n'importe quels services ou packages dont on peut avoir besoin dans la directive.

el: représente le DOM de l'élément (HTML ou composant) sur lequel la directive est appliquée

 
Sélectionnez
1.
this.el.nativeElement.

pour accéder à la lecture ou à la modification de l'élément (HTML ou composant)

 
Sélectionnez
1.
@Input()

pour récupérer des données passées en paramètre de la directive

 
Sélectionnez
1.
@HostListener

pour gérer les événements de l'élément (HTML ou composant).

XXI-C-1-c. Conclusion
  • les directives d'attributs sont un moyen puissant pour gérer le style CSS d'un élément (HTML ou composant)/.
  • en mettant une directive [appHighlight]="color" sur un élément : span, on peut faire beaucoup de choses sans surcharger la vue <span [appHighlight]="color">survolez-moi!</span>.
  • il faut toujours privilégier l'utilisation des directives.

XXI-C-2. La directive structurelle

  • une directive structurelle permet de modifier la structure du DOM sous certaines conditions et/ou en fonction de certaines valeurs.
  • *ngIf est une directive structurelle Angular qui modifie le DOM (ajoute un bout de DOM ou pas en fonction d'une condition).
  • *ngFor est une directive structurelle Angular qui modifie le DOM en lui ajoutant des bouts de DOM l'un à la suite de l'autre.
  • on peut créer ses propres directives structurelles.
  • il faut utiliser le plus possible cette fonctionnalité dans un projet, car c'est très puissant et ça permet d'avoir un impact visuel réduit dans le code de la vue.
XXI-C-2-a. Pratique
  • on va créer deux directives :
  • une directive pour indiquer si on est authentifié ou pas ;
  • une autre directive pour indiquer si un stock est limité ou pas (on considère que le stock est limité quand le nombre est inférieur à 10)
 
Sélectionnez
1.
2.
3.
4.
ng new angular-directives-structurelles1
strict ? NO
routing ? NO
SCSS
 
Sélectionnez
1.
2.
3.
4.
ng g e enums/shop-params
ng g s services/user
ng g d directives/is-authenticated
ng g d directives/is-stock-limited

app.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
import { BrowserModule } from '@angular/platform-browser';                
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';
import { IsAuthenticatedDirective } from './directives/is-authenticated.directive';
import { IsStockLimitedDirective } from './directives/is-stock-limited.directive';

@NgModule({
  declarations: [
    AppComponent,
    IsAuthenticatedDirective,     // ne pas oublier de déclarer les directives
    IsStockLimitedDirective,      //
  ],
  imports: [
    BrowserModule
  ],
  providers: [ , ],
  bootstrap: [AppComponent]
})
export class AppModule { }

app.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
<h1>PARTIE 1: DIRECTIVES STRUCTURELLES ANGULAR</h1>

<p>*** (1)</p>
<div *ngIf="isok">from div, it's okey !</div>                             <!-- la balise : div est pris en compte-->

<p>*** (2)</p>
<ng-container *ngIf="isok">from ng-container, it's okey !</ng-container>  <!-- la balise : ng-container n'est pas prise en compte-->

<p>*** (3)</p>
<ng-container *ngIf="isok;then content_ok else content_not_ok"></ng-container>    <!-- ng-container va contenir soit le ng-template #content_ok soit #content_not_ok -->
<ng-template #content_ok>isok={{isok}} - "it's OK"</ng-template>                  <!-- et ce, suivant une condition -->
<ng-template #content_not_ok>isok={{isok}} - "is <b>not</b> OK"</ng-template>

<p>*** (4)</p>
<button (click)="inverseisok()">inverser it's Okey (true/false)</button>

<p>*** (5)</p>
<ul>
  <li *ngFor="let elem of elems;">{{elem}}</li>                               <!--  la balise <li> est répétée avec le ngFor -->
</ul>

<p>*** (6)</p>
<p *ngIf="numbs">
  numbs=<ng-container *ngFor="let n of numbs">{{n}} </ng-container>           <!--  ng-container est répété avec le ngFor -->
</p>                                                                          <!--  mais ng-container représente aucune balise -->

<hr>
<hr>

<h1>PARTIE 2: DIRECTIVES STRUCTURELLES PERSONNALISÉES</h1>
<span *isAuthenticated>vous êtes authentifié !</span>           <!--  sans paramètre, c'est en appelant un service à l'intérieur de la directive      -->
                                                                <!--  que l'on déterminera si l'utilisateur est authentifié ou pas -->
<br>

(7) <span *isStockLimited = "nb1">stock limité 1 !</span>     <!--  "stock limité 1 !" s'affiche parce que nb1 est inférieur à 10 -->
<br>
(8) <span *isStockLimited = "nb2">stock limité 2 !</span>     <!--  "stock limité 2 !" ne s'affiche pas parce que nb2 est supérieur à 10 -->
XXI-C-2-a-i. Remarques
 
Sélectionnez
1.
2.
3.
4.
*isAuthenticated    modifie la structure du DOM dans le sens ajoute le div et son contenu dans le DOM ou pas
                      vérifie que l'utilisateur est authentifié, si c'est le cas on affiche un message
  *isStockLimited     idem
                      vérifie la quantité en stock et affiche un message ou pas en fonction du nombre

app.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
import { Component } from '@angular/core';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.scss']
})
export class AppComponent {
  // PARTIE 2
  nb1 = 4;          // (7) nous mettons des valeurs en dur
  nb2 = 12;         // (8) dans la réalité, ces valeurs sont bien souvent récupérées en interrogeant une API REST

  // PARTIE 1
  isok = true;                                        // (2) (3)

  elems = [4, 9, 'toto', 12];                         // (5)
  numbs: Array<number> = [10, 50, 6, 18, 32, ];       // (6)

  inverseisok() {                                     // (4)
    this.isok = !this.isok;
  }
}
XXI-C-2-a-ii. Énumération
  • j'ai décidé de mettre des paramètres dans une énumération.
  • on aurait pu le mettre dans un fichier d'environnement (voir le chapitre en question).
  • on va utiliser ce paramètre : StockLimited dans la directive.

/enums/shop-params.ts

 
Sélectionnez
1.
2.
3.
4.
export enum ShopParams {                    // énumération
  StockLimited = 10,                        // des variables qui ne sont censées jamais changer ou très rarement 
                                            // comme des paramètres de configuration
}
XXI-C-2-a-iii. Le service
  • histoire de bien faire les choses, on crée un service : user.service.ts qui va contenir le code métier correspondant à l'utilisateur et à sa connexion.
  • la directive va utiliser ce service.

/services/user.service.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
import { Injectable } from '@angular/core';

@Injectable({
  providedIn: 'root'
})
export class UserService {

  constructor() { }

  isAuthorized() {
    //
    //  le code pour déterminer si l'utilisateur est authentifié ou pas
    //
    return true;    // ou false
  }
}
XXI-C-2-a-iv. La directive

/directives/isAuthenticated.directive.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
import { Directive, TemplateRef, ViewContainerRef, OnInit } from '@angular/core';                    
import { UserService } from '../services/user.service';          // on a besoin d'accéder à ce service

@Directive({
  selector: '[isAuthenticated]'
})
export class IsAuthenticatedDirective implements OnInit {

  private hasView = false;             // un flag pour connaitre l'état, s’il est affiché ou pas actuellement

  constructor(private templateRef: TemplateRef<any>,            // contient le DOM de la balise où est écrite la directive
              private viewContainer: ViewContainerRef,          // l'emplacement (où est écrite la directive) où doit être inséré le contenu (TemplateRef)
              private userService: UserService)                 // toujours ->  le code métier dans les services
  { }

  ngOnInit(): void {                                            // quand il n'y a pas de paramètres, on utilise ngOnInit()
                                                                // utilisation dans la vue : <div *isAuthenticated>
                                                                // il n'y a pas de paramètre, car on n'a pas mis par exemple : <div *isAuthenticated="value">

    const isAuthorized = this.userService.isAuthorized();       // on récupère l'information du service : true ou false

    if (isAuthorized && !this.hasView) {                        // si autorisé et pas déjà affiché
      this.viewContainer.createEmbeddedView(this.templateRef);  // on met dans le container le contenu de la balise (du template)
      this.hasView = true;                                      // est affiché

    } else if (!isAuthorized && this.hasView) {                 // si pas autorisé et qu'il est affiché actuellement
      this.viewContainer.clear();                               // on efface l'emplacement
      this.hasView = false;                                     // n'est pas affiché
    }
  }
}

/directives/isStockLimited.directive.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
import { Directive, TemplateRef, ViewContainerRef, Input } from '@angular/core';                    
import { ShopParams } from '../enums/shop-params.enum';

@Directive({
  selector: '[isStockLimited]'
})
export class IsStockLimitedDirective {

  private hasView = false;

  constructor(private templateRef: TemplateRef<any>, private viewContainer: ViewContainerRef, ) { }

  @Input() set isStockLimited(nb: number) {                     // quand il y a passage de paramètres, du binding, on utilise : @Input()
                                                                // @Input()    -->  la réception du bind
                                                                // de plus, on sait que nb est du type : number alors on le précise (le typage de typeScript)
                                                                // nb = value = 4      -> réception de la valeur transmise à la balise : *isStockLimit = "4"

    if (nb < ShopParams.StockLimited && !this.hasView) {        // 4 < 10 et pas affiché
      this.viewContainer.createEmbeddedView(this.templateRef);  // c'est OK !  le contenu de templateRef : "stock limité 1!" est envoyé à l'emplacement (container)
      this.hasView = true;
    } else if (!nb && this.hasView) {                           // sinon
      this.viewContainer.clear();
      this.hasView = false;
    }

    console.log(this.templateRef);          // aller voir le contenu de templateRef dans la console et voyez ce que l'on peut modifier
  }
}
XXI-C-2-a-v. À savoir
  • constructor(private templateRef: TemplateRef<any>, private viewContainer: ViewContainerRef, )
  • templateRef c'est le contenu. Contient le DOM de l'élément (HTML ou composant) sur lequel est appliquée la directive.
  • viewContainer c'est le contenant de l'élément (HTML ou composant) où on insère le contenu (templateRef)
  • this.viewContainer.createEmbeddedView(this.templateRef);
  • le principe d'une directive structurelle est donc de modifier le contenu (templateRef) et de l'insérer dans le contenant (viewContainer).
XXI-C-2-a-vi. Conclusion
  • les directives structurelles sont un moyen puissant pour modifier la structure du DOM d'un élément (HTML ou composant).
  • en mettant une directive *isAuthenticated sur un élément span, on peut faire beaucoup de choses sans surcharger la vue <span *isAuthenticated>vous êtes authentifié !</span>.
  • il faut toujours privilégier l'utilisation des directives.

XXII. en cours...

XXIII. Cycle de vie Angular

  • Angular exécute une série d'interventions diverses sur un composant web afin de l'initialiser, l'instancier, l'exécuter…
  • Angular permet si on le souhaite d'intervenir au moment de chaque phase.
  • La phase la plus utilisée est : ngOnInit() { …code personnalisé… }

XXIII-A. Pratique

Nous allons tester toutes les phases et l'ordre auquel elles se lancent

 
Sélectionnez
1.
2.
3.
4.
ng new angular-cycle1
strict ? NO
routing ? NO
SCSS
 
Sélectionnez
1.
ng g c comp1

app.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
<p>app works!</p>

<button (click)="messageParent = 'un message provenant du parent'">(1) cliquez !   messageParent = 'un message provenant du parent'</button>
<button (click)="messageParent = ''">(1) reset</button>
<p>(1) messageParent = {{messageParent}}</p>

<hr>
<app-comp1 [inputMessage]="messageParent"></app-comp1>

app.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
import { Component } from '@angular/core';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.css']
})
export class AppComponent {
  messageParent = '';
}

comp1.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
<div style="padding: 12px; margin-left: 24px; background: lavender;">
  <p>comp1 works!</p>

  <p>(1) @Input() inputMessage = {{inputMessage}}</p>
  <br><br>

  <button (click)="messageComp1 = 'un message de comp1'">(2) cliquez !  messageComp1 = 'un message de comp1'</button>
  <button (click)="messageComp1 = ''">(2) reset</button>
  <p>(2) variable de comp1: messageComp1 = {{messageComp1}}</p>
</div>

comp1.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
import { Component, AfterViewInit, AfterContentInit, OnInit, SimpleChanges, DoCheck, Input, AfterContentChecked, AfterViewChecked, OnChanges, OnDestroy } from '@angular/core';                
                                                            // ici, on récupère les implémentations de : ngOnInit et des autres fonctions de cycle
                                                          // '@angular/core'    le '@' indique que c'est un package Angular
                                                          // sur les packages externes (non Angular), on ne met pas: '@'
@Component({
  selector: 'app-comp1',
  templateUrl: './comp1.component.html',
  styleUrls: ['./comp1.component.css']
})
export class Comp1Component implements AfterViewInit, AfterContentInit, OnInit, DoCheck, AfterContentChecked, AfterViewChecked, OnChanges, OnDestroy {
  @Input() inputMessage: string;    // (1)
  messageComp1 = '';                // (2)

  constructor() {                                 // demander l'injection d'objets que l'on a besoin d'utiliser dans le composant
    console.log("cycle n°1 - constructor");
    //
    //  on ne doit rien faire ici !
    //
  }

  ngOnInit(): void {                              //  appelé après le constructeur, initialise les propriétés d'entrée et le premier appel à ngOnChanges
    console.log("cycle n°2 - ngOnInit");          //  attention :  cette fonction n'est appelée qu'une seule fois
    // initialiser des valeurs (qui ne doit être fait qu'une seule fois)
    // par exemple:
    //      - récupérer des données d'une API
    //      - souscrire à des observables
    //    ...
  }

  ngDoCheck(): void {                             // appelé chaque fois qu'une propriété change d'un @Input ou d'une variable
                                                  // ou lorsqu'une directive est vérifiée.
                                                  // utilisez-le pour étendre la détection des modifications en effectuant une vérification personnalisée
    console.log('------');
    console.log("cycle n°3 - ngDoCheck - (un changement de valeur a eu lieu)");
  }

  ngAfterContentInit(): void {                    // appelé après ngOnInit lorsque le contenu du composant ou de la directive a été initialisé
    console.log("cycle n°4 - ngAfterContentInit");
  }

  ngAfterContentChecked(): void {                 // appelé après chaque vérification du contenu du composant ou de la directive
                                                  // appelé après chaque fois qu'une vérification du contenu externe (transclusion) est faite
    console.log("cycle n°5 - ngAfterContentChecked");
  }

  ngAfterViewInit(): void {     // appelé après ngAfterContentInit lorsque la vue du composant a été initialisée. S'applique uniquement aux composants.
                                // il est appelé dès lors que la vue du composant ainsi que celles de ses enfants sont initialisées
    console.log("cycle n°6 - ngAfterViewInit");
  }

  ngAfterViewChecked(): void {                    // appelé après chaque vérification de la vue du composant.
                                                  // s'applique uniquement aux composants.
    console.log("cycle n°7 - ngAfterViewChecked");
  }

  ngOnDestroy(): void {                           // appelé quand le composant est détruit par Angular
                                                  // lors du routing, quand on change de page cette fonction est appelée
    console.log('cycle n°x - ngOnDestroy');
    // si on a des observables qui tournent dans le composant
    // il faut absolument se désabonner des observables ici
    // obsxxxxxxx.unsubscribe();
  }

  ngOnChanges(changes: SimpleChanges): void {     // détection de changement de valeur uniquement sur les : @Input() ......
    console.log('------------------------');      // donc concerne le binding du composant parent
    console.log('cycle n°x - ngOnChanges');       // cette fonction est appelée quand une valeur change sur n'importe quelle entrée (@Input) 
    console.log(changes);
    console.log('Le @input qui a changé est:' + JSON.stringify(changes));
  }
}

XXIII-B. Résultat

  • Cliquez alternativement sur : '(1) cliquez …' et '(1) reset' et voyez le résultat dans la console.
  • Cliquez alternativement sur: '(2) cliquez …' et '(2) reset' et voyez le résultat dans la console.
  • il y a une différence entre les deux ? oui -> 'ngOnChanges' en + pour (1).

XXIII-C. Conclusion

En général, les cycles les plus utilisés :

  • constructor() pour demander les instances de services que l'on a besoin (DI : injection de dépendances) ;
  • ngOnInit() pour initialiser des données ;
  • ngOnDestroy() pour se désinscrire à des observables ;
  • ngOnChanges() pour pouvoir agir lors d'une détection de changement de valeur des données en entrée (@Input).

En rapport avec l'affichage :

  • avant l'affichage : constructor(), ngOnInit(), ngDoCheck() et ngOnChanges() ;
  • après l'affichage : ngAfterViewChecked() et ngAfterViewInit() ;

XXIV. Architecture avancée : modules, composants web…

Voyons comment organiser un projet complexe en modules.

Mais avant d'aller plus loin, sachez que cette partie est d'un niveau avancé, revenez plus tard sur cette partie si vraiment vous débutez.

En effet, si vous débutez, vous pouvez déclarer et importer tout ce que vous voulez dans le module : app.module.ts

Voici la liste des éléments que l'on peut trouver dans un projet :

  • des modules (que l'on importe dans un module) ;
  • des composants (que l'on déclare et que l'on exporte dans un module) ;
  • des services ;
  • du routing (que l'on rattache à un module) ;
  • des modèles de données.

XXIV-A. Qu'est-ce que sont les services ?

Bonnes pratiques :

  • pour alléger le code et pour le rendre réutilisable, on met le code métier dans un service ;
  • ainsi, si besoin, plusieurs composants peuvent faire appel à une même fonction d'un service ;
  • nous verrons plus loin les services.

XXIV-B. Qu'est-ce que le routing ?

Bonnes pratiques :

  • le routing permet d'associer un chemin : /mon-url à un composant web (une page) ;
  • rappel : un module comprend un ou plusieurs composants web (ou page) ;
  • ainsi tel chemin correspond à tel composant web du module ;
  • d'un point de vue du nommage, un composant web qui sert pour le routing on le nomme simplement un « composant page » ou « page », mais techniquement rien ne change, ça reste un composant web ;
  • généralement, on crée un fichier de routing à part que l'on importe dans un module.

XXIV-C. Exemple avec un site e-commerce

Voici les grandes fonctionnalités d'un site d'e-commerce : l'affichage des produits, le panier, la gestion des commandes…

Bonnes pratiques :

  • une fonctionnalité = un module.

Rappel : un module est composé d'un ou plusieurs composants.

Remarque : histoire d’être complet, on a ajouté des services (providers) et du routing

Rappel sur le rôle d'un module :

  • si nécessaire, rendre réutilisable le module (et donc ses composants) ;
  • déclarer les composants web pour qu'ils puissent être utilisés ;
  • importer des modules internes au projet ou des modules externes (dossier /node_modules) ;
  • exporter les composants web afin qu'ils soient disponibles dans un autre module ;
  • indiquer les services qui doivent être injectés dans les composants pour son utilisation (DI - Injection de dépendances) ;
  • routing : associer un chemin URL à un composant web.

XXIV-C-1. Organisation d'un projet

  • Il n'y a pas de meilleure façon d'organiser un projet.
  • Chaque type de projet peut avoir son type d'organisation.
  • L'organisation que je montre ici est subjective.
XXIV-C-1-a. Principes
 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
- un dossier /core          -->  on regroupe tout ce qui est en commun avec tout le projet en lui-même (les services, des modèles de données, des composants un peu particuliers...)                            
- un dossier /features      -->  disons que ce sont des bouts, des parties qui vont servir pour construire les pages
                            -->  (on utilise: /core si besoin)
- un dossier /pages         -->  les pages de l'application (on les construit à partir des composants de: /features)                          
                            -->  chaque page doit avoir son module (si on veut utiliser le lazy loading)
- un dossier /shared        -->  on regroupe tout ce qui est en commun avec plusieurs projets
                                en effet, le composant: loading.component peut servir pour d'autres projets
XXIV-C-1-b. Schéma A
 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
                                            core.module.ts                                           shared.module
                  .........................................................................      .....................
                   (des modèles de données, des services... communs à l'ensemble du projet)            (...)
                                                 ||                                                      ||    
        ______________________________________________________________________________________________________________
                     ||                                            ||                                     ||
                     ||                                            ||                                     ||                
            partials.module                                product.module.ts                        cart.module.ts          
      .................................                    ...................                      ...................     
      header.component footer.component (4)                (divers composants)                      (divers composants)     
                     ||                                            ||                                     ||       
                     ||                                            ||                                     ||           
           ---------   ||                   ________________________________________________     _____________________
        |         |  ||                          ||                     ||                            ||
        |        app.module.ts (5)        page-product.module      page-products.module         page-cart.module
        |                                 ......................   .......................      ...................
        |                                 page-product.component   page-products.component      page-cart.component 
    pages.module (6)                             (1)                       (2)                        (3)
    ................                          
     (1*)   (2*)   (3*)                           |                         |                          | 
      _____________________________________________                         |                          |
            _________________________________________________________________                          |
                  ______________________________________________________________________________________
  • (1) et (2) utilisent les composants de product.module qui utilisent les composants de core.module et shared.module.
  • (3) utilise les composants de cart.module qui utilisent les composants de core.module et shared.module.
  • (4) utilisent les composants de core.module et shared.module.
  • (5) utilise les composants de partials.module (4) qui utilisent les composants de core.module et shared.module.
  • (6) pages.module regroupe les modules des pages : (1), (2) et (3) pour le routing.
XXIV-C-1-c. Remarques
  • Nous avons créé un module par page pour prévoir la mise en place du lazy-loading (chargement des pages « ou modules » différé).
XXIV-C-1-d. Schéma B
 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
86.
87.
88.
89.
90.
91.
92.
93.
94.
95.
96.
app.module.ts
  ** imports: [BrowserModule, AppRoutingModule, PartialsModule,],
app-routing.module.ts                     // URL : .../product  .../products  .../cart
/core                                     // tout ce qui est en commun entre /components et /pages
    core.module.ts
      ** declarations: [UserProfilComponent],
      ** imports: [CommonModule,],          
      ** exports: [UserProfilComponent,],
    /services                             // les services de portée racine qui seront accessibles de partout (pages, composants, autres services...)
        product-store.service.ts
        user.service.ts                   // service qui a pour code métier l'authentification
        ...                              
    /models                               // des modèles de données globales au projet 
        product.ts                        // on aura besoin du modèle de données : product dans de nombreux composants et pages différentes
        ...                               // donc on le met ici
        ...
    /enums
        ...                               // des énumérations globales au projet 
        ...
    /components                               
        /user-profil                      // le profil peut être utilisé par : /components et par /pages
            user-profil.component. (html, ts, css) 
        ...
/features                                                      // les principales fonctionnalités du projet                           
    /product                        
        product.module.ts
          ** declarations: [ProductLineComponent, ProductAddRemoveComponent],
          ** imports: [CommonModule, CoreModule,],    
          ** exports: [ProductLineComponent, ProductAddRemoveComponent],                      
        /services
            product.service.ts                                  // code métier uniquement pour : /features  (requêtes HTTP , communication avec cart...) 
                                                                // par exemple, dans ce service on utilisera le ou les services du dossier : /core/services/****
        /models
          ...                                                   // modèle de données qui vont servir uniquement aux composants : /components (et pas ailleurs)
        /components                                                      
            /product-line 
                product-line.component. (html, ts, css)  
            /product-add-remove
                product-add-remove.component. (html, ts, css)   // communique avec "cart" pour ajouter ou supprimer un produit du panier
                                                                // en utilisant le service : product.service.ts                            
    /cart
        cart.module.ts
          ** declarations: [CartLineComponent, CartTotalComponent, CartIconComponent,],
          ** imports: [CommonModule, CoreModule,],
          ** exports: [CartLineComponent, CartTotalComponent, CartIconComponent,],              
        /services
            cart.service.ts                                     // code métier pour cart : en plus, contient la liste du panier et le total des montants     
        /models
            cart.ts
        /components    
            /cart-line               
                cart-line.component. (html, ts, css)
            /cart-total
                cart-total.component. (html, ts, css) 
            /cart-icon  
                cart-icon.component. (html, ts, css)                           
/pages
    pages.module.ts
      ** declarations: [ ],
      ** imports: [PageProductModule, PageProductsModule, PageCartModule, ]         
    /partials
        partials.module.ts
          ** declarations: [HeaderComponent, FooterComponent, ],
          ** imports: [CommonModule, CoreModule, CartModule, ],
          ** exports: [HeaderComponent, FooterComponent, ],        
        /header
            header.component. (html, ts, css)
        /footer
            footer.component. (html, ts, css)                     
    /page-product    
        page-product.module.ts
          ** declarations: [PageProductComponent, ],
          ** imports: [CommonModule, ProductModule, ],    
        page-product.component. (html, ts, css)                
    /page-products     
        page-products.module.ts
          ** declarations: [PageProductsComponent, ],
          ** imports: [CommonModule, ProductModule, ],                                       
        page-products.component. (html, ts, css)   
        /components
            ...                                 // si besoin, on peut mettre ici des composants qui vont servir uniquement pour : page-products.component
            ...   
    /page-cart       
        page-cart.module.ts
          ** declarations: [PageCartComponent, ],
          ** imports: [CommonModule, CartModule, ],         
        page-cart.component. (html, ts, css)    // pour construire la page, on utilise les composants qui se trouvent dans : /features/cart/components/*
/shared                                                 // on importe ici des composants "génériques" que l'on utilise pour plusieurs projets
                                                        // on importe les modules que l'on souhaite : loading.module.ts, http.module.ts, bootstrap.module.ts
                                                        // ces modules sont donc disponibles là ou on les importe
    loading.module.ts
        loading.component.ts
    http.module.ts
        http.service.ts
    bootstrap.module.ts
        intégration package externe bootstrap

XXIV-D. Pratique

On va utiliser Angular-cli pour faire le travail rapidement (vite fait, bien fait)

 
Sélectionnez
1.
2.
3.
4.
ng new angular-shop-skeleton1
strict ? NO
routing ? YES
SCSS

// en répondant : routing ? YES :
- cela va créer un fichier de configuration de routes : /app/app-routing.module.ts ;
- ce nouveau fichier sera importé dans 'imports' du module racine : app.module.ts.

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
ng g m core
ng g s /core/services/product-store
ng g s /core/services/user
ng g i /core/models/product
ng g c /core/components/user-profil --module=core

ng g m /features/product
ng g s /features/product/services/product
ng g c /features/product/components/product-line --module=product
ng g c /features/product/components/product-add-remove --module=product

ng g m /features/cart
ng g s /features/cart/services/cart
ng g i /features/cart/models/cart
ng g c /features/cart/components/cart-line --module=cart
ng g c /features/cart/components/cart-total --module=cart
ng g c /features/cart/components/cart-icon --module=cart

ng g m /pages --module=app
ng g m /pages/page-product --module=pages
ng g c /pages/page-product --module=page-product
ng g m /pages/page-products --module=pages
ng g c /pages/page-products --module=page-products

ng g m /pages/page-cart --module=pages
ng g c /pages/page-cart --module=page-cart

ng g m /pages/partials --module=app
ng g c /pages/partials/header --module=partials
ng g c /pages/partials/footer --module=partials

app.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppRoutingModule } from './app-routing.module';
import { AppComponent } from './app.component';
import { PartialsModule } from './pages/partials/partials.module';
//

import { PagesModule } from './pages/pages.module';

@NgModule({
  declarations: [AppComponent],
  imports: [BrowserModule, AppRoutingModule, PartialsModule, ],
  providers: [],
  bootstrap: [AppComponent],
  schemas: [  ],
})
export class AppModule { }

app.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
<app-header></app-header>

<div style="background: lightyellow; padding: 128px 12px;">
  <router-outlet></router-outlet>                             <!-- ici que sont projetées les pages du routing -->
</div>

<app-footer></app-footer>

app-routing.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
import { NgModule } from '@angular/core';                
import { Routes, RouterModule } from '@angular/router';
import { PageProductComponent } from './pages/page-product/page-product.component';
import { PageProductsComponent } from './pages/page-products/page-products.component';
import { PageCartComponent } from './pages/page-cart/page-cart.component';

const routes: Routes = [
  { path: 'product', component: PageProductComponent },
  { path: 'products', component: PageProductsComponent },
  { path: 'cart', component: PageCartComponent },
];

@NgModule({
  imports: [RouterModule.forRoot(routes)],
  exports: [RouterModule]
})
export class AppRoutingModule { }

dans le header on va mettre des liens, le panier et le profil.

/pages/partials/header.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
<div style="background: lightsteelblue; padding: 24px;">
  <p>header works!</p>

  <p><button (click)="navigateTo('/product')">product</button></p>
  <p><button (click)="navigateTo('/products')">products</button></p>
  <p><button (click)="navigateTo('/cart')">cart</button></p>
  <app-cart-icon></app-cart-icon>
  <app-user-profil></app-user-profil>
</div>

/pages/partials/header.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
import { Component, OnInit } from '@angular/core';
import { Router } from '@angular/router'; // CLI imports router

@Component({
  selector: 'app-header',
  templateUrl: './header.component.html',
  styleUrls: ['./header.component.scss']
})
export class HeaderComponent implements OnInit {

  constructor(private router: Router) { }

  ngOnInit(): void {
  }

  navigateTo(value: string): void {
    this.router.navigate([value]);
  }
}

/pages/partials/footer.component.html

 
Sélectionnez
1.
2.
3.
<div style="background: lightsteelblue; padding: 48px;">
  <p>footer works!</p>
</div>

/core/models/product.ts

 
Sélectionnez
1.
2.
3.
4.
5.
export interface Product {
  id: number;
  name: string;
  description?: string;
}

/core/services/product-store.service.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
import { Injectable } from '@angular/core';                
import { Product } from '../models/product';

@Injectable({
  providedIn: 'root'
})
export class ProductStoreService {

  private productSelected: Product = { id: 1, name: 'XBOX'};

  constructor() { }

  getProductSelected(): Product {
    return this.productSelected;
  }

  setProductSelected(product: Product): void {
    this.productSelected = product;
  }
}

/pages/page-product/page-product.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
<p>page-product works!</p>
ProductSelected={{ProductSelected|json}}

<app-product-line></app-product-line>                 <!-- on utilise des composants de : /components pour construire la page -->
<app-product-add-remove></app-product-add-remove>

/pages/page-product/page-product.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
import { Component, OnInit } from '@angular/core';
import { ProductStoreService } from '../../core/services/product-store.service';
import { Product } from '../../core/models/product';

@Component({
  selector: 'app-page-product',
  templateUrl: './page-product.component.html',
  styleUrls: ['./page-product.component.scss']
})
export class PageProductComponent implements OnInit {
  ProductSelected: Product;

  constructor(private productStoreService: ProductStoreService) { }

  ngOnInit(): void {
    this.ProductSelected = this.productStoreService.getProductSelected();       // un exemple pour montrer qu'on utilise : /core
  }
}

/pages/page-products/page-products.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
<p>page-products works!</p>

<app-product-line></app-product-line>     <!-- on utilise des composants de:  /components pour construire la page -->
<app-product-line></app-product-line>
<app-product-line></app-product-line>
<app-product-line></app-product-line>

/pages/page-cart/page-cart.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
<p>page-cart works!</p>

<app-cart-line></app-cart-line>           <!-- on utilise des composants de : /components pour construire la page -->
<app-cart-line></app-cart-line>
<app-cart-total></app-cart-total>
  • en vous basant sur le schéma B, complétez le code des différents modules suivants :

    • /core/core.module.ts ;
    • /features/product/product.module.ts ;
    • /features/cart/cart.module.ts ;
    • /pages/pages.module.ts ;
    • /pages/partials/partials.module.ts.
 
Sélectionnez
1.
ng serve

XXIV-D-1. Résultat

  • Cliquez sur les boutons pour changer de page, constatez que tout fonctionne normalement.
  • Vérifiez qu'il n'y a pas d'erreurs dans la console.

XXIV-E. Bonus

  • Nous souhaitons afficher un pdf dans la page du produit.
  • Pour cela on va utiliser un package externe: https://www.npmjs.com/package/ng2-pdf-viewer.
  • Ce package sera inclus uniquement au niveau du produit, car les autres modules n'en ont pas besoin.

XXIV-E-1. Pratique

  • (A1) importer le package en ligne de commande.
  • (A2) créer un composant qui a pour but d'afficher un pdf.
  • (A3) importer dans le fichier module du produit le nouveau package.
  • (A4) ajouter ce composant dans la page produit.
XXIV-E-1-a. (A1) Importer le package en ligne de commande
 
Sélectionnez
1.
npm install ng2-pdf-viewer --save
XXIV-E-1-b. (A2) Créer un composant qui a pour but d'afficher un pdf

On met ce composant dans /features/product, car cela ne concerne que les produits

 
Sélectionnez
1.
ng g c /features/product/product-pdf-viewer --module=product

/features/product/product-pdf-viewer.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
<p>product-pdf-viewer works!</p>

<pdf-viewer
  [src]="'https://vadimdez.github.io/ng2-pdf-viewer/assets/pdf-test.pdf'"
  [render-text]="true"
  style="display: block; height: 40vh;"
></pdf-viewer>
XXIV-E-1-c. (A3) Importer dans le fichier module du produit le nouveau package

/features/product/product.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
import { NgModule } from '@angular/core';                        
import { CommonModule } from '@angular/common';
import { ProductLineComponent } from './components/product-line/product-line.component';
import { ProductAddRemoveComponent } from './components/product-add-remove/product-add-remove.component';
import { CoreModule } from '../../core/core.module';

import { ProductPdfViewerComponent } from './product-pdf-viewer/product-pdf-viewer.component';
import { PdfViewerModule } from 'ng2-pdf-viewer';                     // ici, on importe le package: PdfViewerModule

@NgModule({
  declarations: [ProductLineComponent, ProductAddRemoveComponent, ProductPdfViewerComponent],   // le nouveau composant: ProductPdfViewerComponent
  imports: [ CommonModule, CoreModule, PdfViewerModule, ],                                      // ici, on importe le package: PdfViewerModule
  exports: [ProductLineComponent, ProductAddRemoveComponent, ProductPdfViewerComponent],        // on exporte le nouveau composant: ProductPdfViewerComponent
})
export class ProductModule { }
XXIV-E-1-d. (A4) Ajouter ce composant dans la page : produit

/pages/page-product/page-product.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
<p>page-product works!</p>
ProductSelected={{ProductSelected|json}}

<app-product-line></app-product-line>                 <!-- on utilise des composants de : /components pour construire la page -->
<app-product-add-remove></app-product-add-remove>

<app-product-pdf-viewer></app-product-pdf-viewer>     <!-- ici,  le nouveau composant à inclure -->

quand vous touchez aux modules, toujours relancer avec ng serve (ne pas faire confiance au live reload) :

 
Sélectionnez
1.
ng serve
XXIV-E-1-e. Conclusion
  • Nous avons importé un package externe dans le module : /features/product/product.module.ts, ce package ne sera donc accessible que par les composants de ce module (pas besoin qu'il soit disponible ailleurs).
XXIV-E-1-f. À savoir
  • Nous aurions même pu être plus précis en créant un module directement dans le composant comme ici : /features/product/components/product-pdf-viewer/product-pdf-viewer.module.ts et importer le package externe PdfViewerModule dans ce module (au lieu, comme actuellement dans le module : product.module.ts).
  • Ensuite pour que ça fonctionne, importer product-pdf-viewer.module.ts dans le module /features/product/product.module.ts.

XXV. Les composants web réutilisables

Nous avons vu que réutiliser des composants web était une bonne pratique, car cela améliore la maintenabilité et augmente la productivité :

  • nous allons donc dans ce chapitre écrire un exemple de composant web réutilisable ;
  • ce composant affichera une liste d'éléments et renverra le choix que l'utilisateur a sélectionné, un peu comme un groupe de radio boutons.

XXV-A. À savoir

Pour une capacité de réutilisation optimale, le composant doit se contenter de ne faire que sa propre fonctionnalité, celle d'afficher une liste et de retourner le choix de l'utilisateur, en somme, ce composant :

  • ne devra pas contenir la liste des éléments à afficher ;
  • ne devra pas aller chercher la liste des éléments à afficher (mais par contre, il la recevra)

XXV-B. Description

  • le composant réutilisable sera contenu dans le dossier : /shared
  • pour le design, le composant utilisera un composant UI d'Angular Material ;
  • Voici le détail du composant web réutilisable :

    • réceptionne la liste des éléments (d'un certain type) à afficher ;
    • réceptionne l'élément par défaut qui doit être sélectionné (il est possible qu'il n'y ait aucun élément) ;
    • réceptionne le nom du groupe auquel appartient la liste ;
    • sélectionne l'item par défaut ou celui enregistré dans un service (lors d'une précédente sélection utilisateur) ;
    • renvoie le choix de l'utilisateur au composant qui y a fait appel ;
    • contient le type de donnée que le composant manipule. Ainsi de l'extérieur, on sait de quel type doivent être les données que l'on doit fournir au composant ;
    • enregistre le choix de l'utilisateur dans un service ;
    • le design du composant sera géré par Angular Material.

XXV-B-1. Remarques

  • pour le design, on va utiliser le toggle button d'Angular material ;
  • https://material.angular.io/components/button-toggle/overview
  • lors du routing à chaque accès à une page : page1 ou page2, les composants pages s'initialisent et donc ne conservent pas l'état de la sélection. C'est pour cela que l'on utilise un service pour stocker le choix de l'utilisateur et ainsi l'employer pour initialiser le composant avec la bonne sélection.

XXV-B-2. Inventaires

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
- /shared/button-toggle-mat
  - /components/button-toggle-mat.component.ts              // le composant
  - /services/stored.service.ts                             // pour enregistrer le choix de l'utilisateur
  - /models/i-item-btm.ts                                   // le type de donnée que le composant manipule
  - button-toggle-mat.module.ts                             // déclare le composant et le service. De plus, exporte le composant.

- /pages
  - /page1                                      // composant avec une liste d'items 'quelconque' ayant comme nom de groupe : 'choice'
  - /page2                                      // composant avec une liste d'items 'couleur' ayant comme nom de groupe : 'color'
                                                // composant avec une liste d'items 'quelconques' ayant comme nom de groupe : 'choice'

XXV-C. Pratique

Créer un nouveau projet : angular-re-use1

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
ng new angular-re-use1
strict ? NO
routing ? YES
SCSS

ng add @angular/material

ng g m pages --module=app
ng g m pages/page1 --module=pages
ng g m pages/page2 --module=pages
ng g c pages/page1 --module=page1
ng g c pages/page2 --module=page2

ng g m shared/button-toggle-mat --module=app
ng g c shared/button-toggle-mat/components/button-toggle-mat --module=button-toggle-mat
ng g i shared/button-toggle-mat/models/i-item-btm
ng g s shared/button-toggle-mat/services/stored

app.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppRoutingModule } from './app-routing.module';
import { AppComponent } from './app.component';
import { NoopAnimationsModule } from '@angular/platform-browser/animations';
//
import { PagesModule } from './pages/pages.module';

@NgModule({
  declarations: [
    AppComponent,
  ],
  imports: [
    BrowserModule,
    AppRoutingModule,
    NoopAnimationsModule,
    //
    PagesModule,                // pour le routing
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

app-routing.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
import { NgModule } from '@angular/core';
import { Routes, RouterModule } from '@angular/router';
//
import { Page1Component } from 'src/app/pages/page1/page1.component';
import { Page2Component } from 'src/app/pages/page2/page2.component';

const routes: Routes = [
  { path: 'page1', component: Page1Component },
  { path: 'page2', component: Page2Component },
];

@NgModule({
  imports: [RouterModule.forRoot(routes)],
  exports: [RouterModule]
})
export class AppRoutingModule { }

app.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
<ul>
  <li><a [routerLink]="['/page1']">aller à page1</a></li>
  <li><a [routerLink]="['/page2']">aller à page2</a></li>
</ul>

<router-outlet></router-outlet>

\data\param.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
export const ItemsChoice = [
  {key: 'K0', value: 'Aucun'},
  {key: 'K1', value: 'Choix 1'},
  {key: 'K2', value: 'Choix 2'},
  {key: 'K3', value: 'Choix 3'},
];

export const ItemsColor = [
  {key: 'NONE', value: 'Aucune'},
  {key: 'V', value: 'Vert'},
  {key: 'R', value: 'Rouge'},
];

\pages\page1\page1.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
import { NgModule } from '@angular/core';
import { CommonModule } from '@angular/common';
//
import { ButtonToggleMatModule } from '../../shared/button-toggle-mat/button-toggle-mat.module';
import { Page1Component } from './page1.component';


@NgModule({
  declarations: [Page1Component],
  imports: [
    CommonModule,
    //
    ButtonToggleMatModule,            // utilise le composant réutilisable du module          
  ]
})
export class Page1Module { }

\pages\page2\page2.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
import { NgModule } from '@angular/core';
import { CommonModule } from '@angular/common';
//
import { ButtonToggleMatModule } from '../../shared/button-toggle-mat/button-toggle-mat.module';
import { Page2Component } from './page2.component';


@NgModule({
  declarations: [Page2Component],
  imports: [
    CommonModule,
    //
    ButtonToggleMatModule,            // utilise le composant réutilisable du module

  ]
})
export class Page2Module { }

\pages\pages.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
import { NgModule } from '@angular/core';
import { CommonModule } from '@angular/common';
//
import { Page1Module } from './page1/page1.module';
import { Page2Module } from './page2/page2.module';

@NgModule({
  declarations: [],
  imports: [
    CommonModule,
    //
    Page1Module,
    Page2Module,

  ]
})
export class PagesModule { }

\pages\page1\page1.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
<p>page1 works!</p>

<h3>quelconque</h3>

<app-button-toggle-mat
  [items]="choices"
  [selectedItem]="selectedChoice"
  [group]="'choice'"
  (selectedItemEvent)="onSelectedChoice($event)"
></app-button-toggle-mat>

(1) choice={{selectedChoice|json}}

\pages\page1\page1.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
import { Component, OnInit } from '@angular/core';
import { IItemBtm } from '../../shared/button-toggle-mat/models/i-item-btm';
import { ItemsChoice } from '../../data/param';

@Component({
  selector: 'app-page1',
  templateUrl: './page1.component.html',
  styleUrls: ['./page1.component.scss']
})
export class Page1Component implements OnInit {
  choices: IItemBtm[];                // on exige que ces éléments du tableau doivent être du type : IItemBtm
                                      // ainsi, il ne peut y avoir d'erreur, car notre composant ne gère que ce type de donnée : IItemBtm
  selectedChoice: IItemBtm;           // on fourni l'élément par défaut au composant réutilisable (non obligatoire)  (2)
                                      // et en même temps va contenir le choix de l'utilisateur

  constructor() {
  }

  ngOnInit(): void {
    this.choices = ItemsChoice;                // on fournit une liste d'éléments au composant réutilisable
    this.selectedChoice = this.choices[0];     // (2) par défaut, l'élément qui sera sélectionné sera le premier élément (non obligatoire)
  }

  onSelectedChoice(item: IItemBtm) {           // lien avec le composant réutilisable enfant
    this.selectedChoice = item;                // (1) on réceptionne le choix de l'utilisateur pour l'afficher dans la vue
    //
    //  traitement
    //
  }
}

\pages\page2\page2.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
<p>page2 works!</p>

<h3>couleur</h3>

<app-button-toggle-mat
  [items]="colors"
  [group]="'color'"
  (selectedItemEvent)="onSelectedColor($event)"
></app-button-toggle-mat>

(1) Couleur={{selectedColor|json}}

<hr>

<h3>quelconque</h3>

<app-button-toggle-mat
  [items]="choices"
  [selectedItem]="selectedChoice"
  [group]="'choice'"
  (selectedItemEvent)="onSelectedChoice($event)"
></app-button-toggle-mat>

(1) choice={{selectedChoice|json}}

\pages\page2\page2.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
import { Component, OnInit } from '@angular/core';
import { IItemBtm } from '../../shared/button-toggle-mat/models/i-item-btm';
import { ItemsColor } from '../../data/param';
import { ItemsChoice } from '../../data/param';

@Component({
  selector: 'app-page2',
  templateUrl: './page2.component.html',
  styleUrls: ['./page2.component.scss']
})
export class Page2Component implements OnInit {

  //  Choix d'une couleur
  colors: IItemBtm[];                         // on exige que les éléments du tableau doivent être du type : IItemBtm
  selectedColor: IItemBtm;                    // pour contenir le choix de l'utilisateur

  //  Choix d'un item quelconque
  choices: IItemBtm[];                        // on exige que les éléments du tableau doivent être du type : IItemBtm
  selectedChoice: IItemBtm;                   // pour contenir le choix de l'utilisateur

  constructor() { }

  ngOnInit(): void {                          // initialisation des données
    //  Choix d'une couleur
    this.colors = ItemsColor;                 // on fournit une liste d'éléments au composant réutilisable
                                              // sans valeur par défaut
    //  Choix d'un item quelconque
    this.choices = ItemsChoice;               // on fournit une liste d'éléments au composant réutilisable
    this.selectedChoice = this.choices[0];    // avec une valeur par défaut
  }

  //  Choix d'une couleur
  onSelectedColor(item: IItemBtm) {           // lien avec le composant réutilisable enfant
    this.selectedColor = item;                // (1) on réceptionne le choix de l'utilisateur pour l'afficher dans la vue
    //
    //  traitement
    //
  }

  //  Choix d'un item quelconque
  onSelectedChoice(item: IItemBtm) {           // lien avec le composant réutilisable enfant
    this.selectedChoice = item;                // (1) on réceptionne le choix de l'utilisateur pour l'afficher dans la vue
    //
    //  traitement
    //
  }
}

\shared\button-toggle-mat\button-toggle-mat.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
import { NgModule } from '@angular/core';
import { CommonModule } from '@angular/common';
//
import { ButtonToggleMatComponent } from './components/button-toggle-mat/button-toggle-mat.component';
import { MatButtonToggleModule } from '@angular/material/button-toggle';
import { StoredService } from './services/stored.service';


@NgModule({
  declarations: [ButtonToggleMatComponent],
  imports: [
    CommonModule,
    MatButtonToggleModule,              // on importe uniquement le module : MatButton d'Angular Material pour pouvoir utiliser son composant

  ],
  exports: [
    ButtonToggleMatComponent,           // on exporte le composant pour qu'il soit utilisable lors d'un import
  ],
  providers: [StoredService, ]          // les composants de ce module auront accès à cette instance du service
})                                      // donc : ButtonToggleMatComponent des pages : page1 et page2 aura accès à cette instance
export class ButtonToggleMatModule { }

\shared\button-toggle-mat\models\i-item-btm.ts

 
Sélectionnez
1.
2.
3.
4.
export interface IItemBtm {
  key: string;
  value: string;
}

\shared\button-toggle-mat\services\stored.service.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
import { IItemBtm } from '../models/i-item-btm';

export class StoredService {

  selectedItemGroup: IItemBtm[] = [];       //  un tableau contenant les couples :  'nom de groupe': sélection utilisateur

  constructor() { }

  getSelectedItem(group: string): IItemBtm {          // on récupère le choix utilisateur par son groupe
    return (undefined !== this.selectedItemGroup[group]) ? this.selectedItemGroup[group] : undefined;
  }

  setSelectedItem(item: IItemBtm, group: string) {    // on enregistre le choix utilisateur par son groupe
    this.selectedItemGroup[group] = item;
  }

  getInitializedItem(defaultItem: IItemBtm, group: string): IItemBtm {      // on calcul en fonction de la valeur par défaut et de la valeur enregistrée du tableau
    if (defaultItem && this.getSelectedItem(group) === undefined) {         // s'il y a une valeur par défaut et pas de sélection utilisateur enregistrée alors...
      this.setSelectedItem(defaultItem, group);                             // c'est le choix par défaut qui est pris en compte
      return defaultItem;
    }

    return this.getSelectedItem(group);                                     // sinon c'est le choix enregistré dans le tableau qui est pris en compte
  }
}

\shared\button-toggle-mat\components\button-toggle-mat\button-toggle-mat.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
<p>
  Votre choix ? &nbsp;
  <mat-button-toggle-group name="fontStyle" aria-label="Font Style" #group="matButtonToggleGroup" [value]="selectedItem?.key" (change)="onChange($event)">
    <ng-container *ngFor="let item of items">
      <mat-button-toggle value="{{item.key}}" >{{item.value}}</mat-button-toggle>
    </ng-container>
  </mat-button-toggle-group>
</p>

\shared\button-toggle-mat\components\button-toggle-mat\button-toggle-mat.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
import { Component, Input, OnInit, Output, EventEmitter } from '@angular/core';
import { IItemBtm } from '../../models/i-item-btm';
import { StoredService } from '../../services/stored.service';

@Component({
  selector: 'app-button-toggle-mat',
  templateUrl: './button-toggle-mat.component.html',
  styleUrls: ['./button-toggle-mat.component.scss'],
})
export class ButtonToggleMatComponent implements OnInit {
  @Input() items: IItemBtm[];                                   // réceptionne la liste des éléments
  @Input() selectedItem: IItemBtm;                              // l'élément qui doit être sélectionné par défaut
  @Input() group: string;                                       // le groupe auquel appartiennent les éléments
  @Output() selectedItemEvent = new EventEmitter<IItemBtm>();   // envoi le choix de l'utilisateur au parent : page1 ou page2

  constructor(private storedService: StoredService) { }

  ngOnInit(): void {                                            // à l'initialisation du composant
    this.selectedItem = this.storedService.getInitializedItem(this.selectedItem, this.group);   // on calcul quel item est sélectionné au 1er affichage
    this.selectedItemEvent.emit(this.selectedItem);                                             // on retourne cet item au parent : page1 ou page2
  }

  onChange(event: any) {                                        // quand un choix utilisateur est fait
    // event.value ne contient que : key
    // on veut pouvoir retourner l'objet entier (key + value)
    // donc on va le chercher dans la liste des items à partir de sa clé : key
    const item: IItemBtm = this.items.filter((item: IItemBtm) => item.key == event.value)[0];   // on parcourt la liste des items et si on trouve la correspondance avec: key
                                                                                                // alors on retourne l'objet trouvé
    this.storedService.setSelectedItem(item, this.group);           // on enregistre le choix
    this.selectedItemEvent.emit(item);                              // on retourne le choix de l'utilisateur au parent : page1 ou page2
  }
}

XXV-D. Résultat

  • Quand on sélectionne un choix celui-ci est envoyé à son parent : page1.component ou page2.component
  • Remarquez que de page1 à page2 et vice versa, le choix « quelconque » garde la sélection que l'on a faite grâce au même nom de groupe.

XXV-E. Conclusion

  • Le composant web peut être utilisé plusieurs fois, il suffit de copier-coller le dossier : /button-toggle-mat dans un autre projet et l'utiliser tel quel.
  • Comme le composant ne dépend pas d'une liste définie, on peut lui transmettre n'importe quelle liste à condition qu'elle respecte le modèle.
  • Il suffit de lui transmettre une liste à afficher, un nom de groupe et si besoin un élément par défaut.
  • À savoir que lors du routing, l'accès à une page engendre l'initialisation de son composant page et de ses données.
  • Pour pouvoir enregistrer des données afin de les récupérer lors de l'initialisation d'un composant page on se sert d'un service pour stocker les données (car son instance est un singleton).

XXVI. Mise en production : Firebase hosting

Utilisons le service Hosting de firebase pour mettre en production une application Angular.
Ce service est gratuit et limité, mais cela suffit largement pour tester.

(1)
On va utiliser le projet : angular-re-use1 pour le mettre en production.

Copier / coller le projet : angular-re-use1 et renommer le dossier en : angular-hosting1

Sur le nouveau dossier : angular-hosting1 faire une recherche globale et remplacer tous les mots : 'angular-re-use1' par 'angular-hosting1'
(sur visual studio code -> clic droit sur le dossier -> find in folder -> angular-re-use1 en : angular-hosting1)

(2) Ou utiliser n'importe quel projet qui tourne en local.

XXVI-A. Pratique

Créer un compte et se connecter à : https://firebase.google.com/

  • Une fois connecté, il faut créer un projet firebase ;
  • Ce projet proposera divers services : base de données firebase, google analytics, hosting, functions…
  • Nous allons juste utiliser le service Hosting pour déployer notre application.
 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
-> Accéder à la console -> Ajouter un projet -> nom du projet : 'hosting1' -> continuer

Configurer Google Analytics -> Créer un compte : 'hosting1-google-analytics' -> enregistrer 

-> créer un projet

menu de gauche -> hosting -> commencer

On installe en global les outils pour angular-cli afin de pouvoir lancer les commandes firebase :

 
Sélectionnez
1.
npm install -g firebase-tools@latest

Il faut se connecter afin qu'angular-cli soit lié avec le compte firebase que vous avez créé :

 
Sélectionnez
1.
firebase login                          // le navigateur chrome va s'ouvrir pour vous demandez de vous connecter

La commande suivante va effectuer quelques modifications des fichiers de votre projet pour initialiser le déploiement :

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
firebase init
? Are you ready to proceed? (Y/n)   Y
-> Use an existing project          Y

(*) Hosting             <barre espace>      pour sélectionner
                        <touche entrée>     pour valider

-> Select a default Firebase project for this directory:                      hosting1-......

-> ? What do you want to use as your public directory?                        dist/angular-hosting1

-> ? Configure as a single-page app (rewrite all urls to /index.html)? (y/N)  Y

-> ? Set up automatic builds and deploys with GitHub? (y/N)                   N

La première fois et à chaque fois que vous mettez en production, il faut lancer les deux commandes suivantes :

 
Sélectionnez
1.
2.
ng build --prod                             // toujours builder en : --prod avant le deploiement
firebase deploy

XXVI-B. À savoir

C'est le contenu du dossier : /dist/angular-hosting1 qui est déployé dans le cloud Hosting.

XXVI-C. Résultat

Et voilà, il ne reste plus qu'à accéder à l'application en ligne : https://hosting1-…….web.app/#/
(voir le lien affiché à la fin du : firebase deploy).

Pour une version en production, vous devez lier ce lien avec un nom de domaine.

XXVII. Angular elements

Vous avez vu comment créer des composants web avec le framework Angular.
Sachez qu’il existe aussi dans le HTML 5 des composants web qui respectent des normes définies afin qu'ils puissent être pris en charge par les navigateurs (ils font donc partie des navigateurs).
Les composants web Angular et HTML 5 ont le même objectif principal, celui d'être réutilisables.

Voici à quoi pourrait ressembler un composant web HTML classique :

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
class HelloWorldClass extends HTMLElement {

    constructor() {
        // Always call super first in constructor
        super();
    }
    …
    …
}

customElements.define('hello-world', HelloWorldClass);

Utilisation dans une page HTML :

 
Sélectionnez
1.
<hello-world></hello-world>

Un composant web Angular ou html peut être utilisé dans n'importe quel type de projet : Angular, HTML, Svelte, php…

Toutefois, nous devons adapter le composant web Angular afin qu'il puisse être utilisé hors contexte Angular pour le rendre compatible avec les spécifications html des navigateurs.

Pour cette conversion nous utiliserons donc Angular elements.

Pourquoi cela ?

Un composant web Angular s'exécute dans le « confort » que lui apporte le framework Angular, tout est fait pour rendre le code le plus propre possible.
Malheureusement les spécifications HTML des navigateurs limitent ou compliquent certains points.
En effet, quand on utilise ce composant dans une page web classique, il n'est plus dans le «confort» Angular.
Nous devons donc le convertir et l'adapter pour qu'il réponde à certaines contraintes que lui impose l'environnement web classique.
Mais rien de bien méchant, les principales restrictions que l'on doit prendre en compte sont les suivantes :
- les données d'entrées : @Input ne doivent pas avoir de type ;
- l'écriture des variables en entrée : @Input doit être en minuscules ; par exemple : selectedItem devient : selecteditem
- il faut utiliser l'auto properties pour la détection de changement de valeur des variables d'entrée : @Input (et non pas utiliser ngOnChange).

Pourquoi utiliser un composant web Angular sur une autre plateforme ?

Par exemple, on peut avoir un site web qui tourne en php, java, html… et on veut intégrer une nouvelle fonctionnalité. Celle-ci doit être dynamique et la programmer avec les langages habituels par exemple avec jQuery serait un peu trop compliqué, la rendrait moins performante et moins facile à maintenir.
Donc, un composant web Angular répondra à tous les inconvénients cités précédemment.

XXVII-A. Pratique

On va reprendre le projet sur le composant web réutilisable : une liste de choix avec sélection utilisateur.

XXVII-B. Schéma

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
                    index.html                                                      tbm.component

        |    <button-toggle-mat              
        |        items="..."                                        -------------------->  @Input() items  
 HTML   |        (1) selecteditem="..."                             -------------------->  (1) @Input() selecteditem  
        |    >         
        |
        |   (2) <button>envoie un choix</button>
_________________________________________________________________________________________________________________________________________
        |    écoute la balise <button-toggle-mat                    <--------------------   @Output() item (le choix de l'utilisateur)
        |        si      une donnée est reçue du composant      
JS      |        alors,  traite la donnée
        |
        |    (2) envoie une donnée au composant                      --------------------->  (1) et (2) @Input() selecteditem    
        |    (un choix de l'utilisateur que                                                  met à jour la vue avec la nouvelle donnée
        |    l'on impose au composant)

(2) Ce n'est pas vraiment utile, mais j'ai mis en place cette possibilité pour montrer une communication de : index.html vers un composant

 
Sélectionnez
1.
2.
3.
ng new web-comp-tbm
NO
NO
 
Sélectionnez
1.
2.
3.
ng g c button-toggle-mat/components/button-toggle-mat --module=app
ng g i models/i-item-btm
ng g s services/stored.service.ts
 
Sélectionnez
1.
2.
3.
4.
npm i @angular/elements --save          
ng add @angular/material
npm install fs-extra concat --save-dev                  // --save-dev       package qui sera utilisé uniquement en dev
                                                        //                  (ne sera pas intégré pour la version en prod)

package.json

 
Sélectionnez
1.
2.
3.
4.
5.
6.
...
{
"scripts": {
    ...
    "build:elements": "ng build --prod --output-hashing none && node concatenate.js"
},

concatenate.js -------------------> le fichier à exécuter via node
node concatenate.js -------------> lance la concaténation des fichiers .js en un seul fichier

concatenate.js

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
const _dir = './dist/web-comp-tbm';                     // les fichiers à concaténer
const _output_js_name = 'web-comp-tbm.js';              // le fichier final

const fs = require('fs-extra');
const concat = require('concat');
(async function build() {
const files = [                                         // liste des fichiers
  _dir + '/runtime.js',
  _dir + '/polyfills.js',
  // dir + '/scripts.js',
  _dir + '/main.js',
]
await fs.ensureDir('elements')
await concat(files, 'elements/' + _output_js_name);
await fs.copyFile(_dir + '/styles.css', 'elements/styles.css')      // copie le fichier .css dans le dossier : /elements
//await fs.copy(_dir + '/assets/', 'elements/assets/' )
})()

/src/app/app.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
import { BrowserModule } from '@angular/platform-browser';
import { NgModule, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
//
import  { Injector } from '@angular/core';
import  { createCustomElement } from '@angular/elements';
import { ButtonToggleMatComponent } from './button-toggle-mat/components/button-toggle-mat/button-toggle-mat.component';
import { MatButtonToggleModule } from '@angular/material/button-toggle';
import { StoredService } from './services/stored.service';

@NgModule({
  declarations: [ButtonToggleMatComponent, ],
  imports: [ BrowserModule, MatButtonToggleModule, ],
  entryComponents : [ ButtonToggleMatComponent, ],              // le composant d'entrée puisque bootstrap n'est pas défini pour un composant web
  providers: [ StoredService, ],                                // un service à la porté : root (puisque qu'il est déclaré dans : app.module)
  schemas: [ CUSTOM_ELEMENTS_SCHEMA, ],                         // indique que le composant n'est pas du type : Angular
})
export class AppModule {
  constructor(private injector : Injector) {}                   // injector : intégrer dans le composant le service d'injection de dépendances

  ngDoBootstrap(){
    const el = createCustomElement(ButtonToggleMatComponent, {injector : this.injector});
    customElements.define('button-toggle-mat', el);             // 'button-toggle-mat' : on peut renommer le nom de la balise ici
  }
}

/src/app/models/i-item-btm.ts

 
Sélectionnez
1.
2.
3.
4.
export interface IItemBtm {
  key: string;
  value: string;
}

/src/app/services/stored.service.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
import { IItemBtm } from '../models/i-item-btm';

export class StoredService {

  selectedItemGroup: IItemBtm[] = <IItemBtm[]>[];     //  un tableau contenant les couples :  «nom de groupe» : sélection utilisateur

  constructor() { }

  getSelectedItem(group: string): IItemBtm {          // on récupère le choix utilisateur par son groupe
    if (this.selectedItemGroup[group] !== undefined) {
      return this.selectedItemGroup[group];
    }
    return undefined;
  }

  setSelectedItem(item: IItemBtm, group: string) {    // on enregistre le choix utilisateur par son groupe
    if (item !== undefined) {
      this.selectedItemGroup[group] = item;
    }
  }

  getInitializedItem(defaultItem: IItemBtm, group: string): IItemBtm {      // on calcul en fonction de la valeur par défaut et de la valeur enregistrée du tableau
    if (defaultItem && this.getSelectedItem(group) === undefined) {         // si il y a une valeur par défaut et pas de sélection utilisateur enregistré alors...
      this.setSelectedItem(defaultItem, group);                             // c'est le choix par défaut qui est pris en compte
      return defaultItem;
    }
    return this.getSelectedItem(group);                                     // sinon c'est le choix enregistré dans le tableau qui est pris en compte
  }
}

/src/app/button-toggle-mat/components/button-toggle-mat/button-toggle-mat.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
<p>
  Votre choix ? &nbsp;
  <mat-button-toggle-group name="fontStyle" aria-label="Font Style" value="selectedItemObj?.key" (change)="onChange($event)">
    <ng-container *ngFor="let item of itemsObj">
      <mat-button-toggle value="{{item.key}}" [checked]="item.key == selectedItemObj?.key">{{item.value}}</mat-button-toggle>
    </ng-container>
  </mat-button-toggle-group>
</p>

selectedItemObj={{selectedItemObj|json}}

/src/app/button-toggle-mat/components/button-toggle-mat/button-toggle-mat.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
import { Component, Input, OnInit, Output, EventEmitter, SimpleChanges, OnChanges } from '@angular/core';
import { IItemBtm } from '../../models/i-item-btm';
import { StoredService } from '../../../services/stored.service';

@Component({
  selector: 'app-button-toggle-mat',
  templateUrl: './button-toggle-mat.component.html',
  styleUrls: ['./button-toggle-mat.component.scss']
})
export class ButtonToggleMatComponent implements OnInit {

  // réception des données provenant des balises du contexte web (hors Angular)
  @Input() items;                           // ne pas mettre de type
  @Input() set selecteditem(strItem) {                                          // selecteditem provenant du contexte web
                                                                                // set selecteditem(strItem) est la technique de l'auto properties
        this.selectedItemObj = JSON.parse(strItem) as IItemBtm;                 // conversion : chaine -> Objet IItemBtm
                                                                                // as IItemBtm -> cast avec IItemBtm
                                                                                //                (si pas du type IItemBtm alors cela génère une erreur)
        this.storedService.setSelectedItem(this.selectedItemObj, this.group);
  };
  @Input() group;                           // ne pas mettre de type

  //  système d'envoi d'une donnée au contexte web
  @Output() selectedItemEvent = new EventEmitter<IItemBtm>();

  // pour la vue
  itemsObj: IItemBtm[];               // les données convertis au format Objet
  selectedItemObj: IItemBtm;          //

  constructor(private storedService: StoredService) { }

  ngOnInit(): void {                                                // Initialisation
    console.log('depuis le composant, action dans ngOnInit() : (initialisation du composant)');

    if (!this.items) {          // les items sont obligatoires sinon on émet une erreur
      throw 'Vous devez transmettre une liste d\'éléments dans la balise. items="..."';
    }

    this.itemsObj = JSON.parse(this.items);                                     // conversion : chaine -> Objet

    if (this.selecteditem !== undefined) {
      this.selectedItemObj = JSON.parse(this.selecteditem) as IItemBtm;         // conversion : chaine -> Objet IItemBtm
    }
    this.selectedItemObj = this.storedService.getInitializedItem(this.selectedItemObj, this.group);
  }

  onChange(event: any) {                      // l'utilisateur clic sur un des choix du composant
    console.log('depuis le composant, action dans onChange() : (clic sur un choix)');

    const item: IItemBtm = this.itemsObj.filter((item: IItemBtm) => item.key == event.value)[0];  // récupère l'objet entier par la clé : KEY
    this.selectedItemObj = item;
    this.storedService.setSelectedItem(item, this.group);
    this.selectedItemEvent.emit(item);        // envoi au contexte web (hors Angular) l'item qui a été sélectionné
  }
}

/src/app/button-toggle-mat/components/button-toggle-mat/button-toggle-mat.component.css

 
Sélectionnez
1.
@import '@angular/material/prebuilt-themes/deeppurple-amber.css';

/elements/index.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
<!doctype html>
<html lang="fr">
<head>
  <title>Angular elements</title>
</head>
<body>

  <div style="background: #faffee; padding: 32px;">
    <h3>origine : index.html</h3>

    <button id="choice-2">mise à jour avec le choix 2</button>
    <p id="choice-value"></p>

    <hr>

    <div style="background: #ffcfff; padding: 32px; margin-left: 32px;">
      <h3>origine : dans le composant : ButtonToggleMat</h3>

      <button-toggle-mat
        id="btm1"
        items='[{"key":"KEY1", "value":"choix 1"}, {"key":"KEY2", "value":"choix 2"}]'
        selecteditem='{"key":"KEY1", "value":"choix 1"}'
        group="'choice'"
      ></button-toggle-mat>

    </div>
  </div>

  <!-- le fichier : web-comp-tbm.js (le composant version JavaScript) -->
  <script src="web-comp-tbm.js"></script>

  <script>
    const btm = document.getElementById('btm1');              // 'btm1' est l'ID de l'élément
    const text = document.getElementById('choice-value');     // l'élément HTML pour afficher le choix en cours

    btm.addEventListener('selectedItemEvent', event => {      // on se branche sur la sortie Event du composant. «selectedItemEvent» -> voir Output() du composant
      text.innerHTML = JSON.stringify(event.detail);          // met à jour l'élément HTML : text avec la valeur reçue du composant
    });

    document.getElementById('choice-2').addEventListener('click', event => {  // on écoute l'élément HTML, si un clic est effectué
      const obj = {"key":"KEY2", "value":"choix 2"};

      btm.selecteditem = JSON.stringify(obj);                                 // on met à jour le @Input() du composant avec la nouvelle sélection
      // ou : btm.setAttribute('selecteditem', JSON.stringify(obj));          // dans un composant, quand un @Input est modifié cela déclenche : ngOnChanges() du composant
      text.innerHTML = JSON.stringify(obj);                                   // met à jour l'élément HTML : text
    });
  </script>
</body>
</html>

Compile, concatène les fichiers et met le résultat dans un dossier : /elements (avec le fichier : index.html déjà présent).

 
Sélectionnez
1.
npm run build:elements

Pour pouvoir nous servir du fichier : index.html nous allons utiliser un serveur : node.js.

Installation du package en global :

 
Sélectionnez
1.
npm install http-server -g

Et lancement du serveur dans le dossier en question :

 
Sélectionnez
1.
2.
cd /elements
http-server

http://192.168.1.39:8080/

XXVII-C. Comment utiliser ce composant web classique dans un projet Angular

(1) Copier / coller le dossier : /elements dans un nouveau projet : app/web-components/elements

(2) Importer ensuite le fichier : web-comp-tbm.js dans le module : app.module.ts

app.module.ts

 
Sélectionnez
1.
2.
3.
...
import './web-components/elements/web-comp-tbm.js';         // juste cette ligne et rien d'autre
...

(3) Plus qu'à l'utiliser dans un composant Angular :

xxxx.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
<button-toggle-mat
items='[{"key":"KEY1", "value":"choix 1"}, {"key":"KEY2", "value":"choix 2"}]'
selecteditem='{"key":"KEY2", "value":"choix 2"}'
group="'choice'"
></button-toggle-mat>

XXVIII. Docker

Docker fournit un environnement de déploiement pour chaque projet.

On travaille souvent sur plusieurs projets en même temps ou alors on veut fournir simplement le même environnement de travail aux collègues pour qu'ils puissent intervenir sur un projet.

Sans cela, il faudrait installer un environnement de travail sur son propre système pour chaque projet.

Il y a quelques années on utilisait les machines virtuelles avec vmware ou virtualbox, mais ces solutions sont très coûteuses en place et en performance.
Docker apporte simplicité, performance et taille réduite.

XXVIII-A. Installation

Télécharger et installer Docker Desktop sur votre système.
Docker Desktop est une application native qui fournit tous les outils Docker à votre ordinateur.

https://www.docker.com/

Sur le Docker Desktop, il faut créer un compte et se connecter.

XXVIII-B. Remarques

XXVIII-C. Pratique

XXVIII-C-1. Cas 1 : simplement tester la version en prod (/dist)

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
ng new angular-docker1
NO
SCSS

cd angular-docker1

ng build --prod                       // générer l'application dans /dist

Créer le fichier Dockerfile (sans extension) dans le projet Angular :

/angular-docker1/Dockerfile-prod

 
Sélectionnez
1.
2.
3.
4.
FROM nginx:1.17.1-alpine
WORKDIR /usr/share/nginx/html
COPY nginx.conf /etc/nginx/nginx.conf
COPY ./dist/angular-docker1 /usr/share/nginx/html

Créer le fichier : nginx.conf pour configurer le serveur NGINX afin de fournir l'application Angular :

/angular-docker1/nginx.conf

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
events {
        worker_connections 768;
        # multi_accept on;
}

http {
    include /etc/nginx/mime.types;
    server {
        listen 80;
        server_name localhost;
        root /usr/share/nginx/html;
        index index.html;
        location / {
            try_files $uri $uri/ /index.html;
        }
    }
}

Créer une image Docker :

 
Sélectionnez
1.
2.
3.
4.
docker build -f Dockerfile-prod -t angular-docker1-prod-image .

// -f 		préciser le fichier Docker qui correspond à la version en production
// -t		indiquer le nom de l'image que l'on veut obtenir

Créer le container (à partir de l'image) :

 
Sélectionnez
1.
2.
3.
4.
5.
6.
docker run --name angular-docker1-prod-container -d -p 3000:80 angular-docker1-prod-image

--name angular-docker1-prod-container               nom du container utilisé
-d                                                	en arrière plan
-p 3000:80                                        	le port du container à votre local (le port : 3000 en local correspond au port : 80 dans le container)
angular-docker1-prod-image                          nommage de l'image docker que l'on souhaite

Accéder à l'application Angular qui tourne dans un container Docker via le port : 3000 à cette adresse : http://localhost:3000

XXVIII-C-2. Cas 2 : en dev avec le hot reload (ou live reload)

 
Sélectionnez
1.
cd angular-docker1

/angular-docker1/Dockerfile-dev

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
FROM node:12-alpine 
WORKDIR /app
COPY package.json .
RUN npm install
COPY . .
EXPOSE 5600 49153
CMD npm run start

/angular-docker1/docker-compose.yml

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
version: "3.7"
services:
  dashboard:
    build:
      context: .
      dockerfile: Dockerfile-dev
    ports:
      - "5600:4200"
      - "49153:49153"
    volumes:
      - "/app/node_modules"
      - ".:/app"

/angular-docker1/package.json

 
Sélectionnez
1.
2.
3.
4.
5.
6.
...
    "start": "ng serve --host 0.0.0.0 --poll 500",                      // si votre système est un Windows
                                                                        // --poll 500       vérifie toutes les 500ms une éventuelle modification du code
...    
    "start": "ng serve --host 0.0.0.0",                                 // si votre système est un linux
...
 
Sélectionnez
1.
2.
3.
docker-compose up

// ignorer les WARN

http://localhost:5600/

Faites des modifications de code et constatez que le live reload fonctionne.

XXVIII-C-2-a. À savoir

Dans le Docker Desktop, on peut visionner les containers en cours. S'ils sont marqués dans l'état « running » c'est parfait, sinon, cela indique une éventuelle erreur.

XXVIII-C-3. Remarques

Vous avez sans doute remarqué que pour la version en production c'est le serveur : nginx qui doit founir les fichiers.

Pour la version en développement, c'est la commande : ng qui s'occupe de cette tâche afin d'avoir le live-reload.

XXVIII-C-4. Quelques commandes utiles

On peut faire un certain nombre d'actions sur les images et containers avec le Docker Desktop (voir, supprimer, relancer).

En ligne de commande, on peut aussi effectuer ces actions :

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
docker image ls                             // lister toutes les images qui tournent sur votre machine
docker container ls                         // lister tous les containers qui tournent sur votre machine

docker-compose up                           // lancer la procédure de création des images et containers (des fichiers : Dockerfile et docker-compose.yml)
docker-compose build                        // si on modifie :  Dockerfile ou docker-compose.yml
docker ps -a                                // lister tous les containers qui tournent sur votre machine
docker rm $(docker ps -a -q)                // supprimer tous les containers
docker rmi $(docker images -q)                // supprimer toutes les images

Accéder en ligne de commande dans un container :

 
Sélectionnez
1.
2.
docker ps -a                        // notez les 2 ou 3 premières lettres du CONTAINER_ID sur lequel vous voulez aller (pas besoin de noter l'ID entier)            
docker exec -it ??? /bin/bash        // remplacez ??? par le CONTAINER_ID que vous avez noté

XXVIII-D. ngx-deploy-docker

XXVIII-D-1. prod

Précédemment nous avons écrit à la main les fichiers Dockerfile et nginx.

cette fois le package ngx-deploy-docker va le faire à notre place.

https://www.npmjs.com/package/ngx-deploy-docker

 
Sélectionnez
1.
2.
ng new angular-ngx-docker1
cd angular-ngx-docker1

Installer le package avec ng add (ng add permet entre autres de créer des fichiers à notre place).

(cela va vous demander l'id utilisateur de votre compte Docker).

 
Sélectionnez
1.
ng add ngx-deploy-docker

Cela va créer automatiquement un fichier : Dockerfile et un fichier nginx.conf.

Facultatif : Une petite vérification pour voir si vous être bien connecté à Docker avec votre compte.

 
Sélectionnez
1.
docker login

Déployez votre nouvelle image. Votre projet sera automatiquement construit en mode production :

 
Sélectionnez
1.
ng deploy

Chercher le nom de l'image qui a été créée précédemment :

 
Sélectionnez
1.
docker image ls

Éxecuter le container à partir de l'image, nous choisissons le port 3000 :

 
Sélectionnez
1.
2.
3.
4.
5.
docker run --name angular-ng-docker1-container -d -p 3000:80 ???????????/angular-ng-docker1

    -p 3000:80                                    // le port 3000 pour accéder à l'application
    --name angular-ng-docker1-container         // on donne un nom pour le container
    docker91019/angular-ng-docker1                // le nom de l'image du : 'docker image ls'

localhost:3000

XXIX. Étude de cas n°1 : authentification + accès sécurisé à une API

Dans cet exemple de projet, nous allons mettre en place une application qui va se connecter à un serveur d'authentification JWT et récupérer des produits. Dans le dossier : /pack_auth1, le projet est donc divisé en deux parties :

  • /pack_auth1

    • /angular-auth-jwt1 l'application Angular.
    • /node-api le serveur node.js.

Pour l'application Angular, voici les fonctionnalités :

  • se connecter ;
  • s'inscrire ;
  • accéder à une API sécurisée ;
  • sur la page 1, n'afficher les produits que si un utilisateur est connecté ;
  • n'accéder à la page 2 que si un utilisateur est connecté.

Pour le serveur node.js :

  • /login : reçoit l'email et le mot de passe, vérifie que l'utilisateur existe et renvoit un token + les rôles.
  • /register : reçoit l'email et le mot de passe, enregistre l'utilisateur et renvoit un token + les rôles.
  • /api/products : renvoie une liste de produits en json, si dans la requête est présent un token qui correspond à un utilisateur existant.

XXIX-A. Limitation

Pour ne pas alourdir le tutoriel, j'ai volontairement limité certains points :

  • l'API serveur envoie une liste de produits et rien d'autre ;
  • le refresh token n'est pas pris en compte ;
  • à l'enregistrement d'un compte, pour l'exemple, on met le rôle "admin";
  • le design et l'ergonomie ne sont pas au point.
  • c'est une authentification par token et ce dernier on l'enregistre coté client (JavaScript), c'est moyen niveau sécurité. J'ai fait ce choix pour ne pas alourdir le tutoriel.
  • pour un niveau de sécurité maximum, on aurait pu utiliser une authentification par cookie :

    • pour cela, il faut prévoir la gestion du cookie coté serveur ;
    • à la connexion (login), le serveur sauvegarde le token dans un cookie tout en l'associant à l'identité (id...) de celui qui s'est connecté ;
    • ainsi quand vous demandez d'accèder à une ressources api, le serveur vérifie dans le cookie le token et autorise ou pas l'accès ;
    • quand on envoi une requête à un serveur, celui çi sait qui vous êtes, si vous vous êtes connecté auparavant... grâce au cookie coté serveur ;

XXIX-B. Schéma

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
/pack_auth1
        /angular-auth-jwt1
                /core 
                    /auth 
                    	/directives
                    		hasRole				// une directive pour limiter certaines parties aux utilisateurs avec les rôles appropriés
                    	/enums
                    		role				// liste des rôles
                        /interceptors
                            jwt                 // intercepte les requêtes vers : /API pour lui ajouter le token de l'utilisateur connecté
                        /models
                            i-current-user      // modèle de l'utilisateur courant, contient : l'état, le token...
                        /services
                            auth                // code métier pour l'authentification d'un utilisateur
                        /guards
                            logged              // donne l'accès à une page si un utilisateur est authentifié
                    /http
                        /models
                            base                // doit posséder un id (comme toute entité d'une API digne de ce nom)
                        /services
                            http                // code métier pour effectuer les requêtes http : get, post...
                    
                /features
                    /auth
                        /components
                            /login
                                ... composant
                            /register
                                /validators
                                    MustMatch
                                ... composant
                    /product
                        /models
                            i-product
                        /services
                            product-api         // utlise le service de requêtes : http.service situé dans : /core/auth

                /pages
                    /page-home
                        ... routing + module + composant
                    /page-register
                        ... routing + module + composant
                    /page-login
                        ... routing + module + composant                        
                    /page1                                          // affiche les produits si un utilisateur est authentifié
                        ... routing + module + composant                    
                    /page2                                          // page2 est accessible si un utilisateur est authentifié
                        ... routing + module + composant
                    /partials
                        /header
                            ... module + composant

                /shared
                    /material-design

                app     
                    ... routing + module + composant

        \node-api
                server.js           // serveur d'authentification JWT (login + inscription) + api/products
                package.json
                ...

        docker-compose.yml      // lance deux containers basés sur les images ci dessous. (appli. Angular: http://localhost:5600) (serveur node: http://localhost:8000)
        Dockerfile.ng-app       // image de l'application Angular en mode DEV (live-reload)
        Dockerfile.node-api     // image du serveur node.js : serveur d'authentification JWT + API de produits (liste en json)

Les pages utilisent les features et l'ensemble utilise core.
Tout est bien classé, organisé. Vous pouvez reprendre le dossier /core pour un autre projet.

XXIX-C. L'application Angular : /angular-auth-jwt1

XXIX-C-1. À savoir

XXIX-C-1-a. Interceptors

Les intercepteurs nous permettent d'intercepter les requêtes HTTP entrantes ou sortantes à l'aide du HttpClient. En interceptant la requête HTTP, nous pouvons modifier ou changer la valeur de la requête.

Pour l'application ?

Nous l'utilisons pour les requêtes http vers l'api.
En effet, plutôt que de rajouter le token d'accès directement aux requêtes http de base : get, post… nous interceptons les requêtes vers l'APIet lui ajoutons le token.

XXIX-C-1-b. Guards

Les gardes de route d'Angular sont des interfaces qui peuvent dire au routeur si oui ou non il doit permettre la navigation selon un itinéraire demandé. On peut l'autoriser ou pas en fonction de divers critères que l'on détermine : l'utilisateur est authentifié ? Il a un rôle précis ?
Les différents types de guard : CanActivate, CanActivateChild, CanDeactivate, CanLoad et Resolve.

Pour l'application ?

Nous devons autoriser la navigation vers la page 2 si l'utilisateur est connecté.
Pour cela, nous utiliserons : CanActivate

XXIX-C-1-c. JWT

Qu'est-ce que JWT ?

JSON web Token est un standard utilisé pour créer des jetons d'accès pour une application.
Le serveur génère un jeton qui certifie l'identité de l'utilisateur et l'envoie au client.
Le client renverra le jeton au serveur pour chaque demande suivante, afin que le serveur sache que la demande provient d'une identité particulière.

Pour l'application ?

Autoriser l'accès aux produits de l'API uniquement aux utilisateurs authentifiés (ayant un token valide).

XXIX-C-1-d. Le service http et les generics

Nous voulons écrire un service http qui s'adapte à tous les types de données : IProduct, ICategory, IOrder… plutôt que d'écrire un service http par type de données.

Par exemple, pour accéder à l'API product, on pourrait avoir :

product-api.service.ts

 
Sélectionnez
1.
2.
3.
4.
this.httpClient.get<IProduct[]>(...
this.httpClient.delete<IProduct>(...
this.httpClient.post<IProduct>(...
...

Les requêtes sont dépendantes du type IProduct
Il faut donc écrire un service avec le même code pour chaque type différent.

La solution est d'utiliser les generics de TypeScript :

http.service.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
export abstract class HttpService<T> {
    ...
    this.httpClient.get<T[]>(...
    this.httpClient.delete<T>(...
    this.httpClient.post<T>(...    
}

Ainsi T peut valoir : IProduct, ICategory…

Son utilisation est la suivante, par exemple :

category-api.service.ts

 
Sélectionnez
1.
2.
export class CategoryApiService extends HttpService<ICategory> {    // <ICategory>  on précise le type que l'on veut pour : T
}

product-api.service.ts

 
Sélectionnez
1.
2.
export class ProductApiService extends HttpService<IProduct> {      // <IProduct>   on précise le type que l'on veut pour : T
}
XXIX-C-1-e. Le modèle de l'utilisateur courant ICurrentUser et le service auth.service.ts

Le modèle ICurrentUser permet de sauvegarder toutes les informations concernant une authentification de l'utilisateur courant.
Il est inscrit dans le service auth.service dans un Observable.

/core/auth/models/i-current-user.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
export interface ICurrentUser {
  email?: string;
  password?: string;
  token?: string;
  isLogged?: boolean;
  ...

Le service AuthService

/core/auth/services/auth.service.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
...
  private currentUserSubject = new BehaviorSubject<ICurrentUser>({} as ICurrentUser);
  public currentUser$: Observable<ICurrentUser>;

  constructor(private http: HttpClient) {
    this.currentUser$ = this.currentUserSubject.asObservable();         
  }  
...

Tous les composants qui souscrivent à currentUserSubject seront informés de la connexion ou de la déconnexion d'un utilisateur et recevront les informations de l'utilisateur courant ICurrentUser

L'application devra donc émettre l'état de : ICurrentUser sur cet observable à ces moments clés :

  • au lancement de l'application ;
  • à la connexion ;
  • à l'inscription ;
  • à la déconnexion.

Nous avons choisi le sujet de type BehaviorSubject afin que si un composant (ou page) est initialisé plus tard, à la souscription, il reçoive automatiquement le dernier état courant de l'utilisateur.

Par exemple le composant responsable du message de bienvenue s'abonne à cet observable afin de connaitre en temps réel si un utilisateur c'est connecté ou déconnecté.

XXIX-C-1-f. Bonnes pratiques

Un Subject est à la fois un Observable où l’on peut souscrire et un Observer où l’on peut émettre.
Avec un Observable on peut uniquement souscrire.

Avec :

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
...
  private currentUserSubject = new BehaviorSubject<ICurrentUser>({} as ICurrentUser);   // Observable et Observer
  public currentUser$: Observable<ICurrentUser>;                                        // Observable
...
  constructor(private http: HttpClient) {
    this.currentUser$ = this.currentUserSubject.asObservable();        // Observable : un lien vers l'observable du sujet : currentUserSubject  
...
 
Sélectionnez
1.
currentUser$     --------->     est la partie observable de currentUserSubject
  • pour un composant qui ne veut que souscrire on utilise : currentUser$.subscribe(...
  • pour un composant qui doit également émettre un nouvel utilisateur, on utilise : currentUserSubject.

Pourquoi est-ce une bonne pratique ?

Un composant qui a pour seule responsabilité de souscrire ne doit pas pouvoir émettre afin d'éviter toute erreur.

XXIX-C-2. Pratique

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
cd pack_auth1

ng new angular-auth-jwt1
	strict ?  NO
    routing ? yes
    SCSS

cd angular-auth-jwt1

ng g m pages --module=app
ng g m features --module=pages
ng g m core --module=features
ng g m core --module=pages --force

ng g m pages/page-home --module=pages --routing
ng g c pages/page-home --module=page-home
ng g m pages/page1 --module=pages --routing
ng g c pages/page1 --module=page1
ng g m pages/page2 --module=pages --routing
ng g c pages/page2 --module=page2
ng g m pages/page-register --module=pages --routing
ng g c pages/page-register --module=page-register
ng g m pages/page-login --module=pages --routing
ng g c pages/page-login --module=page-login
ng g m pages/partials --module=pages
ng g c pages/partials/header --module=partials

ng g m features/auth --module=features
ng g c features/auth/components/login --module=auth
ng g c features/auth/components/register --module=auth
ng g m features/product --module=features
ng g s features/product/services/product-api
ng g i features/product/models/i-product

ng g m shared/material-design --module=app

ng g s core/auth/services/auth
ng g i core/auth/models/i-current-user
ng g interceptor core/auth/interceptors/jwt
ng g guard core/auth/guards/logged
    (*)  CanActivate
ng g s core/http/services/http
ng g i core/http/models/base
ng g d core/auth/directives/has-role --module=core
 
Sélectionnez
1.
ng add @angular/material
XXIX-C-2-a. /core

\core\auth\directives\has-role.directive.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
import { Directive, Input, ViewContainerRef, TemplateRef, OnInit, OnDestroy,  } from '@angular/core';
import { Subscription } from 'rxjs';
import { ICurrentUser } from '../models/i-current-user';
import { AuthService } from '../services/auth.service';

@Directive({
  selector: '[appHasRole]'
})
export class HasRoleDirective implements OnInit, OnDestroy {
  @Input() appHasRole: Array<string>;   // réception de la valeur(du rôle souhaité) défini dans le template
  subCurrentUserObs: Subscription;      // pour contenir l'observable (afin de pouvoir se désabonner dans le ngOnDestroy)

  constructor(
    private viewContainerRef: ViewContainerRef,
    private templateRef: TemplateRef<any>,
    private authService: AuthService
  ) {}

  ngOnInit(): void {

    // on souscrit à CurrentUserObs et donc à chaque changement d'utilisateur, on reçoit le nouveau : user
    this.subCurrentUserObs = this.authService.getCurrentUserObs().subscribe((user: ICurrentUser) => {

      // on oblige à ce qu'il y est au moins un rôle qui est défini dans l'utilisation de la directive du template
      if (!this.appHasRole || !this.appHasRole.length) {
        throw new Error('attention, il n\'y a pas de rôle défini');
      }

      let hasAccess = false;
      if (user.roles) {
          hasAccess = user.roles.some(role => this.appHasRole.includes(role));    // some --> pour tous les roles contenu dans user
      }
      if (hasAccess) {
          this.viewContainerRef.createEmbeddedView(this.templateRef);
      } else {
          this.viewContainerRef.clear();
      }
    });
  }

  ngOnDestroy(): void {
    this.subCurrentUserObs.unsubscribe();   // important : toujours, toujours se désabonner !
  }
}

\core\auth\enums\role-enum.ts

 
Sélectionnez
1.
2.
3.
4.
export enum RoleEnum {
  ADMIN = "admin",
  USER = "user",
}

/core/auth/guards/logged.guard.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
import { Injectable } from '@angular/core';
import { CanActivate, ActivatedRouteSnapshot, RouterStateSnapshot, UrlTree } from '@angular/router';
import { Observable } from 'rxjs';
import { AuthService } from '../../auth/services/auth.service';

@Injectable({
  providedIn: 'root'
})
export class LoggedGuard implements CanActivate {       // on implémente l'interface : CanActivate
                                                        // liste des autres interfaces : CanActivate, CanActivateChild, CanDeactivate, CanLoad et Resolve
                                                        // vous pouvez allez voir son utilisation pour la page 2 dans : app-routing.module.ts
  constructor(private authService: AuthService){}

  canActivate(route: ActivatedRouteSnapshot, state: RouterStateSnapshot): Observable<boolean | UrlTree> | Promise<boolean | UrlTree> | boolean | UrlTree {
      return this.authService.isLogged();               // isLogged est un observable qui retourne true ou false
  }

  // remarquez les différents types que l'on peut retourner avec la méthode : canActivate
  // ------->  : Observable<boolean | UrlTree> | Promise<boolean | UrlTree> | boolean | UrlTree
}

/core/auth/interceptors/jwt.interceptor.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
import { Injectable } from '@angular/core';
import { HttpRequest, HttpHandler, HttpEvent, HttpInterceptor } from '@angular/common/http';
import { AuthService } from '../services/auth.service';
import { Observable, throwError } from 'rxjs';
import { catchError } from 'rxjs/operators';
import { ICurrentUser } from '../models/i-current-user';
import { environment } from 'src/environments/environment';

@Injectable()
export class JwtInterceptor implements HttpInterceptor {

  constructor(public authService: AuthService) { }

  intercept(request: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>> {

    const isApiUrl = request.url.startsWith(environment.urlApi + '/' + environment.pathApi);    

    if (isApiUrl) {                                             // si c'est une requête vers l'api
      const currentUser: ICurrentUser = this.authService.currentUserValue;

      if (currentUser && currentUser.token) {
        request = this.addToken(request, currentUser.token);    // on ajoute le token à la requête
      }

      return next.handle(request).pipe(                         // on envoie la requête

        catchError((error) => {                                 // gestion d'une éventuelle erreur

          if (error.error.status == 401) {                      // si l'erreur est : 401 Unauthorized

            this.authService.logout();                          // si pas de refresh token, on se déconnecte (car le token est non valide)
                                                                // en effet le token peut devenir non valide lorsqu'il a expiré
                                                                // le temps d'expiration est réglable dans le fichier /node-api/server.js 
            //
            //  avec un refresh token, mettez en place ici la demande d'un nouveau token
            //
          }
          return throwError(error);                             // déclenche une erreur
        })
      );
    }

    return next.handle(request);        // si ce n'est pas une requête vers l'api, alors on la renvoie tel quelle 
  }

  private addToken(request: HttpRequest<any>, token: string) {
    return request.clone({
      setHeaders: {
        'Authorization': `Bearer ${token}`
      }
    });
  }
}

/core/auth/models/i-current-user.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
export interface ICurrentUser {
  userId?: string;
  email?: string;
  password?: string;
  name?: string;
  username?: string;
  roles?: Array<string>;  
  token?: string;
  refresh_token?: string;
  isLogged?: boolean;
}

/core/auth/services/auth.service.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
86.
87.
88.
89.
90.
91.
92.
93.
94.
95.
96.
97.
98.
99.
100.
101.
102.
103.
104.
105.
106.
107.
108.
109.
110.
111.
112.
113.
114.
115.
116.
117.
118.
119.
import { Injectable } from '@angular/core';
import { HttpClient, HttpHeaders, HttpErrorResponse  } from '@angular/common/http';
import { BehaviorSubject, Observable, throwError } from 'rxjs';
import { catchError, map, take } from 'rxjs/operators';
import { environment } from '../../../../environments/environment';
import { ICurrentUser } from '../models/i-current-user';

const httpOptions = {
  headers: new HttpHeaders({ 'Content-Type': 'application/json' }),
};

export interface Data {         // à la connexion et à l'enregistrement, l'api retourne ces 2 champs :
  access_token: string;
  roles: Array<string>;
}

@Injectable({
  providedIn: 'root',
})
export class AuthService {
  private currentUserSubject = new BehaviorSubject<ICurrentUser>({} as ICurrentUser);
  private currentUser$: Observable<ICurrentUser>;

  constructor(private http: HttpClient) {
    this.currentUser$ = this.currentUserSubject.asObservable();
  }

  public get currentUserValue(): ICurrentUser {                 // récupère directement la valeur contenu dans le sujet
    return this.currentUserSubject.getValue();
  }

  getCurrentUserSubject(): BehaviorSubject<ICurrentUser> {      // currentUserSubject est private donc il faut une fonction pour le retourner à qui le demande
    return this.currentUserSubject;
  }

  getCurrentUserObs(): Observable<ICurrentUser> {               // la partie Observable de currentUserSubject
    return this.currentUser$;
  }

  login(email: string, password: string): Observable<ICurrentUser> {
    return this.http
      .post<Data>(
        `${environment.urlApi}/${environment.pathAuth}/login`,  // environnement est soit celui en PROD ou en DEV, voir : /src/environnements
        { email, password },
        httpOptions
      )
      .pipe(                            // pipe : pour indiquer que l'on va utiliser une série de traitement
        map((data: Data) => {           // map : on traite les données avant de l'envoyer
                                        // data { access_token: string; roles: Array<string>} et ICurrentUser { ..., roles?: Array<string>; token?: string; ...}
                                        // on remarque que des 2 cotés la syntaxe "roles" et le type sont égaux
                                        // par contre, access_token d'un coté et token de l'autre, je l'ai fait exprés pour vous donner un exemple
                                        // disons qu'on ne peut pas modifier celui envoyé par le serveur et on ne veut pas modifier ici dans le front
                                        // alors dans ce cas, on ré-ecrit le json de la façon suivante :
          return {
            roles: data.roles,          // on met dans la propriété roles le contenu de : data.roles
            token: data.access_token    // on met dans la propriété token le contenu de : data.access_token
          } as ICurrentUser;            // de plus on cast l'objet en : ICurrentUser, pour indiquer qu'on veut absolument que l'objet soit du type : ICurrentUser
        }),
        catchError(this.handleError)    // intercepte une éventuelle erreur et la renvoit dans la méthode :  handleError afin qu'elle y soit géré
                                        // (pour déporter et factoriser la gestion d'erreur)
      );
  }

  register(email: string, password: string): Observable<ICurrentUser> {
    return this.http
      .post<Data>(
        `${environment.urlApi}/${environment.pathAuth}/register`,
        { email, password },
        httpOptions
      ).pipe(
        map((data: Data) => {           // à propos de Data, on type le retour car on s'attends à recevoir des données sous la forme de Data : { access_token: string; roles: Array<string>}
                                        // si un jour, une erreur arrive sur le back, que l'on ne reçoit pas exactement le type Data alors une erreur survient ici sur le front.
                                        // (si un changement a lieu sur le back alors ils doivent avertir les devs front qu'une modification à eu lieu pour faire un correctif)
                                        // de plus , grace au typage, l'erreur est detecté très tôt dans le code et le jour d'un problème on sait exactement ou cela se situe
                                        // si on avait mis "data: any", il n'y aurait pas eu d'erreur, le code aurait continué jusqu'à faire une autre erreur ou bizarrerie de fonctionnement
                                        // et cela aurait été plus difficile à débugguer ou engendrer des données éronnées en base de données
          return {
            roles: data.roles,
            token: data.access_token
          } as ICurrentUser;
        }),
        catchError(this.handleError)
      );
  }

  logout() {
    const user = {} as ICurrentUser;        // un currentUser vide
    this.updateAndEmitCurrentUser(user);             // on enregistre et informe qu'une déconnexion à eu lieu
  }

  isLogged(): Observable<boolean> {
    return this.currentUser$.pipe(
      map((user: ICurrentUser) => user.isLogged),   // la valeur qui doit être retourné est : isLogged, les autres ne nous intéresse pas
      take(1)
    );
  }

  updateCurrentUser(user: ICurrentUser) {
    this.updateAndEmitCurrentUser(user);
  }

  updateAndEmitCurrentUser(user: ICurrentUser) {
    localStorage.setItem("currentUser", JSON.stringify(user));      // on enregistre dans une petite base de donnée du navigateur.
                                                                    // on ne l'utilise pas mais je le laisse pour l'exemple au cas ou
    this.currentUserSubject.next(user);     // on informe tous les souscripteurs d'un nouvel état de : ICurrentUser
  }

  // Error
  handleError(error: HttpErrorResponse) {
    if (error.error instanceof ErrorEvent) {
      // client-side error
      console.log('client-side error')
      return throwError(error.error.message);
    }
    // server-side error
    console.log('server-side error')
    return throwError(error);
  }
}

/core/http/models/base.ts

 
Sélectionnez
1.
2.
3.
export interface Base {
  id: number
}

/core/http/services/http.service.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
import { Injectable } from '@angular/core';
import { Observable, throwError } from 'rxjs';
import { catchError } from 'rxjs/operators';
import { HttpClient, HttpErrorResponse, HttpHeaders } from '@angular/common/http';
import { Base } from '../models/base';

@Injectable({
  providedIn: 'root'
})
export class HttpService<T extends Base> {

  constructor(private httpClient: HttpClient, private url: string, private path: string, private endpoint: string) {
  }

  httpOptions = {
    headers: new HttpHeaders({ 'Content-Type': 'application/json' })
  }

  get(): Observable<T[]> {
    return this.httpClient
      .get<T[]>(`${this.url}/${this.path}/${this.endpoint}`)
      .pipe(
        catchError(this.handleError)
      )
  }

  getById(id: number): Observable<T> {
    return this.httpClient
      .get<T>(`${this.url}/${this.path}/${this.endpoint}/${id}`)
      .pipe(
        catchError(this.handleError)
      )
  }

  create(item: T): Observable<T> {
    return this.httpClient.post<T>(`${this.url}/${this.path}/${this.endpoint}`, JSON.stringify(item), this.httpOptions)
      .pipe(
        catchError(this.handleError)
      )
  }

  update(item: T): Observable<T> {
    return this.httpClient.put<T>(`${this.url}/${this.path}/${this.endpoint}/${item.id}`, JSON.stringify(item), this.httpOptions)
      .pipe(
        catchError(this.handleError)
      )
  }

  delete(item: T) {
    return this.httpClient.delete<T>(`${this.url}/${this.path}/${this.endpoint}/${item.id}`, this.httpOptions)
      .pipe(
        catchError(this.handleError)
      )
  }

  private handleError(error: HttpErrorResponse){
    let errorMessage = '';

    if(error.error instanceof ErrorEvent){
      // error client
      errorMessage = error.error.message;
    } else {
      // error server
      errorMessage = `error status: ${error.status}, ` + `error message: ${error.message}`;
    }
    return throwError(errorMessage);
  }
}

abstract :

Vous avez remarquez le mot abstract dans la définition de la classe.

Cela permet d'indiquer que la classe sera abstraite, qu'elle ne peut pas être instancié en faisant : new HttpService()

Est seulement autorisé, qu'une classe étend celle-ci : class ........ extends HttpService...



/core/core.module.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
import { NgModule } from '@angular/core';
import { CommonModule } from '@angular/common';
import { HasRoleDirective } from './auth/directives/has-role.directive';

@NgModule({
  declarations: [HasRoleDirective],
  imports: [
    CommonModule
  ],
  exports: [HasRoleDirective]			// ne pas oublier d'exporter la directive pour être utilisé ailleurs lors d'un import de CoreModule
})
export class CoreModule { }
XXIX-C-2-b. /features

/features/auth/components/login/login.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
<p>login works!</p>

<div id="container">
  <form [formGroup]="loginForm" (ngSubmit)="onSubmit()">

    <div>
      <mat-form-field appearance="fill" class="example-full-width">
        <mat-label>email</mat-label>
        <input matInput placeholder = "Entrez votre email" formControlName = "email" class="form-control" [ngClass]="{ 'is-invalid': submitted && f.email.errors }">
        <mat-error *ngIf="submitted && f.email.errors" class="invalid-feedback">
          <div *ngIf="f.email.errors.required">L'email est <strong>obligatoire</strong></div>
          <div *ngIf="f.email.errors.email">L'email doit être dans un format valide</div>
        </mat-error>
      </mat-form-field>
    </div>

    <div style="height: 12px;"></div>

    <div>
      <mat-form-field appearance="fill" class="example-full-width">
        <mat-label>Password</mat-label>
        <input matInput #password placeholder = "Entrez votre email" formControlName = "password" class="form-control" [ngClass]="{ 'is-invalid': submitted && f.password.errors }">
        <mat-hint>{{password.value?.length || 0}} caractère(s) (6 minimum)</mat-hint>
        <mat-error *ngIf="submitted && f.password.errors" class="invalid-feedback">
          <div *ngIf="f.password.errors.required">Le mot de passe est <strong>obligatoire</strong></div>
          <div *ngIf="f.password.errors.minlength">Le mot de passe doit contenir au moins 6 caractères</div>
        </mat-error>
      </mat-form-field>
    </div>

    <div style="height: 24px;"></div>

    <div>
      <button mat-raised-button color="accent" type="reset" (click)="cancel()">Effacer</button>
      &nbsp;
      <button mat-raised-button color="primary" type="submit">Se connecter</button>
    </div>

    <div *ngIf="error">
      <div style="height: 24px;"></div>

      <mat-error  class="invalid-feedback">
        <div>{{error}}</div>
      </mat-error>
    </div>

  </form>
</div>

/features/auth/components/login/login.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
import { Component, OnInit, Output, EventEmitter } from '@angular/core';
import { FormBuilder, FormGroup, Validators } from '@angular/forms';
import { AuthService } from 'src/app/core/auth/services/auth.service';
import { Router } from '@angular/router';
import { ICurrentUser } from 'src/app/core/auth/models/i-current-user';
import { Subscription } from 'rxjs';

@Component({
  selector: 'app-login',
  templateUrl: './login.component.html',
  styleUrls: ['./login.component.scss']
})
export class LoginComponent implements OnInit {

  @Output() cancelEvent = new EventEmitter<boolean>();          // averti le parent que l'utilisateur souhaite fermer ou annuler la demande de connexion
                                                                // ainsi le parent peut fermer le composant : Login
  subLogin : Subscription;
  loginForm: FormGroup;
  submitted = false;
  error: string;

  constructor(private formBuilder: FormBuilder, private authService: AuthService, private router: Router) { }

  ngOnInit(): void {
      this.loginForm = this.formBuilder.group({
          email: ['', [Validators.required, Validators.email]],
          password: ['', [Validators.required, Validators.minLength(6)]],
      }, {

      });
  }

  get f() {
    return this.loginForm.controls;
  }

  onSubmit(): void {
    this.submitted = true;
    this.error = null;

    if (this.loginForm.invalid) {
      return;
    }

    this.subLogin = this.authService.login(this.loginForm.value.email, this.loginForm.value.password).subscribe((user: ICurrentUser) => {
      // initialisation
      user.isLogged = true;
      user.email = this.loginForm.value.email;
      // enregistre et émet le nouvel utilisateur pour les composants qui ont souscrit
      this.authService.updateAndEmitCurrentUser(user);
      // clos le formulaire de connexion
      this.cancelEvent.emit(true);
      // à la connexion, on se rends à la page : /home
      this.router.navigateByUrl('/home');
    },
    error => {
      if (error.status == 401) {
        this.error = 'l\'email ou le mot de passe est incorrect';
      }  else {
        this.error = error.message + ' status : ' + error.status;
      }
    });
  }

  cancel() {
    this.cancelEvent.emit(true);
  }

  ngOnDestroy(): void {
    if (this.subLogin) {
      this.subLogin.unsubscribe();          // important : toujours se désabonner !
    }
  }
}

/features/auth/components/login/login.component.scss

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
#container {
  display: flex;
  justify-content: space-around;
}

#container form {
  min-width: 296px;
}

/features/auth/components/register/register.component.html

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
<p>register works!</p>

<div id="container">
  <form [formGroup]="registerForm" (ngSubmit)="onSubmit()">

    <div>
      <mat-form-field appearance="fill" class="example-full-width">
        <mat-label>email</mat-label>
        <input matInput placeholder = "Entrez votre email" formControlName = "email" class="form-control" [ngClass]="{ 'is-invalid': submitted && f.email.errors }">
        <mat-error *ngIf="submitted && f.email.errors" class="invalid-feedback">
          <div *ngIf="f.email.errors.required">L'email est <strong>obligatoire</strong></div>
          <div *ngIf="f.email.errors.email">L'email doit être dans un format valide</div>
        </mat-error>
      </mat-form-field>
    </div>

    <div style="height: 12px;"></div>

    <div>
      <mat-form-field appearance="fill" class="example-full-width">
        <mat-label>Password</mat-label>
        <input matInput #password placeholder = "Entrez votre email" formControlName = "password" class="form-control" [ngClass]="{ 'is-invalid': submitted && f.password.errors }">
        <mat-hint>{{password.value?.length || 0}} caractère(s) (6 minimum)</mat-hint>
        <mat-error *ngIf="submitted && f.password.errors" class="invalid-feedback">
          <div *ngIf="f.password.errors.required">Le mot de passe est <strong>obligatoire</strong></div>
          <div *ngIf="f.password.errors.minlength">Le mot de passe doit contenir au moins 6 caractères</div>
        </mat-error>
      </mat-form-field>
    </div>

    <div style="height: 12px;"></div>

    <div>
      <mat-form-field appearance="fill" class="example-full-width">
        <mat-label>Confirme Password</mat-label>
        <input matInput placeholder = "Entrez votre email" formControlName = "confirmPassword" class="form-control" [ngClass]="{ 'is-invalid': submitted && f.confirmPassword.errors }">
        <mat-error *ngIf="submitted && f.confirmPassword.errors" class="invalid-feedback">
          <div *ngIf="f.confirmPassword.errors.required">La confirmation est <strong>obligatoire</strong></div>
          <div *ngIf="f.confirmPassword.errors.mustMatch">Les mots de passe sont différents</div>
        </mat-error>
      </mat-form-field>
    </div>


    <div style="height: 24px;"></div>

    <div>
      <button mat-raised-button color="accent" type="reset" (clic)="onReset()">Annuler</button>
      &nbsp;
      <button mat-raised-button color="primary" type="submit">Inscription</button>
    </div>

    <div *ngIf="error">
      <div style="height: 24px;"></div>

      <mat-error  class="invalid-feedback">
        <div>{{error}}</div>
      </mat-error>
    </div>

  </form>
</div>

/features/auth/components/register/register.component.scss

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
#container {
  display: flex;
  justify-content: space-around;
}

#container form {
  min-width: 296px;
}

/features/auth/components/register/register.component.ts

 
Sélectionnez
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
import { Component, OnInit } from '@angular/core';
import { FormBuilder, FormGroup, Validators } from '@angular/forms';
import { AuthService } from 'src/app/core/auth/services/auth.service';
import { MustMatch } from './validators/MustMatch';
import { Router } from '@angular/router';
import { ICurrentUser } from 'src/app/core/auth/models/i-current-user';
import { Subscription } from 'rxjs';

@Component({
  selector: 'app-register',
  templateUrl: './register.component.html',
  styleUrls: ['./register.component.scss']
})
export class RegisterComponent implements OnInit {

  registerForm: FormGroup;
  submitted = false;
  subRegister: Subscription;
  error: string;

  constructor(private formBuilder: FormBuilder, private authService: AuthService, private router: Router) { }

  ngOnInit(): void {
    this.registerForm = this.formBuilder.group({
        email: ['', [Validators.required, Validators.email]],
        password: ['', [Validators.required, Validators.minLength(6)]],
        confirmPassword: ['', Validators.required],
    }, {
        validator: MustMatch('password', 'confirmPassword')
    });


    this.registerForm.controls['email'].setValue('test1@test.fr');
    this.registerForm.controls['password'].setValue('222222');
    this.registerForm.controls['confirmPassword'].setValue('222222');
  }

  get f() {
    return this.registerForm.controls;
  }

  onSubmit(): void {
    this.submitted = true;
    this.error = null;

    if (this.registerForm.invalid) {
      return;
    }

    this.subRegister = this.authService.register(this.registerForm.value.email, this.registerForm.value.password).subscribe