HTMLElement: hidePopover() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("Popover API")}}
The **hidePopover()** method of the {{domxref("HTMLElement")}} interface hides a popover element (i.e., one that has a valid [popover](/en-US/docs/Web/HTML/Reference/Global_attributes/popover) attribute) by removing it from the {{glossary("top layer")}} and styling it with display: none.
When hidePopover() is called on a showing element with the [popover](/en-US/docs/Web/HTML/Reference/Global_attributes/popover) attribute, a {{domxref("HTMLElement/beforetoggle_event", "beforetoggle")}} event will be fired, followed by the popover being hidden, and then the {{domxref("HTMLElement/toggle_event", "toggle")}} event firing.
Syntax
hidePopover()Parameters
None.
Return value
None ({{jsxref("undefined")}}).
Exceptions
InvalidStateError{{domxref("DOMException")}}- : Thrown if this method is called while another popover is already in the process of being shown or hidden (e.g., within a
beforetoggleevent listener).
Examples
Hiding a popover
The following example provides functionality to hide a popover by pressing a particular key on the keyboard.
HTML
<button popovertarget="mypopover">Toggle popover's display</button>
<div id="mypopover" popover="manual">
You can press <kbd>h</kbd> on your keyboard to close the popover.
</div>JavaScript
const popover = document.getElementById("mypopover");
document.addEventListener("keydown", (event) => {
if (event.key === "h") {
popover.hidePopover();
}
});Result
{{EmbedLiveSample("Hiding a popover","100%",100)}}
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- Popover API