--- title: ':host()' slug: 'Web/CSS/:host()' translation_of: 'Web/CSS/:host()' ---
CSS функция-псевдокласс :host()
выбирает shadow хоста (носителя) shadow DOM-a, который содержит CSS, используемый внутри (так что вы можете выбрать пользовательский элемент изнутри его shadow DOM) — но только если селектор, переданный как параметр функции, соответствует shadow хосту.
Самый очевидный способ использовать его — поставить некоторый класс только на определённые экземпляры пользовательских элементов, а затем передать соответствующий классовый селектор как аргумент функции. Вы не можете использовать псевдокласс c селектором наследника, чтобы выбрать только экземпляры пользовательского элемента, которые находятся внутри определённого предка. Это работа {{CSSxRef(":host-context()")}}.
Заметка: Псевдокласс не имеет эффекта вне shadow DOM.
/* Выбирает хоста shadow root, только если он соответствует аргументу селектора */ :host(.special-custom-element) { font-weight: bold; }
Следующие ниже фрагменты взяты из нашего примера host-selectors (также смотрите вживую).
В этом примере у нас есть простой пользовательский элемент — <context-span>
— который мы оборачиваем вокруг текста:
<h1>Host selectors <a href="#"><context-span>example</context-span></a></h1>
Внутри конструктора элемента мы создаём элементы style
и span
, заполняем span
контентом пользовательского элемента и заполняем элемент style
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; }';
Правило :host(.footer) { color : red; }
стилизует все экземпляры элемента <context-span>
(shadow хост в данном случае) в документе, которые имеют класс footer
— мы использовали его, чтобы дать экземплярам элемента внутри {{htmlelement("footer")}} особый цвет.
Спецификация | Статус | Комментарий |
---|---|---|
{{SpecName('CSS Scope', '#host-selector', ':host()')}} | {{Spec2('CSS Scope')}} | Initial definition. |
{{Compat("css.selectors.hostfunction")}}