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 viang-templateet une référence locale) à un endroit donné.ngTemplateOutletContextfournit des données à ce template, accessibles aveclet-xxx.- ng-container
Élément qui regroupe plusieurs éléments ou applique une directive sans ajouter de nœud au DOM. Utile pour poser
selectsur un groupe d'éléments projetés, ou pour appliquer@if/ngTemplateOutletsans<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.
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.