: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.

Die funktionale :has() CSS-Pseudoklasse repräsentiert ein Element, wenn einer der relativen Selektoren, die als Argument übergeben werden, mindestens ein Element trifft, das an dieses Element verankert ist. Diese Pseudoklasse bietet eine Möglichkeit, ein Elternelement oder ein vorheriges Geschwisterelement in Bezug auf ein Referenzelement zu selektieren, indem sie eine Liste relativer Selektoren als Argument nimmt.

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;
}

Die :has()-Pseudoklasse nimmt die Spezifität des spezifischsten Selektors in ihren Argumenten an, genauso wie :is() und :not() es tun.

Syntax

css
:has(<relative-selector-list>) {
  /* ... */
}

Wenn die :has()-Pseudoklasse in einem Browser selbst nicht unterstützt wird, schlägt der gesamte Selektorblock fehl, es sei denn, :has() befindet sich in einer fehlertoleranten Selektorliste, wie in :is() und :where().

Die :has()-Pseudoklasse kann nicht in einer anderen :has() verschachtelt werden.

Pseudoelemente sind auch keine gültigen Selektoren innerhalb von :has() und Pseudoelemente sind keine gültigen Anker für :has(). Dies liegt daran, dass viele Pseudoelemente bedingt auf der Grundlage der Stilisierung ihrer Vorfahren existieren und deren Abfrage durch :has() zu zyklischen Abfragen führen kann.

Beispiele

Mit dem Geschwisterkombinator

Die :has()-Stildeklaration im folgenden Beispiel passt den Abstand nach <h1>-Überschriften an, wenn sie unmittelbar von einer <h2>-Überschrift gefolgt werden.

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;
}

Ergebnis

Dieses Beispiel zeigt zwei ähnliche Texte nebeneinander zum Vergleich – links eine H1-Überschrift gefolgt von einem Absatz und rechts eine H1-Überschrift gefolgt von einer H2-Überschrift und dann einem Absatz. In dem Beispiel rechts hilft :has(), das H1-Element auszuwählen, das unmittelbar von einem H2-Element gefolgt wird (angezeigt durch den nächsten Geschwisterkombinator +) und die CSS-Regel reduziert den Abstand nach einem solchen H1-Element. Ohne die :has()-Pseudoklasse können Sie keine CSS-Selektoren verwenden, um ein vorhergehendes Geschwisterelement eines anderen Typs oder ein Elternelement auszuwählen.

Mit der :is()-Pseudoklasse

Dieses Beispiel baut auf dem vorherigen Beispiel auf, um zu zeigen, wie man mit :has() mehrere Elemente auswählt.

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;
}

Ergebnis

Hier wird die erste :is() Pseudoklasse verwendet, um eines der Überschriftselemente in der Liste auszuwählen. Die zweite :is()-Pseudoklasse wird verwendet, um eine Liste von Geschwisterselektoren als Argument an :has() zu übergeben. Die :has()-Pseudoklasse hilft, jedes H1, H2 oder H3-Element auszuwählen, das unmittelbar gefolgt wird von (angezeigt durch +) einem H2, H3 oder H4-Element und die CSS-Regel reduziert den Abstand nach solchen H1, H2, oder H3-Elementen.

Dieser Selektor hätte auch wie folgt geschrieben werden können:

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

Logische Operationen

Der :has()-relationale Selektor kann verwendet werden, um zu überprüfen, ob eines von mehreren Merkmalen wahr ist oder ob alle Merkmale wahr sind.

Indem Sie kommagetrennte Werte innerhalb des :has()-relationalen Selektors verwenden, prüfen Sie, ob eines der Parameter existiert. x:has(a, b) wird x stylen, wenn der Nachkomme a ODER b existiert.

Indem Sie mehrere :has()-relationale Selektoren aneinander ketten, prüfen Sie, ob alle Parameter existieren. x:has(a):has(b) wird x stylen, wenn der Nachkomme a UND b existieren.

css
body:has(video, audio) {
  /* styles to apply if the content contains audio OR video */
}
body:has(video):has(audio) {
  /* styles to apply if the content contains both audio AND video */
}

Analogie zwischen :has() und regulären Ausdrücken

Interessanterweise können wir einige CSS-:has()-Konstrukte mit der Lookahead Assertion in regulären Ausdrücken in Verbindung bringen, da beide erlauben, Elemente (oder Zeichenketten in regulären Ausdrücken) basierend auf einer Bedingung auszuwählen, ohne tatsächlich das Bedingungselement (oder die Zeichenkette) selbst auszuwählen.

Positiver Lookahead (?=pattern)

Im regulären Ausdruck abc(?=xyz) wird die Zeichenkette abc nur dann gefunden, wenn sie unmittelbar von der Zeichenkette xyz gefolgt wird. Da es sich um eine Lookahead-Operation handelt, wird das xyz nicht in das Match einbezogen.

Das analoge Konstrukt in CSS wäre .abc:has(+ .xyz): es selektiert das Element .abc nur, wenn es ein nächstes Geschwister .xyz gibt. Der Teil :has(+ .xyz) fungiert als Lookahead-Operation, da das Element .abc ausgewählt wird und nicht das Element .xyz.

Negativer Lookahead (?!pattern)

Ähnlich dazu, im Fall des negativen Lookaheads, wird im regulären Ausdruck abc(?!xyz) die Zeichenkette abc nur dann gefunden, wenn sie nicht von xyz gefolgt wird. Das analoge CSS-Konstrukt .abc:has(+ :not(.xyz)) wählt das Element .abc nicht aus, wenn das nächste Element .xyz ist.

Spezifikationen

Specification
Selectors Level 4
# relational

Browser-Kompatibilität

Siehe auch