The CSS :has() selector is way more than a “Parent Selector”

~

# CSS :has()?

As per selectors-4 specification:

The :has() CSS pseudo-class represents an element if any of the selectors passed as parameters match at least one element.

This selector is dubbed “the parent selector”, as the default cases indeed allow you to select a parent element that has certain children.

/* Matches <a> elements that contain an <img> child */
a:has(img) { … }

/* Matches <a> elements that directly contain an <img> child */
a:has(> img) { … }

/* Matches <section> elements that don’t contain any heading elements: */
section:not(:has(h1, h2, h3, h4, h5, h6))

Cool!

~

# More than a parent selector

The :has() selector is way more than that just a parent selector though. As Adrian Bece shared in his post on Smashing Magazine:

/*  Matches <figure> elements that have a <figcaption> as a child element */
figure:has(figcaption) { … }

/* Matches <img> elements that is a child of a <figure> that contains a <figcaption> child element */
figure:has(figcaption) img { … }

Here’s a pen:

See the Pen The CSS :has() selector is way more than a “Parent Selector” by Bramus (@bramus)on CodePen.

In browsers that support :has() you should see a red dashed border around the top image.

Here’s another example, from the spec:

/* Matches <h1> elements only if they have a <p> element directly following them */
h1:has(+ p) { … }

Yes, that one also works because the :has() relational pseudo-class selector accepts a <forgiving-relative-selector-list> as an argument. That’s is a list of <relative-selector>s which can contain any of the combinators we already know: +, ~, >, …

~

# Other peculiar traits

Just like CSS :is(), CSS :has() has these specific traits:

1. The selector list of :has() is forgiving
2. The specificity of :has() is that of its most specific argument

Hit the post on CSS :is() for more info on this.

~

# Browser Support

Here is an up-to-date list of browser support for the CSS :has() selector:

Chromium (Blink)

✅ Available in Chromium 105 and up.

Experimental support first appeared in Chromium 103.

Firefox (Gecko)

👨‍🔬 Experimental support available in Firefox 103 and up by enabling the layout.css.has-selector.enabled flag through about:config. Implementation is not finalised and has known bugs.

Safari (WebKit)

✅ Available in Safari 15.4 and up.

Experimental support first appeared in Safari Technology Preview 137.

The pen embedded below will indicate if the browser you are currently using supports CSS :has() or not:

See the Pen
CSS :has Selector Support test by Bramus (@bramus)
on CodePen.

To stay up-to-date regarding browser support, you can follow these tracking issues:

• WebKit/Safari: Issue #227702 — RESOLVED FIXED
• Blink/Chromium: Issue #669058 — Fixed (Closed)
• Gecko/Firefox: Issue #418039 — NEW

~

# Spread the word

To help spread the contents of this post, feel free to retweet its announcement tweet:

The CSS `:has()` selector is way more than a “Parent Selector”.

🔗 https://t.co/rzAiRG8DQk

🏷 #css #selectors pic.twitter.com/cwpv7esjwb

— Bram.us (@bramusblog) December 21, 2021

~