HTMLInputElement: popoverTargetElement property

Baseline 2025
Newly available

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

The popoverTargetElement property of the HTMLInputElement interface gets and sets the popover element to control via an <input> element of type="button".

It is the JavaScript equivalent of the popovertarget HTML attribute.

Value

A reference to a popover element in the DOM.

Examples

js
function supportsPopover() {
  return HTMLElement.prototype.hasOwnProperty("popover");
}

const popover = document.getElementById("mypopover");
const toggleBtn = document.getElementById("toggleBtn");

const popoverSupported = supportsPopover();

if (popoverSupported) {
  popover.popover = "auto";
  toggleBtn.popoverTargetElement = popover;
  toggleBtn.popoverTargetAction = "toggle";
} else {
  console.log("Popover API not supported.");
}

Toggle popover action with an auto popover

This example shows the basic use of the popover API, setting a <div> element as a popover, and then setting it as the popoverTargetElement of an <input> of type="button". The popover attribute is set to "auto", so the popover can be closed ("light-dismissed") by clicking outside the popover area.

First we define an <input> that we will use to display and hide the popover, and a <div> that will be the popover. In this case we don't set the popovertargetaction HTML attribute on the <input> or the popover attribute on the <div>, as we will be doing so programmatically.

html
<input id="toggleBtn" type="button" value="Toggle popover" />
<div id="mypopover">This is popover content!</div>

The JavaScript code first gets a handle to the <div> and <input> elements. It then defines a function to check for popover support.

js
const popover = document.getElementById("mypopover");
const toggleBtn = document.getElementById("toggleBtn");

// Check for popover API support.
function supportsPopover() {
  return HTMLElement.prototype.hasOwnProperty("popover");
}

If the popover API is supported the code sets the <div> element's popover attribute to "auto" and makes it the popover target of the toggle button. We then set the popoverTargetAction of the button to "toggle". If the popover API is not supported we change the text content of the <div> element to state this, and hide the input element.

js
if (supportsPopover()) {
  // Set the <div> element to be an auto popover
  popover.popover = "auto";

  // Set the button popover target to be the popover
  toggleBtn.popoverTargetElement = popover;

  // Set that the button toggles popover visibility
  toggleBtn.popoverTargetAction = "toggle";
} else {
  popover.textContent = "Popover API not supported.";
  toggleBtn.hidden = true;
}

Note: A popover element is hidden by default, but if the API is not supported your element will display "as usual".

You can try out the example below. Show and hide the popover by toggling the button. The "auto" popover can also be light dismissed by selecting outside the bounds of the popover text.

Specifications

Specification
HTML
# dom-popovertargetelement

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
popoverTargetElement
Implicit anchor reference via popoverTargetElement
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.

See also