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 |