:has()

Baseline 2023

Newly available

Since December 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

CSS 函数式伪类 :has() 表示一个元素,如果作为参数传递的任何相对选择器在锚定到该元素时,至少匹配一个元素。这个伪类通过把可容错相对选择器列表作为参数,提供了一种针对引用元素选择父元素或者先前的兄弟元素的方法。

css
/* Selects an h1 heading with a
paragraph element that immediately follows
the h1 and applies the style to h1 */
h1:has(+ p) {
  margin-bottom: 0;
}

:has() 伪类的优先级计算方法与 :is():not() 相同:以其参数中具体的选择器进行计算。

语法

:has( <forgiving-relative-selector-list> )

相对选择器列表参数是可容错的。通常在 CSS 中,选择器列表中的某个选择器无效时,那么整个列表则被视为无效。当 :has() 选择器列表中的一个选择器无法解析时,不正确或不受支持的选择器将被忽略,而其他的则将被正常使用。

注意,如果一个浏览器中不支持 :has() 伪类本身,则整个选择器块将失效(除非 :has() 本身位于一个可容错选择器列表中,比如在 :is():where() 中)。

:has() 伪类不能被嵌套在另一个 :has() 内。另外,伪元素不是 :has() 内的有效选择器。这是因为许多伪元素基于其祖先的样式有条件地存在,如果允许通过 :has() 查询这些伪元素可能导致循环查询。虽然 :has() 和伪元素在 :has() 中是无效的选择器,但由于选择器列表是可容错的,它们将只是被忽略。选择器将不会失效。

示例

与兄弟组合器一起使用

以下示例中的 :has() 样式声明会调整 H1 标题后面的间距,如果它们后面紧跟着 H2 标题。

HTML

html
<section>
  <article>
    <h1>Morning Times</h1>
    <p>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod
      tempor incididunt ut labore et dolore magna aliqua.
    </p>
  </article>
  <article>
    <h1>Morning Times</h1>
    <h2>Delivering you news every morning</h2>
    <p>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod
      tempor incididunt ut labore et dolore magna aliqua.
    </p>
  </article>
</section>

CSS

css
h1,
h2 {
  margin: 0 0 1rem 0;
}

h1:has(+ h2) {
  margin: 0 0 0.25rem 0;
}

结果

该示例并排显示了两个相似的文本,以进行比较:左侧的带有 H1 标题,并紧跟一个段落,而右侧的带有 H1 标题,并紧跟一个 H2 标题和一个段落。该示例的右侧,:has() 可以帮助选择 H1 元素后紧跟的 H2 元素(由兄弟选择器 + 指示),并通过 CSS 规则来减少此类 H1 元素后的间距。若没有 :has() 伪类,你就无法使用 CSS 选择器来选择具有不同类型的前一个兄弟元素或父元素。

与 :is() 伪类一起使用

这个示例建立在前一个示例之上,展示了如何用 :has() 选择多个元素。

HTML

html
<section>
  <article>
    <h1>Morning Times</h1>
    <h2>Delivering you news every morning</h2>
    <p>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod
      tempor incididunt ut labore et dolore magna aliqua.
    </p>
  </article>
  <article>
    <h1>Morning Times</h1>
    <h2>Delivering you news every morning</h2>
    <h3>8:00 am</h3>
    <p>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod
      tempor incididunt ut labore et dolore magna aliqua.
    </p>
  </article>
</section>

CSS

css
h1,
h2,
h3 {
  margin: 0 0 1rem 0;
}

:is(h1, h2, h3):has(+ :is(h2, h3, h4)) {
  margin: 0 0 0.25rem 0;
}

结果

这里,第一个 :is() 伪类用于选择列表中的任何标题元素。第二个 :is() 伪类用于将相邻的兄弟选择器的列表作为参数传递给 :has():has() 伪类用于选择任何一个紧跟 H2H3H4H1H2H3 元素(使用 + 指示),并使用 CSS 规则来减少此类 H1H2H3 元素后的间距。

这个选择器也可以写作:

css
:is(h1, h2, h3):has(+ h2, + h3, + h4) {
  margin: 0 0 0.25rem 0;
}

规范

Specification
Selectors Level 4
# relational

浏览器兼容性

BCD tables only load in the browser

参见