Formations — 1 037 leçons en français

Accueil › CSS & mise en page › :host, :host-context et les alternatives à ::ng-deep

:host, :host-context et les alternatives à ::ng-deep

Angular et les stylesavance

:host vise le composant lui-même — c'est-à-dire la balise <app-carte>. C'est là que vont son display, son padding, sa place dans une grille :

:host {
  display: block;        /* inline par défaut : presque toujours à corriger */
  padding: var(--espace-4);
  border-radius: var(--rayon-l);
}

Ses variantes évitent d'avoir à percer quoi que ce soit :

:host(.compact)              { padding: var(--espace-2); }   /* classe sur l'hôte */
:host([disabled])            { opacity: .5; }                /* attribut sur l'hôte */
:host-context(.theme-sombre) { background: #111827; }        /* contexte d'un ancêtre */

Et ::ng-deep force un sélecteur à traverser l'encapsulation. Il est déprécié, et surtout : sans :host devant, il devient global.

::ng-deep .mat-mdc-form-field { }        /* ✗ toute l'application */
:host ::ng-deep .mat-mdc-form-field { }  /* ~ acceptable en dernier recours */

L'alternative : exposer des variables CSS. Le composant lit, le parent écrit.

/* carte.component.scss */  :host { background: var(--carte-fond, #fff); }
/* parent.component.scss */ app-carte { --carte-fond: #f3f4f6; }

Les termes à connaître

:host

Le sélecteur qui vise l'élément du composant lui-même (<app-carte>). C'est le seul endroit où déclarer son display, son padding ou sa participation à une grille.

:host(.classe)

Vise l'hôte uniquement s'il porte cette classe. Permet des variantes pilotées depuis le parent, sans percer l'encapsulation.

:host-context(.theme-sombre)

Vise l'hôte si l'un de ses ancêtres correspond au sélecteur. Sert à réagir à un contexte posé plus haut — thème, densité, mode d'impression.

::ng-deep

Force un sélecteur à traverser l'encapsulation. Officiellement déprécié, sans remplacement prévu, et dangereux s'il n'est pas confiné à :host.

Variables CSS exposées

L'alternative moderne : le composant lit var(--mon-accent, valeur-par-défaut), le parent redéfinit la variable. Contrat explicite, sans fuite.

::part

Le mécanisme standard du Shadow DOM pour exposer des éléments internes au style externe. Inutilisable avec l'encapsulation émulée d'Angular.

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.