本文へ移動

k8o

お問い合わせ

255文字以内で入力してください

GitHub Issueからのお問い合わせもお待ちしております。

Blog

公開: 2025年3月17日(月)更新: 2026年11月9日(月)約7分で読めます

Popover APIでツールチップやドロップダウンをJSなしで作る

Popover APIは、popover属性とpopovertarget属性だけで、ツールチップやドロップダウンメニューの開閉をJavaScriptなしで書けるAPIです。外側のクリックやESCで閉じる動きと、CSSでの装飾を説明します。

Newly availablePopover2025年〜
  • Chrome116
  • Edge116
  • Firefox125
  • Safari17

はじめに

Popover APIは、popover属性を付けた要素を、popovertarget属性を付けたボタンで開閉するHTMLの仕組みです。開いた要素はほかの要素より手前に出て、外側のクリックやESCキーで閉じます。2025年にBaselineに入りました。

ページの流れの中で中身を開閉するときは、details要素を使います。ツールチップやドロップダウンメニューのように、ほかの要素の上に重ねて出し、外側のクリックで閉じるUIは、これまでJavaScriptやライブラリで作っていました。Popover APIを使うと、重ねて出すことと閉じることを、HTMLの属性だけで書けます。

html
<button popovertarget="hello">開く</button>
<div id="hello" popover>外側をクリックするかESCキーで閉じます</div>
結果

ボタンを押すと、結果の欄の中央に枠の付いた箱が出ます。外側をクリックするか、ESCキーを押すか、もう一度ボタンを押すと閉じます。

画面の中央に枠付きで出るのは、ブラウザがポップオーバーに当てる既定のスタイル(margin: autoと枠)によるものです。すべての要素のmarginやborderを0にするリセットのCSSを当てたページでは、左上に枠の無い箱で出ます。

Popover APIの全体像

Popover APIで作ったポップオーバーは、次の性質を持ちます。

  • 外側をクリックすると閉じる
  • ESCキーを押すと閉じる
  • 中の要素にautofocusを付けておくと、開いたときにそこへフォーカスが移る
  • Top layer(重ね合わせコンテキストの最上位のレイヤー)に置かれる

autofocusが無いときは、開いてもフォーカスはポップオーバーを開いたボタンに残ります。

Popover APIで使うのは、HTMLのpopoverとpopovertarget、popovertargetactionの3つの属性と、CSSの::backdropと:popover-openです。

HTML属性

popover属性は、ポップオーバーとして出す要素に付けます。

html
<p id="popover1" popover>ポップオーバーで表示されるコンテンツ</p>

値を書かないときはautoになります。値をmanualにすると、ESCキーや外側のクリックでは閉じなくなるので、主にJavaScriptで開閉するときに使います。

ポップオーバーを開閉するボタンにはpopovertarget属性を付け、値にポップオーバーの要素のidを書きます。

html
<button popovertarget="popover1">
  ポップオーバーの表示を管理する要素
</button>

popovertargetaction属性は、ボタンを押したときにポップオーバーをどうするかを決めます。

html
<button popovertarget="popover1" popovertargetaction="show">
  クリックでポップオーバーを表示
</button>

既定は開閉を切り替えるtoggleで、ほかに開くだけのshowと、閉じるだけのhideがあります。

CSS機能

ポップオーバーの後ろには、画面全体を覆う::backdrop擬似要素が置かれます。これにスタイルを当てると、ポップオーバーの後ろを暗くできます。

css
::backdrop {
  background-color: #00000080;
}

::backdropはPopover APIだけのものではなく、dialog要素のようにTop layerに置かれる要素の背景にも使います。

:popover-open擬似クラスは、開いているポップオーバーに当たります。

css
.popover:popover-open {
  min-width: 50vw;
}

サンプル

次の例では、3つのボタンにそれぞれ別のpopovertargetactionを付け、:popover-openと@starting-styleで、開くときに少しずつ現れるようにしています。

html
<div class="wrapper">
  <button popovertarget="popover1" popovertargetaction="toggle">
    popovertargetaction: toggle
  </button>
  <button popovertarget="popover1" popovertargetaction="show">
    popovertargetaction: show
  </button>
  <button popovertarget="popover1" popovertargetaction="hide">
    popovertargetaction: hide
  </button>
</div>
<p id="popover1" popover>
  このポップオーバーはPopover APIによって表示されました。
  ESCキーやこのコンテンツの外側のクリック、toggleまたはhideボタンで閉じられます。
</p>
結果

おわりに

Popover APIでは、ポップオーバーにする要素にpopover属性を、開閉するボタンにpopovertarget属性を付けるだけで、外側のクリックやESCキーで閉じるツールチップやドロップダウンメニューをJavaScriptなしで作れます。

CSS Anchor PositioningがBaselineに入れば、ボタンのそばに出すところまでCSSだけで書けるようになります。その日が来るのを楽しみにしています。