Content · Web Development · HTML

HTML Popover API: popover and popovertarget

Popover API: popover and popovertarget: The result depends on browser support and, in examples with script elements, on JavaScript being allowed. Includes a practical HTML example and an explanation.

1 views Published Oct 19, 2026 Updated Oct 19, 2026 Admin

Small interactions can make a webpage easier to use: opening a tip, changing a setting, or reusing an interface component.

What You Need to Know


The Popover API can show temporary content linked to a button. Using popover and popovertarget lets the browser handle the basic opening and closing action without custom click handlers.

In this example: create a help popover trigger.

Try the Example


Take a look at the example. We’ll explain the important lines right below it.

<button popovertarget="help-popover" type="button">Show help</button>
<div id="help-popover" popover="auto">
    <p>You can dismiss this note by clicking elsewhere.</p>
</div>

Let’s Read the Code


  • popover: Popover lets supported browsers manage showing and hiding a small overlay.
  • <button>: The button offers an action; its type or command determines what happens.
  • popovertarget: Popovertarget connects a trigger button to a popover by ID.
  • type: Type changes what sort of control or resource the browser uses.

Read the named elements and attributes together. They explain how the browser connects this feature to the rest of the page.

What Happens in the Browser?


When this example includes JavaScript, it supplies behavior that ordinary HTML does not automatically provide. Always think about a fallback.

Start with native behavior. Details, dialog, and popover each solve a different interface problem. Choose the simplest control that actually matches what a visitor wants to do, then test focus and dismissal as well as appearance.

Your Turn


Run this on a local development server if it loads modules or resources. Change the visible text or trigger and check what still works with scripts disabled.

Common Beginner Mistakes


  • Assuming new HTML syntax works in every browser without testing.
  • HTML supplies structure; JavaScript is necessary for the scripted behavior in this example. Check keyboard access and focus movement too.

Key Takeaways


  • The Popover API can show temporary content linked to a button.
  • popover: Popover lets supported browsers manage showing and hiding a small overlay.
  • Test the behavior you expect rather than trusting how the snippet looks in your editor.
Share this resourceSend this page to someone who may find it useful.