Baseline 2024 *
Newly available
The showPopover()
method of the HTMLElement
interface shows a popover element (i.e., one that has a valid popover
attribute) by adding it to the top layer.
When showPopover()
is called on an element with the popover
attribute that is currently hidden, a beforetoggle
event will be fired, followed by the popover showing, and then the toggle
event firing. If the element is already showing, an error will be thrown.
showPopover()
showPopover(options)
Parameters
options
Optional
An object that can contain the following properties:
source
Optional
An HTMLElement
reference; programmatically defines the invoker of the popover associated with the show action, that is, its control element. Establishing a relationship between a popover and its invoker using the source
option has two useful effects:
None (undefined
).
InvalidStateError
DOMException
Thrown if the popover is already showing.
The following example provides functionality to show a popover by pressing a particular key on the keyboard.
First, some HTML:
<div id="mypopover" popover>
<h2>Help!</h2>
<p>You can use the following commands to control the app</p>
<ul>
<li>Press <ins>C</ins> to order cheese</li>
<li>Press <ins>T</ins> to order tofu</li>
<li>Press <ins>B</ins> to order bacon</li>
<hr />
<li>Say "Service" to summon the robot waiter to take your order</li>
<li>Say "Escape" to engage the ejector seat</li>
</ul>
</div>
And now the JavaScript to wire up the functionality:
const popover = document.getElementById("mypopover");
document.addEventListener("keydown", (event) => {
if (event.key === "h") {
popover.showPopover();
}
});
Specifications Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4