Popover APIでツールチップやドロップダウンをJSなしで作る
Popover APIは、popover属性とpopovertarget属性だけで、ツールチップやドロップダウンメニューの開閉をJavaScriptなしで書けるAPIです。外側のクリックやESCで閉じる動きと、CSSでの装飾を説明します。
- Chrome116
- Edge116
- Firefox125
- Safari17
はじめに
Popover APIは、popover属性を付けた要素を、popovertarget属性を付けたボタンで開閉するHTMLの仕組みです。開いた要素はほかの要素より手前に出て、外側のクリックやESCキーで閉じます。2025年にBaselineに入りました。
ページの流れの中で中身を開閉するときは、details要素を使います。ツールチップやドロップダウンメニューのように、ほかの要素の上に重ねて出し、外側のクリックで閉じるUIは、これまでJavaScriptやライブラリで作っていました。Popover APIを使うと、重ねて出すことと閉じることを、HTMLの属性だけで書けます。
<button popovertarget="hello">開く</button>
<div id="hello" popover>外側をクリックするかESCキーで閉じます</div>/* 開いたポップオーバーが収まる高さを取る */
body {
min-height: 8rem;
}ボタンを押すと、結果の欄の中央に枠の付いた箱が出ます。外側をクリックするか、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属性は、ポップオーバーとして出す要素に付けます。
<p id="popover1" popover>ポップオーバーで表示されるコンテンツ</p>値を書かないときはautoになります。値をmanualにすると、ESCキーや外側のクリックでは閉じなくなるので、主にJavaScriptで開閉するときに使います。
ポップオーバーを開閉するボタンにはpopovertarget属性を付け、値にポップオーバーの要素のidを書きます。
<button popovertarget="popover1">
ポップオーバーの表示を管理する要素
</button>popovertargetaction属性は、ボタンを押したときにポップオーバーをどうするかを決めます。
<button popovertarget="popover1" popovertargetaction="show">
クリックでポップオーバーを表示
</button>既定は開閉を切り替えるtoggleで、ほかに開くだけのshowと、閉じるだけのhideがあります。
CSS機能
ポップオーバーの後ろには、画面全体を覆う::backdrop擬似要素が置かれます。これにスタイルを当てると、ポップオーバーの後ろを暗くできます。
::backdrop {
background-color: #00000080;
}::backdropはPopover APIだけのものではなく、dialog要素のようにTop layerに置かれる要素の背景にも使います。
:popover-open擬似クラスは、開いているポップオーバーに当たります。
.popover:popover-open {
min-width: 50vw;
}サンプル
次の例では、3つのボタンにそれぞれ別のpopovertargetactionを付け、:popover-openと@starting-styleで、開くときに少しずつ現れるようにしています。
<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>/* 開いたポップオーバーが収まる高さを取る */
body {
min-height: 16rem;
}
.wrapper {
display: flex;
flex-wrap: wrap;
gap: 2rem;
}
#popover1 {
border-radius: 0.5rem;
margin: auto;
padding: 1rem;
max-width: calc(1 / 3 * 100%);
opacity: 0;
transition: opacity 0.5s cubic-bezier(0.4, 0, 0.2, 1);
}
#popover1:popover-open {
opacity: 1;
}
@starting-style {
#popover1:popover-open {
opacity: 0;
}
}
::backdrop {
background-color: #00000080;
}おわりに
Popover APIでは、ポップオーバーにする要素にpopover属性を、開閉するボタンにpopovertarget属性を付けるだけで、外側のクリックやESCキーで閉じるツールチップやドロップダウンメニューをJavaScriptなしで作れます。
CSS Anchor PositioningがBaselineに入れば、ボタンのそばに出すところまでCSSだけで書けるようになります。その日が来るのを楽しみにしています。