Le Guide Angular
  • Le Guide Angular par Wishtack
  • Pourquoi Angular ?
  • ECMAScript 6+
    • Un Peu d'Histoire
    • Propriétés du Langage
    • "Single-Threaded" donc Asynchrone
    • Classes
    • Hoisting is Dead: var vs. let vs. const
    • this & "binding"
    • Arrow Functions
    • Template Strings
    • Syntactic Sugar
      • Spread
      • Destructuring
      • Rest
      • Object Literal Property Value Shorthand
    • Named Parameters
    • Compatibilité
  • TypeScript
    • Pourquoi TypeScript ?
    • De l'ECMAScript au TypeScript
    • Visibilité des Propriétés
    • Typing des Propriétés
    • Types
    • Interfaces
    • Inference
    • Duck Typing
    • Duck Typing Patterns
      • Compatibilité de Librairies
      • Entity Constructor
    • Décorateurs
      • Décorateurs de Propriété
      • Décorateurs de Classe
      • Décorateurs de Méthode & Paramètres
    • Quelques Liens
  • Tools
    • Git
    • Command Line
    • NodeJS
    • NPM
    • Yarn
      • Pourquoi Yarn ?
      • Définition et Installation des Dépendances
      • Scripts
      • Mise à Jour et Automatisation
    • Chrome
    • IntelliJ / WebStorm / VSCode
      • Raccourcis clavier IntelliJ / WebStorm
    • Floobits
    • Angular CLI
    • StackBlitz
    • Compodoc
  • Angular
    • Bootstrap
    • Composants
      • Root Component
      • Template Interpolation
      • Property Binding
      • Class & Style Binding
      • Event Binding
      • *ngIf
      • *ngFor
      • L'approche MVC
      • Création de Composants
      • Exemple
    • Container vs. Presentational Components
    • Interaction entre Composants
      • Input
      • Output
      • Exemple
    • Change Detection
      • Les Approches Possibles
      • Fonctionnement de la Change Detection
      • Optimisation de la Change Detection
      • Immutabilité
      • Quelques Liens
    • Project Structure & Modules
      • Entry Point
      • Définition d'un Module
      • Root Module
      • Feature Module
      • Shared Module
      • Exemple
    • Dependency Injection
      • Qu'est-ce que la "Dependency Injection" ?
      • Injection d'un Service Angular
      • Services & Providers
      • Portée des Services
      • Tree-Shakable Services
      • Class vs Injection Token
      • Exemple
    • Callback Hell vs. Promise vs. Async / Await
      • Callback Hell
      • Promise
      • Async / Await
    • Observables
      • Reactive Programming
      • Promise vs Observable
      • Subscribe
      • Unsubscribe ⚠️
      • Création d'un Observable
      • Opérateurs
        • Définition d'un Opérateur
        • Lettable Operators vs Legacy Methods
        • map
        • filter
        • mergeMap & switchMap
        • shareReplay
        • buffer
        • debounceTime
        • distinctUntilChanged
        • retry
      • Quelques Liens
    • Http
      • Pourquoi HttpClient ?
      • Utilisation de HttpClient
      • Utilisation dans un Service
      • Gestion de la Subscription ⚠️
    • GraphQL
    • Formulaires
      • Template-driven Forms 🤢
      • Reactive Forms 👍
        • Avantages des "Reactive Forms"
        • La boite à outils des "Reactive Forms"
        • Validation
        • Observation des Changements
    • Directives
      • Attribute Directive
      • Structural Directive
    • Pipes
    • Routing
      • Mise en Place du Routing
      • Lazy Loading
      • Project Structure
      • Route Guards
    • Testing
      • Unit-Testing
        • Jasmine
        • Unit-Test Synchrone
        • Test-Driven Development
        • Unit-Test Asynchrone
        • TestBed
        • Unit-Test d'un Service
        • Unit-Test d'un Composant
        • Unit-Test et Spies
        • Unit-Test et HttpClient
      • End-to-End
    • Sécurité
      • Quelques Liens
    • Animation
    • Internationalisation
    • Quelques Liens
  • Cookbook
    • Authentification et Autorisation
Powered by GitBook
On this page
  • index.html
  • AppComponent
  • @Component
  • Code source
  • Démo StackBlitz

Was this helpful?

  1. Angular
  2. Composants

Root Component

Une application Angular est généralement composé d'un “root component“ qui sera l'élément le plus haut de la hiérarchie de composants Angular.

index.html

Ce composant est utilisé dans le fichier src/index.html qui est la page HTML accueillant l'application Angular.

<!doctype html>
<html lang="en">
<head>
    ....
</head>
<body>
    <wt-root></wt-root>
</body>
</html>

Il s'agit du tag HTML <wt-root> utilisant le préfixe wt choisi lors de la création de l'application.

AppComponent

Le composant est défini dans le fichier src/app/app.component.ts dont voici une version plus minimaliste :

import { Component } from '@angular/core';

@Component({
    selector: 'wt-root',
    template: `
<h1>Hello real 🌎!</div>
`
})
export class AppComponent {
}

Un composant Angular n'est rien d'autre qu'une classe...

... avec un décorateur @Component.

@Component

Ce décorateur prend un paramètre une configuration qui contient au minimum :

  • selector : le sélecteur CSS qui permettra de lier le tag HTML de l'élément et le code du composant.

  • template : le template HTML utilisé par Angular pour générer le contenu de l'élément dans le DOM.

Par bonne pratique, nous n'utiliserons pas la propriété template pour définir le template HTML mais plutôt templateUrl qui permet d'indiquer le chemin vers le fichier HTML du template associé au composant.

templateUrl: './app.component.html'

Le résultat sera identique (le fichier HTML n'est pas téléchargé en runtime mais plutôt consommé au "build") mais le code sera plus clair et la "separation of concerns" mieux respectée.

La convention de nommage pour un composant est la suivante :

  • Les fichiers sont en "kebab-case" suffixés par .component.ext. (e.g. : book-preview.component.ts & book-preview.component.html)

  • La classe est en "PascalCase" suffixée par Component. (e.g. : BookPreviewComponent)

  • Le sélecteur CSS doit être un sélecteur de tag en "kebab-case" préfixé par le suffixe du produit. (e.g. : wt-book-preview).

Le squelette par défaut ne respecte pas la dernière règle (utilisation de wt-root au lieu de wt-app).

N'hésitez pas à "refactor".

Code source

Démo StackBlitz

PreviousComposantsNextTemplate Interpolation

Last updated 5 years ago

Was this helpful?

https://github.com/wishtack/wishtack-book-shop/tree/1-bootstrap
https://stackblitz.com/github/wishtack/wishtack-book-shop/tree/1-bootstrap
Selector refacotoring