Formations — 1 037 leçons en français

Accueil › CSS & mise en page › Projeter du contenu : ng-content, slots et templates

Projeter du contenu : ng-content, slots et templates

Découper en composantsavance

Projeter plutôt que configurer. Un composant avec sept input de personnalisation est presque toujours un composant qui aurait dû projeter.

<!-- panneau.component.html -->
<section class="panneau">
  <header class="panneau__entete">
    <ng-content select="[titre]" />
    <div class="panneau__actions"><ng-content select="[actions]" /></div>
  </header>

  <div class="panneau__corps">
    <ng-content />            <!-- slot par défaut : TOUJOURS en dernier -->
  </div>
</section>
<!-- utilisation -->
<app-panneau>
  <h2 titre>Commandes</h2>
  <button actions class="btn">Exporter</button>
  <app-tableau [lignes]="lignes()" />
</app-panneau>

La règle de style qui surprend : le contenu projeté appartient toujours au parent. Le composant ne peut pas le styliser directement — il style le conteneur du slot, et expose des variables.

Et quand le contenu a besoin de données du composant, ng-content ne suffit plus : il faut un ng-template.

Les termes à connaître

ng-content

L'emplacement où le contenu écrit par le parent est inséré. Le contenu n'est pas recréé : il est déplacé, et garde le contexte du parent.

Slot nommé

<ng-content select="[actions]" /> : plusieurs emplacements distincts dans un même composant, choisis par un sélecteur CSS.

Slot par défaut

Le <ng-content /> sans select. Il doit être déclaré après les slots nommés, sinon il capte tout.

Contexte de style

Le contenu projeté garde le _ngcontent du parent : c'est le parent qui le style, pas le composant qui le reçoit.

ng-template + ngTemplateOutlet

Quand le contenu doit recevoir des données du composant (une ligne de tableau, un item de liste), le template remplace la projection simple.

Projection conditionnelle

Un ng-content dans un @if n'est instancié qu'une fois : pour un affichage réellement conditionnel, utiliser un ng-template.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.