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 />sansselect. Il doit être déclaré après les slots nommés, sinon il capte tout.- Contexte de style
Le contenu projeté garde le
_ngcontentdu 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-contentdans un@ifn'est instancié qu'une fois : pour un affichage réellement conditionnel, utiliser unng-template.
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.