ToggleEvent.sourceでpopoverを開いた要素を特定
ToggleEvent.sourceは、popoverやdialogを開閉したボタンをtoggleイベントから読めるプロパティです。1つのpopoverを複数のボタンで開くとき、押されたボタンに合わせて中身を切り替えられます。
- Chrome140
- Edge140
- Firefox145
- Safari26.5
はじめに
ToggleEvent.sourceは、ポップオーバーや<dialog>を開閉したボタンを、toggleとbeforetoggleのイベントから読めるプロパティです。開いたか閉じたかに加えて、どのボタンで開閉したかが同じイベントで分かります。Safari 26.5が対応して、Baseline 2026に入りました。
ボタンが1つのときは、そのボタンのclickイベントで分かります。複数のボタンから1つのポップオーバーを開くUIでは、これまで各ボタンのclickで押されたボタンを変数に覚え、ポップオーバーの側でそれを読んでいました。sourceなら、ポップオーバーのtoggleイベントのリスナー1つで、押されたボタンが分かります。
const log = document.getElementById('log');
document.getElementById('menu').addEventListener('toggle', (event) => {
log.textContent = `${event.newState} ${event.source?.id ?? null}`;
});<button popovertarget="menu" id="a">A</button>
<button popovertarget="menu" id="b">B</button>
<div id="menu" popover>メニュー</div>
<p id="log"></p>Aを押すと結果の欄にopen a、もう一度Aを押すとclosed aが出ます。Bで開けばopen bで、外側をクリックして閉じるとclosed nullです。
sourceに入る値
toggleとbeforetoggleのイベントはToggleEventです。newStateとoldStateで開いたか閉じたかが分かり、sourceで開閉した要素が分かります。
呼び出し元の要素
呼び出し元としてsourceに入るのは、次の3つです。
popovertarget属性を持つボタンcommandforと、command="show-popover"か"hide-popover"、"toggle-popover"を書いたボタン- スクリプトで
showPopover({ source })やtogglePopover({ source })に渡した要素
ボタンの2つは、開く方向でも閉じる方向でも押したボタンが入ります。<dialog>も、commandforとcommand="show-modal"や"close"のボタンで開閉すると、そのボタンが入ります。<details>のtoggleイベントではnullです。togglePopover({ source })で閉じたときは、ChromeとFirefoxではnull、Safariでは渡した要素が入ります。
nullになる場合
呼び出し元を通さずに開閉すると、nullになります。
hidePopover()をスクリプトから呼ぶ(hidePopoverはsourceオプションを取らない)showPopover()やtogglePopover()を、sourceオプションを渡さずに呼ぶ- ESCキーや外側のクリックで閉じる(light dismiss)
ボタンで開閉したかどうかを、リスナーで見分けるのにも使えます。
使い方
メンバー一覧の詳細ボタンを押すと、共通のポップオーバーが押されたメンバーの情報に切り替わって表示されます。
<ul>
<li>Alice <button data-member-id="alice">詳細</button></li>
<li>Bob <button data-member-id="bob">詳細</button></li>
<li>Carol <button data-member-id="carol">詳細</button></li>
</ul>
<pre id="state"></pre>
<div id="member-card" popover>
<p id="detail"></p>
<button popovertarget="member-card" popovertargetaction="hide">閉じる</button>
</div>/* 開いたポップオーバーがボタンに重ならないように、高さを取って下に寄せる */
body {
min-height: 20rem;
}
#member-card {
margin-block-end: 1rem;
}const members = {
alice: 'Alice(Frontend Engineer)',
bob: 'Bob(Designer)',
carol: 'Carol(Product Manager)',
};
const popover = document.getElementById('member-card');
const detail = document.getElementById('detail');
const state = document.getElementById('state');
popover.addEventListener('toggle', (event) => {
const { source } = event;
const memberId = source?.dataset.memberId ?? null;
state.textContent = [
`oldState: ${event.oldState}`,
`newState: ${event.newState}`,
`source.textContent: ${source?.textContent ?? null}`,
`source.dataset.memberId: ${memberId}`,
].join('\n');
if (event.newState === 'open' && memberId) {
detail.textContent = members[memberId];
}
});
for (const button of document.querySelectorAll('li button')) {
button.addEventListener('click', () => {
// 開いたまま別のボタンを押しても切り替わるように、閉じてから開き直す
popover.hidePopover();
popover.showPopover({ source: button });
});
}ボタンにはpopovertargetで共通のポップオーバーを指定し、data-member-idでどのメンバーかを持たせます。開く操作はブラウザに任せられるので、HTMLは次のように書けます。
<button popovertarget="member-card" data-member-id="alice">詳細</button>
<button popovertarget="member-card" data-member-id="bob">詳細</button>
<button popovertarget="member-card" data-member-id="carol">詳細</button>
<div id="member-card" popover></div>JavaScriptは、ポップオーバーにtoggleのリスナーを1つ付けるだけです。event.sourceが押されたボタンなので、そのdata-member-idから中身を組み立てます。
const popover = document.getElementById('member-card');
popover.addEventListener('toggle', (event) => {
// 閉じる方向(light-dismissやhidePopover)はsourceがnullのことが多いので、
// 開く方向だけを処理する
if (event.newState !== 'open') return;
const trigger = event.source;
発火元のボタン要素が取れる
if (!(trigger instanceof HTMLElement)) return;
popover.textContent = `${trigger.dataset.memberId}の詳細`;
});aliceのボタンを押すと、ポップオーバーにaliceの詳細と出ます。ボタンごとにリスナーを付けたり、最後に押されたボタンを覚えておいたりせずに、ポップオーバーの1か所で押されたボタンが分かります。
ただし、popovertargetの既定の動き(toggle)では、ポップオーバーを開いたまま別のメンバーの詳細を押すと、切り替わらずに閉じます。どのブラウザでも、そのときのtoggleイベントはnewStateがclosedで、sourceは後から押したボタンです。popovertargetaction="show"にすると、開いているあいだは押しても何も起きず、イベントも届きません。
デモでは、ボタンのclickでhidePopover()とshowPopover({ source })を続けて呼び、開いたまま中身を切り替えています。このときbeforetoggleは閉じる向きと開く向きの2回届き、toggleはoldStateもnewStateもopenの1回にまとまります。
ReactのonToggleで受け取る合成イベントにも、実行時にはsourceが入ります。ただし@types/reactの型にはsourceが無いので、TypeScriptではevent.nativeEvent.sourceから読みます。
おわりに
ToggleEvent.sourceを使うと、1つのポップオーバーを複数のボタンで開くUIで、押されたボタンをポップオーバーのtoggleイベントから読めます。開いたまま別のボタンで中身を切り替えるときは、hidePopover()とshowPopover({ source })を続けて呼びます。