:host()

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流浏览器均已支持。

:host() CSS 伪类函数用于选择包含该 CSS 的 Shadow DOM 的 Shadow Host(这样你就可以从自定义元素的 Shadow DOM 内部选择该自定义元素)——但前提是作为函数参数给出的选择器匹配 Shadow Host。当在 Shadow DOM 外部使用时,:host() 没有效果。

最明显的用法是仅将类名添加到某些自定义元素实例上,然后将相关的类选择器作为函数参数包含在内。你不能将其与后代选择器表达式一起使用,来仅选择位于特定祖先元素内的自定义元素实例。那是 :host-context() 的职责。

注意:虽然其他函数式伪类(例如 :is():not())接受选择器列表作为其参数,但 :host() 接受单个复合选择器作为其参数。此外,虽然 :is():not() 仅考虑其参数的特殊性,但 :host() 的特殊性既是伪类的特殊性,又是其参数的特殊性。

试一试

/* Following CSS is being applied inside the shadow DOM. */

:host(h1) {
  color: red;
}

:host(#shadow-dom-host) {
  border: 2px dashed blue;
}
<!-- elements outside shadow dom -->
<div id="container">
  <h1 id="shadow-dom-host"></h1>
</div>
const shadowDom = init();

// add a <span> element in the shadow DOM
const span = document.createElement("span");
span.textContent = "Inside shadow DOM";
shadowDom.appendChild(span);

// attach shadow DOM to the #shadow-dom-host element
function init() {
  const host = document.getElementById("shadow-dom-host");
  const shadowDom = host.attachShadow({ mode: "open" });

  const cssTab = document.querySelector("#css-output");
  const shadowStyle = document.createElement("style");
  shadowStyle.textContent = cssTab.textContent;
  shadowDom.appendChild(shadowStyle);

  cssTab.addEventListener("change", () => {
    shadowStyle.textContent = cssTab.textContent;
  });
  return shadowDom;
}
css
/* Selects a shadow root host, only if it is
   matched by the selector argument */
:host(.special-custom-element) {
  font-weight: bold;
}

语法

css
:host(<compound-selector>) {
  /* ... */
}

示例

选择性地为 Shadow Host 设置样式

以下代码片段取自我们的 host-selectors 示例也可在线查看)。

在此示例中,我们有一个自定义元素 — <context-span> — 你可以将其包装在文本周围。

html
<h1>
  Host selectors <a href="#"><context-span>example</context-span></a>
</h1>

在元素的构造函数中,我们创建 stylespan 元素,用自定义元素的内容填充 span,并用一些 CSS 规则填充 style 元素

js
const style = document.createElement("style");
const 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: rgb(0 0 0 / 10%); padding: 2px 5px; }";

:host(.footer) { color : red; } 规则会样式化文档中所有具有 footer 类(在此实例中为 Shadow Host)的 <context-span> 元素实例 — 我们已将其用于为 <footer> 内部的元素实例设置特殊颜色。

规范

规范
CSS 作用域模块级别 1
# 宿主选择器

浏览器兼容性

另见