本文へ移動

k8o

お問い合わせ

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

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

Blog

公開: 2026年5月23日(土)更新: 2026年11月9日(月)約11分で読めます

ToggleEvent.sourceでpopoverを開いた要素を特定

ToggleEvent.sourceは、popoverやdialogを開閉したボタンをtoggleイベントから読めるプロパティです。1つのpopoverを複数のボタンで開くとき、押されたボタンに合わせて中身を切り替えられます。

Newly availableToggleEvent source2026年〜
  • Chrome140
  • Edge140
  • Firefox145
  • Safari26.5

はじめに

ToggleEvent.sourceは、ポップオーバーや<dialog>を開閉したボタンを、toggleとbeforetoggleのイベントから読めるプロパティです。開いたか閉じたかに加えて、どのボタンで開閉したかが同じイベントで分かります。Safari 26.5が対応して、Baseline 2026に入りました。

ボタンが1つのときは、そのボタンのclickイベントで分かります。複数のボタンから1つのポップオーバーを開くUIでは、これまで各ボタンのclickで押されたボタンを変数に覚え、ポップオーバーの側でそれを読んでいました。sourceなら、ポップオーバーのtoggleイベントのリスナー1つで、押されたボタンが分かります。

js
const log = document.getElementById('log');

document.getElementById('menu').addEventListener('toggle', (event) => {
  log.textContent = `${event.newState} ${event.source?.id ?? null}`;
});
結果

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)

ボタンで開閉したかどうかを、リスナーで見分けるのにも使えます。

使い方

メンバー一覧の詳細ボタンを押すと、共通のポップオーバーが押されたメンバーの情報に切り替わって表示されます。

html
<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>
結果

ボタンにはpopovertargetで共通のポップオーバーを指定し、data-member-idでどのメンバーかを持たせます。開く操作はブラウザに任せられるので、HTMLは次のように書けます。

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から中身を組み立てます。

js
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 })を続けて呼びます。