仕様書

生活環コールバック群 (カスタム要素定義)

[2] カスタム要素定義は、生活環コールバック群lifecycle callbacksを持ちます >>1。

[3] これは、写像です。次の3つのキーを持ちます >>3。

[4] 各キーに対応する値は、 Function か、nullのいずれかです。 既定値は、null です。 >>3

[7] これらの値は、 define メソッドでカスタム要素定義を作成する時に、 カスタム要素構築器の prototype から設定されます。

コールバック反応

[18] コールバック反応callback reactionは、 生活環コールバックを実行するもので、 コールバック関数と引数リストを持ちます。 >>5

[6] コールバック反応は、カスタム要素反応キューで使われます。

[8] カスタム要素コールバック反応をキューに追加enqueue a custom element callback reactionする操作は、 カスタム要素要素、 コールバック名、引数リストについて、次のようにします >>5。

  1. [9] 定義を、要素のカスタム要素定義に設定します。
  2. [14] コールバックを、定義の生活環コールバック群のキーがコールバック名の項目の値に設定します。
  3. [15] コールバックが未定義なら、
    1. [16] ここで停止します。
  4. [17] コールバック名が attributeChangedCallback なら、
    1. [19] 属性名を、引数リストの最初の項目に設定します。
    2. [20] 定義の被観察属性群に属性名が含まれないなら、
      1. [21] ここで停止します。
  5. [22] 要素のカスタム要素反応キューに、 コールバックと引数リストの組であるコールバック反応を追加します。
  6. [23] 要素について適切な要素キューに要素を追加します。
[25] 要素の格上げや挿入や削除で呼び出されます。

[24] 実行については、カスタム要素反応キュー参照。

歴史

[26] Take care of missing custom element reactions (domenic著, ) https://github.com/whatwg/html/commit/a57c88711c995356e44d019f5bd81d0cdedac2bf

[27] Fix customized built-in element "is" handling and reactions (domenic著, ) https://github.com/whatwg/html/commit/4e632a82728d68a8a6bd32f02083762b7792ddf7

[10] Implement new custom element adoption semantics (domenic著, ) https://github.com/whatwg/html/commit/feb77d09793a2ed8d49a6949dbca73eabb60ae79