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 sondisplay, sonpaddingou 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.
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.