[10] [[DOMイベント]]は[[木構造]]に対して定義されていますが、 実際に[[木]]として使われるのは[[節点木]] ([CODE(DOMi)@en[[[Document]]]] や [CODE(DOMi)@en[[[Element]]]] の[[木]]) だけで、 それ以外のほとんどは単一の[[オブジェクト]]です。 * 仕様書 [REFS[ - [19] '''[CITE@en[DOM Standard]] ([TIME[2016-02-18 20:04:25 +09:00]] 版) ''' - [21] [CITE@en[DOM Standard]] ([TIME[2016-07-05 18:22:22 +09:00]]) - [46] [CITE@en[DOM Standard]] ([TIME[2016-07-05 18:22:22 +09:00]]) - [22] [CITE@en[DOM Standard]] ([TIME[2016-02-18 20:04:25 +09:00]] 版) - [24] [CITE@en[DOM Standard]] ([TIME[2016-02-18 20:04:25 +09:00]] 版) - [39] [CITE@en[DOM Standard]] ([TIME[2016-07-05 18:22:22 +09:00]]) ]REFS] * 親の取得 [16] [CODE(DOMi)@en[[[EventTarget]]]] は、 [[イベント]][VAR[イベント]]を[[引数]]とする[DFN[[RUBYB[親の取得]@en[get the parent]]]][[アルゴリズム]]を持ちます [SRC[>>19]]。 [VAR[イベント対象]]の[[親の取得]]は、[VAR[イベント対象]]により、次のようにします。 [FIG(switch)[ : [[文書]] : [SRC[>>24]] [FIG(steps)[ = [26] [VAR[イベント]]の[F[[[型]]]]が [CODE[[[load]]]] か、 [VAR[イベント対象]]の[F[閲覧文脈]]が [[null]] なら、 == [27] [[null]] を返します。 = [28] それ以外なら、 == [29] [VAR[イベント対象]]の[F[[CODE(DOMi)@en[[[Window]]]]]]を返します。 ]FIG] : [[影根]] : [SRC[>>39]] [FIG(steps)[ = [40] [VAR[イベント]]の[F[合成フラグ]]が[[偽]]なら、 == [41] [[null]] を返します。 = [42] それ以外なら、 == [43] [VAR[イベント対象]]の[F[ホスト][影ホスト]]を返します。 ]FIG] : [[要素]]、[[テキスト]] : [SRC[>>22]] [FIG(steps)[ = [34] [VAR[イベント対象]]が[F[割り当て済み]]なら、 == [35] [VAR[イベント対象]]の[F[割り当て済みスロット]]を返します。 = [36] それ以外なら、 == [37] [VAR[イベント対象]]の[F[親][parentNode]]を返します。 ]FIG] : [[文書型]]、[[注釈]]、[[処理指令]] : [VAR[イベント対象]]の[F[親][parentNode]]を返します [SRC[>>22]]。 : それ以外 : [[null]] を返します [SRC[>>19]]。 ]FIG] [30] [[親の取得]]は、[[dispatch]] で参照されます。 * 木をまたぐイベントの伝播 [4] [[木]]構造を超えた[[イベント]]の伝播には次のものがあります。 [FIG(list)[ - [5] [CODE(DOMi)@en[[[Document]]]] -> [CODE(DOMi)@en[[[Window]]]] [SRC[>>8]] - [38] [[割り当て済み節点]] -> [[スロット]] - [7] [[影根]] -> [[影ホスト]] -- [CODE(DOMa)@en[composed]] === [CODE(IDL)@en[false]] の場合 - [6] [DEL[[CODE(HTMLe)@en[[[iframe]]]] [CODE(HTMLa)@en[[[seamless]]]] 境界 [SRC[>>11]]]] -- [[子閲覧文脈]]の [CODE(DOMi)@en[[[Window]]]] の[[親]]が [CODE(DOMi)@en[[[iframe]]]] ]FIG] * イベント経路 [23] [[イベントオブジェクト]]は、[DFN[[F[[RUBYB[経路]@en[path]]][イベント経路]]]]を持ちます [SRC[>>22]]。 [44] [[仕様書]]の規定は若干わかりにくい形になっています。次の説明は、少し違う (が等価な) 形です。 [25] [F[経路][イベント経路]]の初期値は、空です [SRC[>>22]]。 [45] [F[経路][イベント経路]]は [[dispatch]] で設定されます。 [[dispatch]] 自体の他、 [CODE(DOMm)@en[composedPath]] でも参照されます。 [[仕様書]]上は[[影根]]の[F[親の取得]]でも参照されます。 [47] [F[経路][イベント経路]]は、 [[dispatch]] の最初で[VAR[イベント]]と[VAR[対象]]と[VAR[遺物[[対象上書き]]フラグ]]を使って次のように構築されます [SRC[>>46]]。 [FIG(steps)[ = [77] [VAR[イベント経路]]を、[[空リスト]]に設定します。 = [52] [VAR[オブジェクト]]を、[VAR[対象]]に設定します。 = [58] [VAR[遺物[[対象上書き]]フラグ]]が設定されていれば、 == [60] [VAR[相対対象]]を、[VAR[対象]]の[F[文書]]に設定します。 = [59] それ以外なら、 == [50] [VAR[相対対象]]を、[VAR[対象]]に設定します。 = [75] [VAR[イベント]]の[VAR[オブジェクト]]における[[関連対象]]が[VAR[オブジェクト]]で、 [VAR[イベント]]の[F[関連対象]]が[VAR[オブジェクト]]でないなら、 == [76] ([VAR[イベント経路]], [CODE[null]]) を返し、ここで停止します。 = [111] [VAR[活性化イベントである]]を、[VAR[イベント]]が [CODE(DOMi)@en[MouseEvent]] かつ[VAR[イベント]]の[F[型][イベント型]]が [CODE[click]] である、に設定します。 = [112] [VAR[活性化対象]]を、[VAR[活性化イベントである]]かつ[VAR[オブジェクト]]の[F[活性化動作]]が [CODE[null]] でないなら[VAR[オブジェクト]]、それ以外なら [CODE[null]] に設定します。 = [73] 繰り返し、 == [53] [VAR[イベント経路]]に、新しい項目を追加します。 [FIG(list members)[ : [F[現在対象]] : [VAR[オブジェクト]] : [F[対象][イベント対象]] : [VAR[相対対象]] : [F[関連対象]] : [VAR[イベント]]の[VAR[オブジェクト]]における[[関連対象]] ]FIG] == [54] [VAR[親]]を、[VAR[オブジェクト]]の[F[親の取得]]を[VAR[イベント]]について実行した結果に設定します。 == [49] [VAR[親]]が [CODE[null]] でなら、 === [74] ([VAR[イベント経路]], [VAR[活性化対象]]) を返し、ここで停止します。 == [56] [VAR[オブジェクト]]と[VAR[親]]が違う[[木]]に属するなら、 === [57] [VAR[相対対象]]を、[VAR[親]]に設定します。 === [79] [VAR[親]]と[VAR[イベント]]の[VAR[親]]における[[関連対象]]が等しいなら、 ==== [80] ([VAR[イベント経路]], [VAR[活性化対象]]) を返し、ここで停止します。 === [81] [VAR[活性化対象]]が [CODE[null]] で、[VAR[活性化イベントである]]かつ[VAR[親]]の[F[活性化動作]]が [CODE[null]] でないなら、 ==== [82] [VAR[活性化対象]]を、[VAR[親]]に設定します。 == [83] それ以外の場合、 === [84] [VAR[活性化対象]]が [CODE[null]] で、[VAR[活性化イベントである]]かつ[VAR[親]]の[F[活性化動作]]が [CODE[null]] でなく、 [VAR[イベント]]の [F[bubbles]] が[[真]]なら、 ==== [85] [VAR[活性化対象]]を、[VAR[親]]に設定します。 == [55] [VAR[オブジェクト]]を、[VAR[親]]に設定します。 ]FIG] [51] ここで、[VAR[イベント]]の[VAR[オブジェクト]]における[[関連対象]]とは、 [FIG(switch)[ : [VAR[イベント]]の[F[関連対象]]が [CODE[null]] : [CODE[null]] : それ以外 : [VAR[イベント]]の[F[関連対象]]を[VAR[オブジェクト]]について[[再対象付け]]した結果 ]FIG] ... をいいます。 [48] [F[イベント経路]]は、 [[dispatch]] の最後で空に戻されます [SRC[>>46]]。 [64] [VAR[節点]]を[VAR[基準点]]について[DFN[[RUBYB[再対象付け]@en[retarget]]]]した結果とは、 [VAR[節点]]と[VAR[基準点]]が同じ[[木]]に属するか、 [VAR[基準点]]が[[影木]]に属する (など[[影を含む子孫]]である) ならば[VAR[節点]]、 そうでないなら[VAR[節点]]の[F[根]]の[F[影ホスト]]を[VAR[基準点]]について[[再対象付け]]したものです [SRC[>>46]]。 [86] これは [CODE(DOMa)@en[pointerLockElement]] から参照されています。 @@ [66] [DFN[retargeting steps]] [SRC[>>46]] * 歴史 [17] [[dispatch]] において [CODE(DOMi)@en[[[Window]]]] は [CODE(DOMi)@en[[[Document]]]] の[[親]]として (ほとんどの場合に) 動作するよう昔から実装されていましたが、 [[HTML5]] まで明文化されていませんでした。 [REFS[ -[1] [CITE@en[Bug 18780 – Fix event dispatching for shadow DOM and