La fonction de pseudo-classe :host()
permet de sélectionner l'hôte du shadow DOM contenant le CSS à utiliser, uniquement si le sélecteur passé en argument correspond à l'élément hôte.
Le scénario principal pour utiliser cette fonction consiste à vouloir cibler une certaine classe d'éléments personnalisés : pour cela, on passera la classe comme argument de la fonction :host()
. Cette fonction ne peut pas être utilisée avec un sélecteur de descendant, pour cela il faudra utiliser :host-context()
.
Note : Cette fonction n'a aucun effet si elle est utilisée en dehors d'un shadow DOM.
/* On cible l'hôte du shadow DOM uniquement s'il
correspond au sélecteur passé en argument */
:host(.special-custom-element) {
font-weight: bold;
}
Syntaxe
:host( <compound-selector-list> )où
<compound-selector-list> = <compound-selector>#
où
<compound-selector> = [ <type-selector>? <subclass-selector>* [ <pseudo-element-selector> <pseudo-class-selector>* ]* ]!
où
<type-selector> = <wq-name> | <ns-prefix>? '*'
<subclass-selector> = <id-selector> | <class-selector> | <attribute-selector> | <pseudo-class-selector>
<pseudo-element-selector> = ':' <pseudo-class-selector>
<pseudo-class-selector> = ':' <ident-token> | ':' <function-token> <any-value> ')'où
<wq-name> = <ns-prefix>? <ident-token>
<ns-prefix> = [ <ident-token> | '*' ]? |
<id-selector> = <hash-token>
<class-selector> = '.' <ident-token>
<attribute-selector> = '[' <wq-name> ']' | '[' <wq-name> <attr-matcher> [ <string-token> | <ident-token> ] <attr-modifier>? ']'où
<attr-matcher> = [ '~' | | | '^' | '$' | '*' ]? '='
<attr-modifier> = i | s
Exemples
Les fragments de code suivants sont extraits du dépôt d'exemple host-selectors (voir le résultat live).
Dans cet exemple, on dispose d'un élément personnalisé, <context-span>
, qui peut contenir du texte :
<h1>Host selectors <a href="#"><context-span>example</context-span></a></h1>
Dans le constructeur de l'élément, on crée un élément style
et un élément span
. Ce dernier recevra le contenu textuel de l'élément personnalisé et l'élément style
recevra quelques règles CSS :
let style = document.createElement('style');
let span = document.createElement('span');
span.textContent = this.textContent;
const shadowRoot = this.attachShadow({mode: 'open'});
shadowRoot.appendChild(style);
shadowRoot.appendChild(span);
style.textContent = 'span:hover { text-decoration: underline; }' +
':host-context(h1) { font-style: italic; }' +
':host-context(h1):after { content: " - no links in headers!" }' +
':host-context(article, aside) { color: gray; }' +
':host(.footer) { color : red; }' +
':host { background: rgba(0,0,0,0.1); padding: 2px 5px; }';
La règle :host(.footer) { color : red; }
s'applique à toutes les instances de l'élément <context-span>
(il s'agit ici de l'hôte) du document qui possèdent la classe footer
. Ici, pour ces éléments donnés, on utilise une couleur spécifique.
Spécifications
Spécification | État | Commentaires |
---|---|---|
CSS Scoping Module Level 1 La définition de ':host()' dans cette spécification. |
Version de travail | Définition initiale. |
Compatibilité des navigateurs
BCD tables only load in the browser