カスタム要素反応 (DOM)

意味

[8] カスタム要素反応 (custom element reaction) >>7 は、カスタム要素に関する変化を通知するコールバック関数です。次のものがあります。

カスタム要素構築器: 要素の格上げで実行されます。
connectedCallback: 要素が接続された際に実行されます。
disconnectedCallback: 要素が切断された際に実行されます。
adoptedCallback: 要素が養子化 (他の文書に移動) された際に実行されます。
attributeChangedCallback: 要素の内容属性の変更操作が発生した際に実行されます。

[9] カスタム要素構築器は、カスタム要素定義を作成する際に、必ず指定します (define メソッドの第2引数)。それ以外は、カスタム要素構築器の prototype オブジェクトのプロパティーとして、必要に応じて指定できます。

[12] カスタム要素構築器は、その時点ではまだカスタムでない要素について実行されます。それ以外のコールバックは、カスタム要素について実行されます。

[10] カスタム要素反応は、該当する DOM 操作が発生した時に実行されます。複数の変更が発生する場合であっても、一連の変更がすべて適用された後、呼び出し元に戻る直前にまとめて実行されます。著者視点では DOM 操作中に同期的に呼び出されていますが、利用者エージェント視点では DOM 操作直後に非同期的に呼び出しているので、著者は DOM 操作の途中段階にアクセスすることはできませんし、利用者エージェントは DOM 操作中の不安定な状態を著者に晒さずに済みます。

[11] あるカスタム要素について、ある操作群に対するカスタム要素反応群は、必ず同じ順序で実行されることが保証されます。複数のカスタム要素全体については (カスタム要素反応内で他の要素を変更する場合があるので) 保証されません。 >>7

[99] カスタム要素反応器が節点木を操作すると予期せぬ結果となることがあるため、これを避けるべきです。 >>7

[100] 例えば connectedCallback が呼ばれている要素が既に他のカスタム要素反応器によって切断されているかもしれません。

キュー

[70] 実行するべきカスタム要素反応は、 Webブラウザーによって要素ごとに管理されます。要素ごとのキューを使うので、要素ごとの実行順序は保証されますが、異なる要素でどの順序で実行されるかは保証されません。

[16] 要素は、カスタム要素反応キュー (custom element reaction queue) を持ちます。これは、格上げ反応またはコールバック反応のキューで、初期状態は空です。 >>7

[17] キューへの追加は、格上げ反応とコールバック反応の項を参照。

[77] push/pop の他に、要素の格上げで空にされることがあります。

[71] 更に、どの要素に実行するべきカスタム要素反応が存在するかが、要素キューによって管理されます。

[14] 要素キュー (element queue) は、要素のキューで、初期状態は空です。 >>7

[13] 関連する類似起源閲覧文脈群の単位は、カスタム要素反応群スタック (custom element reactions stack) を持ちます >>7。

カスタム要素反応群スタック

スタック: 要素キューのスタック。初期状態は空。 >>7
現在要素キュー (current element queue): スタックの最上にある要素キュー >>7。
バックアップ要素キュー (backup element queue): 要素キュー。初期状態は空です。 >>7
バックアップ要素キュー処理中 (processing the backup element queue) フラグ: 初期状態は未設定。 >>7

[72] 構文解析器や DOM API 内部では、カスタム要素反応群スタックの本体スタックの要素キューが使われます。カスタム要素反応は同期的に呼び出され、そこから更に再帰的にカスタム要素反応が呼び出される可能性があるため、要素キューはスタックに積まれていくことになっています。

[73] contenteditable により利用者の操作で DOM 操作が行われた場合には、バックアップ要素キューが使われます >>7。カスタム要素反応はマイクロタスクで呼び出されます。

[15] 要素について適切な要素キューに要素を追加 (enqueue an element on the appropriate element queue) するには、次のようにします >>7。

[58] 関連する類似起源閲覧文脈群の単位のカスタム要素反応群スタックが空なら、
1. [59] 要素を、関連する類似起源閲覧文脈群の単位のカスタム要素反応群スタックのバックアップ要素キューに追加します。
2. [60] 関連する類似起源閲覧文脈群の単位のカスタム要素反応群スタックのバックアップ要素キュー処理中フラグが設定されていなければ、
  1. [61] 関連する類似起源閲覧文脈群の単位のカスタム要素反応群スタックのバックアップ要素キュー処理中フラグを設定します。
  2. [62] >>65 のマイクロタスクをマイクロタスクをキューに追加します。
[63] それ以外なら、
1. [64] 要素を、関連する類似起源閲覧文脈群の単位のカスタム要素反応群スタックの現在要素キューに追加します。

[68] この処理は、格上げ反応やコールバック反応の処理から呼び出されます。

[65] バックアップ要素キューに関するマイクロタスクは、次のようにします >>7。

[66] 関連する類似起源閲覧文脈群の単位のカスタム要素反応群スタックのバックアップ要素キューのカスタム要素反応群の呼び出しをします。
[67] 関連する類似起源閲覧文脈群の単位のカスタム要素反応群スタックのバックアップ要素キュー処理中フラグを未設定にします。

[18] 要素キューキューのカスタム要素反応群の呼び出し (invoke custom element reactions) は、次のようにします >>7。

[19] キューの各要素について、
1. [20] 反応群を、要素のカスタム要素反応キューに設定します。
2. [21] 反応群が空でない限り、繰り返し、
  1. [22] 反応を反応群の最初の項目とし、これを反応群から削除します。
  2. [23] 反応群の種別により、
    格上げ反応
    要素と反応のカスタム要素定義について、要素の格上げを実行します。例外が投げられたら、例外を報告します。
    コールバック反応
    反応のコールバック関数を呼び出します。 反応群の引数リストを引き渡します。 コールバックthis値は、要素とします。例外が投げられたら、例外を報告します。