:host-context()

:host-context() CSS 伪类 函数选择包含其内部使用的 CSS 的 Shadow DOM 的阴影宿主(因此您可以从其 Shadow DOM 内部选择自定义元素)——但前提是作为函数参数给出的选择器与阴影宿主在其 DOM 层次结构中所处位置的祖先元素匹配。

换句话说,这允许自定义元素或该自定义元素的 Shadow DOM 中的任何内容根据其在外部 DOM 中的位置或应用于祖先元素的类/属性来应用不同的样式。

这的一种典型用法是使用后代选择器表达式——例如 h1——仅选择位于 <h1> 内的自定义元素实例。另一种典型用法是允许内部元素对任何祖先元素上的类或属性做出反应——例如,当 .dark-theme 类应用于 <body> 时,应用不同的文本颜色。

注意:在 Shadow DOM 外部使用时,此功能无效。

试一试

css
/* Selects a shadow root host, only if it is
   a descendant of the selector argument given */
:host-context(h1) {
  font-weight: bold;
}

/* Changes paragraph text color from black to white when
   a .dark-theme class is applied to the document body */
p {
  color: #000;
}

:host-context(body.dark-theme) p {
  color: #fff;
}

语法

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

示例

选择性地设置阴影宿主的样式

以下代码片段取自我们的 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(.footer) { color : red; }" +
  ":host { background: rgb(0 0 0 / 10%); padding: 2px 5px; }";

:host-context(h1) { font-style: italic; }:host-context(h1):after { content: " - no links in headers!" } 规则设置了 <h1> 内的 <context-span> 元素(在此实例中为阴影宿主)的样式。我们使用它来明确表示在我们的设计中,自定义元素不应出现在 <h1> 内。

规范

规范
CSS 范围模块级别 1
# host-selector

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅