HTMLSlotElement: slotchange イベント

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

slotchange イベントは、 HTMLSlotElement インスタンス(<slot> 要素) において、そのスロットに含まれるノードが変更された場合に発行されます。

メモ: スロットに入っているノードの子ノードが変更された場合、 slotchange イベントは発生しません。実際のノード自体を変更(例えば、追加または削除)した場合に限ります。

slotchange イベントを発行させるには、 slot 属性を設定または削除しなければなりません。

このイベントはキャンセルできません。

構文

このイベント名を addEventListener() などのメソッドで使用するか、イベントハンドラープロパティに設定するかしてください。

js
addEventListener("slotchange", (event) => {});

onslotchange = (event) => {};

イベント型

一般的な Event です。

js
element.setAttribute("slot", slotName);
// element.assignedSlot = $slot
element.removeAttribute("slot");
// element.assignedSlot = null

次のスニペットは、 slotchange の例から取りました (ライブでも確認できます)。

js
let slots = this.shadowRoot.querySelectorAll("slot");
slots[1].addEventListener("slotchange", (e) => {
  let nodes = slots[1].assignedNodes();
  console.log(
    `Element in Slot "${slots[1].name}" changed to "${nodes[0].outerHTML}".`,
  );
});

ここではすべての <slot> への参照を取得し、テンプレートの 2 番目のスロットに slotchange イベントリスナーを追加します。この例ではコンテンツが変更されているスロットです。

スロットに挿入された要素が変更されるたびに、どのスロットが変更されたか、スロット内の新しいノードが何であるかを示すレポートがコンソールに記録されます。

仕様書

Specification
DOM
# eventdef-htmlslotelement-slotchange
HTML
# handler-onslotchange

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
slotchange event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Has more compatibility info.

関連情報