Accueil › Angular › Accéder aux éléments : viewChild et contentChild
Accéder aux éléments : viewChild et contentChild
Les signauxdebutant
viewChild() récupère une référence vers un élément ou un composant du propre template du composant, sous forme de signal. contentChild() fait la même chose pour un élément projeté par le composant parent via <ng-content> (voir la leçon sur la projection de contenu).
import { Component, ElementRef, viewChild } from '@angular/core';
@Component({
selector: 'app-barre-recherche',
template: `<input #champRecherche type="search" />`,
})
export class BarreRecherche {
// cible la référence de template #champRecherche
champRecherche = viewChild<ElementRef<HTMLInputElement>>('champRecherche');
focaliser() {
this.champRecherche()?.nativeElement.focus();
}
}
champRecherche est un Signal<ElementRef<HTMLInputElement> | undefined> : il vaut undefined tant que la vue n'est pas initialisée, puis se met à jour automatiquement. Quand on est sûr que l'élément existe toujours (pas dans un @if), viewChild.required(...) évite d'avoir à gérer le cas undefined :
champRecherche = viewChild.required<ElementRef<HTMLInputElement>>('champRecherche');
Les variantes plurielles viewChildren() et contentChildren() renvoient un signal contenant tous les éléments correspondants (Signal<ReadonlyArray<T>>).
Pour du code qui a besoin d'un rendu garanti (mesurer une taille, initialiser une librairie DOM tierce), afterNextRender() est l'endroit recommandé — jamais le constructeur, où le template n'existe pas encore.
Les termes à connaître
- viewChild()
Déclare une requête sur un élément ou composant du template du composant lui-même (sa « vue »). Renvoie un signal,
Signal<T | undefined>, dont la valeur est disponible une fois la vue initialisée.- viewChild.required()
Variante de
viewChild()pour un élément dont on garantit la présence : le signal a le typeSignal<T>(sansundefined). Si l'élément est absent au moment de la lecture, une erreur est levée.- viewChildren() / contentChildren()
Variantes plurielles qui renvoient un
Signal<ReadonlyArray<T>>avec tous les éléments correspondants, au lieu d'un seul.- contentChild()
Déclare une requête sur un élément projeté dans le composant via
<ng-content>(donc défini par le composant parent), plutôt que sur le propre template du composant.- Référence de template (#nom)
Nom local posé dans un template (
<input #champRecherche>) qui identifie un élément DOM ou un composant, utilisable comme cible d'une requêteviewChild('champRecherche')ou passé directement à un autre binding du template.- ElementRef
Enveloppe Angular autour d'un nœud DOM natif, avec une propriété
.nativeElement.viewChild()posé sur une référence de template d'un élément HTML renvoie unElementRef<HTMLElement>(ou le type précis si spécifié).- afterNextRender
Fonction (stable) qui exécute un callback une seule fois, juste après le prochain rendu. C'est l'endroit recommandé pour du code qui doit toucher au DOM une fois que la vue est garantie d'être rendue (ex. mesurer une taille, initialiser une librairie tierce).
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.