HTMLSlotElement: assignedNodes() メソッド

assignedNodes()HTMLSlotElement インターフェイスのプロパティで、このスロットに割り当てられた一連のノードを返します。

flatten オプションが true に設定されていた場合は、このスロットの子孫である他のスロットに割り当てられたノードも返します。割り当てられたノードが見つからない場合は、スロットの代替コンテンツを返します。

構文

js

assignedNodes()
assignedNodes(options)

引数

options 省略可

返されるノードのためのオプションを設定したオブジェクトです。利用可能な値は以下のとおりです。

flatten

論理値で、利用可能な子の <slot> 要素すべてに割り当てられたノードを返すか (true)、返さないか (false) を示します。既定値は false です。

返値

ノードの配列。

以下のスニペットは、 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}".`,
  );
});

ここではすべてのスロットの参照を取得し、テンプレート内の 2 番目のスロットに slotchange イベントリスナーを追加します。 — これが例の中でコンテンツの変更を追跡します。

スロットの変更の中で要素が挿入されるたびに、コンソールにどのスロットが変更されたか、スロット内の新しいノードは何であるかをログ出力します。

仕様書

Specification
HTML Standard
# dom-slot-assignednodes-dev

ブラウザーの互換性

BCD tables only load in the browser