HTMLElement: popover プロパティ
Baseline 2025>
最近利用可能
*
2025年1月以降、この機能は最新のバージョンの端末およびブラウザーで動作します。古い端末やブラウザーでは動作しないことがあります。
* この機能の一部は、対応レベルにばらつきがある場合があります。
popover は HTMLElement インターフェイスのプロパティで、要素のポップオーバー状態("auto"、"hint"、"manual" のいずれか)を JavaScript から取得したり設定したりします。機能検出に使用することもできます。
これは、HTML の popover グローバル属性の値を反映します。
値
列挙値です。取りうる値は次の通りです。
"auto"-
autoポップオーバーは「簡単に解除」できます。つまり、ポップオーバーの外をクリックするか、Esc キーを押すことで非表示にできます。通常、同時に表示できる
autoポップオーバーは 1 つだけです。すでに表示されているポップオーバーがあるときに 2 つ目を表示すると、1 つ目が非表示になります。このルールの例外は、入れ子のautoポップオーバーがあるときです。詳しくは入れ子のポップオーバーを参照してください。 "hint"-
hintポップオーバーは、表示されてもautoポップオーバーを閉じませんが、ほかのhintポップオーバーは閉じます。 また、簡単に解除でき、閉じる要求にも応答します。通常、これらは
mouseover/mouseoutやfocus/blurなどのクリック以外の JavaScript イベントに応じて表示・非表示になります。 ボタンをクリックしてhintポップオーバーを開くと、表示中のautoポップオーバーは簡単に解除されます。 "manual"-
manualポップオーバーは簡単に解除できず、自動的に閉じることもありません。宣言的な表示/非表示/トグルボタンまたは JavaScript を使って、明示的に表示・非表示にする必要があります。複数の独立したmanualポップオーバーを同時に表示できます。
例
>機能検出
popover 属性を使用して、ポップオーバー API の機能を検出することができます。
function supportsPopover() {
return Object.hasOwn(HTMLElement.prototype, "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.");
}
仕様書
| 仕様書 |
|---|
| HTML> # dom-popover> |
ブラウザーの互換性
関連情報
- HTML の
popoverグローバル属性 - ポップオーバー API