HTMLSlotElement: slotchange イベント

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

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

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

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

構文

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

addEventListener('slotchange', (event) => {});

onslotchange = (event) => { };

イベント型

一般的な Event です。

例

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

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

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 Standard
# eventdef-htmlslotelement-slotchange
HTML Standard
# handler-onslotchange

ブラウザーの互換性

BCD tables only load in the browser

関連情報

HTMLSlotElement