Formations — 1 037 leçons en français

Accueil › Angular › Projeter du contenu

Projeter du contenu

Composer des composantsdebutant

La projection de contenu permet à un composant de laisser son parent fournir tout ou partie de son contenu, plutôt que de tout coder en dur dans son propre template.

Le cas le plus simple : <ng-content> insère ce que le parent a placé entre les balises du composant.

@Component({
  selector: 'app-carte',
  template: `<div class="carte"><ng-content /></div>`,
})
export class Carte {}
<app-carte><p>Contenu du parent</p></app-carte>

Avec l'attribut select, plusieurs emplacements distincts sont possibles (titre, corps, pied de page), chacun avec un contenu par défaut optionnel écrit entre les balises <ng-content>...</ng-content>.

Quand le contenu doit être réutilisé plusieurs fois avec des données différentes (une ligne de tableau par élément d'une liste), <ng-content> ne suffit plus : il faut un ng-template, référencé et rendu via ngTemplateOutlet, avec un contexte de données passé via ngTemplateOutletContext.

<ng-container> regroupe des éléments ou porte une directive sans ajouter de nœud DOM. contentChild() permet à la classe du composant d'accéder programmatiquement à un élément projeté.

Les termes à connaître

<ng-content>

Balise qui marque, dans le template d'un composant, l'endroit où insérer le contenu placé par le parent entre les balises ouvrante et fermante du composant. C'est la projection de contenu (content projection), l'équivalent Angular des <slot> des composants web.

select

Attribut de <ng-content> qui restreint la projection à certains éléments du contenu fourni, via un sélecteur CSS (select="[titre]", select=".pied", select="app-icone"). Permet plusieurs emplacements de projection dans un même composant.

ng-template

Balise qui déclare un fragment de template sans le rendre immédiatement. Combinée à ngTemplateOutlet, elle permet au parent de fournir un morceau de template personnalisable, pas seulement du contenu figé.

ngTemplateOutlet

Directive qui insère le contenu d'un TemplateRef (généralement obtenu via ng-template et une référence locale) à un endroit donné. ngTemplateOutletContext fournit des données à ce template, accessibles avec let-xxx.

ng-container

Élément qui regroupe plusieurs éléments ou applique une directive sans ajouter de nœud au DOM. Utile pour poser select sur un groupe d'éléments projetés, ou pour appliquer @if/ngTemplateOutlet sans <div> superflu.

contentChild()

Fonction de requête (signal) qui donne accès, depuis la classe du composant, à un élément ou composant projeté via <ng-content>. Équivalent signal du décorateur @ContentChild.

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.