HTMLSlotElement: slotchange イベント

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

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

バブリング あり
キャンセル 不可
インターフェイス Event
イベントハンドラープロパティ なし

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

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

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

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

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

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

仕様書

Specification
HTML Standard
# event-slotchange
HTML Standard
# handler-onslotchange

ブラウザーの互換性

BCD tables only load in the browser

関連情報