HTMLのpopover属性を使うと、メニューや補足情報のような非モーダル表示を、まずはJavaScriptを書かずに作れます。この記事では、popoverとpopovertargetの最小構成から、autoとmanualの違い、使うときの注意点まで初心者向けに確認します。
Popover APIとは
Popover APIは、ページ上の他のコンテンツより手前に一時的な内容を表示するためのWeb標準です。HTML要素にpopover属性を付けると、その要素は通常時は非表示になり、表示時にはtop layerと呼ばれる前面レイヤーに配置されます。
用語解説:非モーダル
表示中でもページの他の部分を操作できるUIです。ページ全体の操作を止める必要がある確認画面などは、popoverではなくdialog要素の利用を検討します。
JavaScriptなしの最小実装
表示する要素にpopoverとidを付け、開閉ボタンにpopovertargetを指定します。popovertargetの値は、開閉したいpopover要素のidと同じにします。
<button type="button" popovertarget="help-popover">
補足を見る
</button>
<div id="help-popover" popover>
<p>この説明はポップオーバーで表示されています。</p>
</div>
popovertargetactionを省略した場合、ボタンは対象を表示・非表示に切り替えるtoggleとして動作します。まずはこの最小構成で、開く・閉じる動作を確認すると理解しやすくなります。
popover=autoの基本動作
値を付けずにpopoverとだけ書くと、popover=autoと同じ扱いになります。autoでは、外側をクリックしたりEscキーで閉じたりできるlight dismissが利用でき、通常は同時に表示されるauto popoverは1つです。
- 属性だけのpopoverはautoとして扱われる
- 外側のクリックやEscキーで閉じられる
- 別のauto popoverを開くと、通常は先に開いていたものが閉じる
- ボタン側でpopovertargetaction=show / hide / toggleを指定できる
autoとmanualの使い分け
| 指定 | 主な動作 | 向いている場面 |
|---|---|---|
| popover=auto | light dismissあり。通常は1つずつ表示 | メニュー、補足、簡易ピッカー |
| popover=manual | 自動では閉じず、明示的な操作で開閉 | 複数を独立して残したい表示 |
最初はautoから試すのが分かりやすいです。複数の表示を同時に残したいなど、autoの自動的な閉じ方が用途に合わない場合にmanualを検討します。
初心者が確認したい注意点
- 開閉ボタンにはbutton要素を使い、何を開くボタンなのか分かる文言にする
- popovertargetの値とpopover要素のidが一致しているか確認する
- モーダルな確認画面が必要ならdialog要素との違いを確認する
- 古いブラウザーや端末も対象なら互換性を確認し、必要に応じて代替UIを用意する
- 複雑な入れ子や多数のpopoverに進む前に、まず1つの最小構成でキーボード操作まで確認する
HTML標準の機能を使うと、独自JavaScriptで開閉状態を一から管理する前に、ブラウザーが提供する基本動作を利用できます。用途に合うかを小さく試してから広げるのが安全です。
まとめ
popoverとpopovertargetを組み合わせると、JavaScriptなしでも基本的なポップオーバーを作れます。最初はautoの最小構成を試し、外側クリックやEscキーでの閉じ方、ボタンとの紐付けを確認しましょう。
HTMLの新しい機能を学ぶときは、まず最小コードをブラウザーで動かし、標準の挙動を確認してからJavaScriptによる拡張を足していくと理解しやすくなります。