HTMLElement:hidePopover() 方法

Baseline 2024
新推出

自 ⁨2024 年 4 月⁩ 起,此功能可在最新的裝置和瀏覽器版本中執行。此功能可能不適用於較舊的裝置或瀏覽器。

hidePopover() 方法是 HTMLElement 介面的一部分,它透過將其從 頂層 移除並應用 display: none 樣式來隱藏一個 彈出式內容(即具有有效 popover 屬性的元素)。

當在具有 popover 屬性的顯示中的元素上呼叫 hidePopover() 時,會先觸發 beforetoggle 事件,然後彈出式內容被隱藏,最後觸發 toggle 事件。如果元素已經隱藏,則會丟擲錯誤。

語法

js
hidePopover()

引數

無。

返回值

無(undefined)。

異常

InvalidStateError DOMException

如果彈出式內容已隱藏,則會丟擲此錯誤。

示例

隱藏彈出式內容

下面的示例提供了透過按特定鍵盤按鍵來隱藏彈出式內容的功能。

HTML

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

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

document.addEventListener("keydown", (event) => {
  if (event.key === "h") {
    popover.hidePopover();
  }
});

結果

規範

規範
HTML
# dom-hidepopover

瀏覽器相容性

另見