DEV Community

Cover image for Future of CSS: Popover API
Andrew Bone
Andrew Bone

Posted on

Future of CSS: Popover API

In this post we're going to be looking at not one but two new exciting things coming to CSS, the first is the Popover API. While I think it's great by itself the things we can do with it when paired with Anchor positioning are very very cool. Both of these features are, at the time of writing, are only available in non-stable browsers.

What is the Popover API?

The Popover API is a powerful tool for developers that offers a consistent and flexible way to display popover content on web pages. Whether you prefer declarative HTML attributes or JavaScript control, this API has got you covered.

On the web, it's quite common to present content on top of other content, on the top-layer if you will, to draw the user's attention to important information or actions. You might have encountered various terms for this, such as popups or dialog.

HTML Attributes

  • popover
    • auto (default) - this means the popover can be dismissed when clicking outside or pressing esc, also other popovers will close for this new popover.
    • manual - when manual a popover can only be dismissed with manually (with JS or a HTML close action).
  • popovertarget
    • [id] - this attribute can be put on a button to allow it to control a popover, the value of the attribute should be the id of the target.
  • popovertargetaction
    • toggle (default) - pressing a button with a popovertarget will perform this action on the popover. In this instance the popover will show if hidden and hide if shown.
    • hide - set popovertarget to display none.
    • show - set popovertarget to display block.
<button popovertarget="menu" popovertargetaction="toggle">Menu</button>
<nav id="menu" popover="auto">
    <li><a href="/items/1">Item 1</a></li>
    <li><a href="/items/1">Item 2</a></li>
    <li><a href="/items/1">Item 3</a></li>
Enter fullscreen mode Exit fullscreen mode

CSS Pseudo Elements and Classes

  • ::backdrop - this is a pseudo-element, it fills the entire screen behind the popover, styling this can allow you change the colour or even add blur.
  • :popover-open - this is a pseudo-class, it is applied to the popover element when it is opened, we can use this to add opening animations.
#menu {
  border: 0;
  margin-right: 0;
  box-shadow: 0 -1px 3px rgba(0, 0, 0, 0.12), 0 1px 2px rgba(0, 0, 0, 0.24);
  max-width: 100vw;
  width: 200px;
  height: 100%;

#menu ul {
  list-style: none;
  padding: 0;

#menu ul li {
  padding: 1ch;

#menu::backdrop {
  background-color: rgba(200, 200, 200, 0.5);
  backdrop-filter: blur(2px);

#menu:popover-open {
  animation: slideIn 150ms ease-in-out;

@keyframes slideIn {
  0% {
    translate: 100% 0 0;
  100% {
    translate: 0 0 0;
Enter fullscreen mode Exit fullscreen mode

JavaScript Controls and Events

I know this article is mainly about new and exciting things coming to CSS but it would be a shame to not talk about the JS too.


  • PopoverElement.hidePopover() - update the popover element and move it to its hidden state.
  • PopoverElement.showPopover() - update the popover element and move it to its shown state.
  • PopoverElement.togglePopover() - update the popover element and toggle between its hidden and shown states.


  • beforetoggle - event fired before state change visually takes place.
  • toggle - event fired after state change visually takes place.
const popover = document.querySelector('#menu[popover]');

popover.addEventListener('beforetoggle', () => {
  // I triggered first before anything visually happened.

popover.addEventListener('toggle', () => {
  // I triggered after the toggle had happened visually.
Enter fullscreen mode Exit fullscreen mode


This is a simple demo of a dialog box, I've chosen not to include any JavaScript in this example just to show off how simplistic it can truly be.

Here's a fallback gif just incase your browser doesn't support popover yet.
Popover fallback animation

What is Anchor Positioning?

Anchor Positioning is not on MDN yet so this really is some experimental stuff. I'll do my best to explain what it does and how to use it.

Currently if you want an element to render physically next another element the easiest way to do this is work out where the target element is using JavaScript than set the anchored element to position absolute and set the top, right, bottom or left attributes. This method works but 'less JavaScript is more good'™ so anchor lets you store the position of an element in a CSS variable.

#anchor {
  anchor-name: --test-anchor;

.anchored-element {
  position: absolute;
  right: anchor(--test-anchor left);
  top: anchor(--test-anchor center);
  transform: translateY(-50%);
Enter fullscreen mode Exit fullscreen mode

You'll notice this new anchor CSS function. It takes a CSS variable and a position and then returns position, you can even use the value in a calc to do more complex positions.


Here is a little demo showing creation of a tooltip again the aim was to be simplistic and just show an easy implementation.

And again, here's a fallback gif as I'm sure anchor is still is a bit of a way off.
Anchor fallback animation

How can we use these together?

The web has been around for a long time and is fully backwards compatible, which is great, but does lead to a few issues like not being able to customise the select combobox component. I'm sure many of you have had that dilemma between writing a new combobox from scratch to match a specific design or find one someone else has already made but lose some of the customisation ability.

Putting together Popover and Anchor Position I think we might be able to make a nice looking combobox that we can build to look how we like without having to worry about accessibility and positioning issues. Let's see if we can do it.

What we doing about accessibility?

There is a website made by the lovely people over at W3C that goes through all the aria patterns for various different use cases including a combobox. I'll be looking through this as well as looking at what the native select element does.

I know the aria patterns site has been up for a little while now but I can't stress how amazing and useful it is, I feel like it's a bit of a best kept secret but everyone should be using it.

The Demo

So here we are, finally, the demo. I've put together the Popover API and Anchor positioning to make a combobox that we can style to our hearts content.

I have had to use some JS in order to make sure its keyboard friendly and to make sure the text in the button updates if any of you have ideas of ways we can use less JS to do these things I'd love to hear them.

One last fallback gif, hopefully one day we can all look back on this post and see everything just working.

combobox fallback animation


And that's a wrap, the Popover API should start landing in stable browsers relatively soon but Anchor positioning might take a little while longer. That being said, it really is an exciting time to be a web dev. Lots of tasks that previously required hacky workarounds are now being addressed, freeing us to explore more creative possibilities!

Thanks so much for reading. If you'd like to connect with me outside of Dev here are my twitter and linkedin come say hi 😊.

Top comments (7)

landoc profile image
lando calrissian

Had no idea this was a thing

link2twenty profile image
Andrew Bone

There's so much new CSS right now, it's hard to keep track of everything 😅

link2twenty profile image
Andrew Bone

If there's anything you're unsure about or if you have any ideas of things I can do better please do leave a comment and let me know 🙂

adaptive-shield-matrix profile image
Adaptive Shield Matrix • Edited

trying it out myself

  • using official google chrome: Version 113.0.5672.126 (Official Build) (64-bit)
  • both demo do not work for me

global support of 0.01%

link2twenty profile image
Andrew Bone

Yes, I say in the article that they're only available in unstable browsers. This series is about things in CSS that are coming but are not here yet.

That being said the Popover API should be stable everywhere in around a year but the Anchor Positioning stuff is extremely experimental so I don't have any estimate for when it'll be stable.

link2twenty profile image
Andrew Bone

As of today the demos now work in the latest version of chrome, still a little while to go before it's everywhere though.

iamhectorsosa profile image
Hector Sosa

Kudos on this post! Very detailed! If you like creating visual content I do believe that framing your screenshots helps you bring your images to the next level.

We've built a completely free and OSS tool to build engaging screenshots faster. Check it out and let us know what you think! I'd appreciate if you give it a Star in Github if you find it helpful.