到達目標:クリックをRustの処理へ結び付ける
静的なDOMを描画できた後は、入力イベントがどの関数を動かすかを確かめます。第4弾では、UIがクリックの対象識別子を渡し、Rustのdispatch_eventが教材DOM上の経路とリスナーを処理します。見た目のボタンへホストのJavaScriptで教材の計算を実装する構成ではありません。登録した関数がRustの評価器で呼ばれ、同じDOMを変更するという接続を追うことが目標です。
イベントを理解するには、対象、現在処理中のノード、配送の段階を分けます。対象はクリックを起点として選んだノードであり、祖先のリスナーを処理している間も、対象そのものが祖先へ変わるわけではありません。画面のイベントトレースとRustの経路処理を比べ、どのリスナーがなぜ先に呼ばれたかを説明します。ボタンが反応したという一つの結果だけでは、配送順の正しさは確認できません。
登録の内容と配送の内容を分ける
教材では、要素のaddEventListenerにclick、名前付き関数、必要ならcaptureの真偽値を渡してリスナーを登録します。登録時点では関数本体を実行しません。ノードの識別子、イベント種別、関数への参照、captureの指定を保存し、配送時にそれらを選びます。登録と呼び出しを混同すると、ページの初期化時にクリック処理が走ったり、異なる対象のリスナーが呼ばれたりします。
対応するのは限定したクリック配送です。完全なDOMイベント仕様の全機能、Shadow DOMの境界、既定動作、任意のイベントオプションまで実装したと解釈しないでください。公式DOM仕様は段階と用語を理解する一次資料であり、この教材の対応範囲はRustの実装と入力契約で確認します。実装していないオプションを見た目だけ受け入れるより、範囲を明示して診断できる方が、学習上の因果関係を保てます。
経路を決めてから二つの方向へたどる
DOMには親子関係があるため、対象から親をたどると祖先の列が得られます。captureでは外側から対象へ近づき、bubbleでは対象から外側へ戻る順序を考えます。どちらも同じノード列を異なる向きに使います。兄弟ノードは対象への経路に含まれません。画面で近くに見えるかではなく、Rustのarenaに保存された親子関係が順序の根拠になります。
配送中にDOMの内容を変更する場合も、経路の考え方を保ちます。textContentの変更によって子の内容が変わる処理と、今配送しているイベントの対象経路を計算する処理は別の責任です。安定した識別子と、どの時点の経路を使うかを確認してください。対象の文字列や見た目のラベルを毎回検索し直すと、同じイベントの途中で意図せず別の要素へ処理が移る可能性があります。
手計算トレース:三つのノードの順序
root、panel、buttonという親子関係を考え、それぞれにcaptureとbubbleのリスナーを一つずつ登録します。伝播停止がなければ、外側のcaptureから対象へ進み、対象側のbubbleから外側へ戻る順序を予測できます。対象上の二種類のリスナーと祖先上のリスナーを区別し、同じbuttonが二度出る理由を説明してください。これはクリックが二回発生したという意味ではありません。
次にpanelのcaptureリスナーでstopPropagationを呼びます。以降の別ノードへの進行が止まることを、実装のトレースで確かめます。stopPropagationを「登録済みの全リスナーを削除する」操作と混同しないでください。また、同じノードの他のリスナーまで止めるstopImmediatePropagationとは別の概念です。表とスニペットでは各段階に一つずつだけ登録し、停止の基本契約に焦点を絞っています。
| 順番 | 停止なし | panelのcaptureで停止 |
|---|---|---|
| 1 | root capture | root capture |
| 2 | panel capture | panel capture → 停止 |
| 3 | button capture | 配送されない |
| 4 | button bubble | 配送されない |
| 5–6 | panel bubble → root bubble | 配送されない |
入力列の順序と失敗の位置を観察する
構造化された入力は、初期HTML、CSS、JavaScriptに加えてイベント列を含められます。初期スクリプトでリスナーを登録し、その後に列の順でイベントを配送します。同じ対象への二回のクリックと、一回のクリックを二回別々に初期化して実行する操作は異なります。前者では一回目が変更した変数やDOMを二回目が読むため、カウンターの増え方を使って状態の継続を確認できます。
正常系は対象と祖先があるクリック、境界はリスナーのない対象や一件もないイベント列、失敗系は存在しない対象を指定する入力です。入力イベントは最大16件です。上限を超える列を実行したつもりにならず、診断された時点を確認します。ハンドラー内の実行時エラーと、入力形式のエラーも区別し、どのイベントまで完了したかを結果とトレースに基づいて説明します。
実行できるRust:経路と伝播停止の契約
次のコードは、あらかじめ決めた経路に対する順序と停止を確かめる独立したホスト用Rustです。HTMLの解析、リスナーの登録API、関数評価、同じノードの複数リスナーは含みません。経路の各ノードに各段階一つのリスナーがあるという仮定を明示しています。完全なDOMイベント配送器だと誤解せず、この小さな契約を実際のdispatch_eventへ対応づけて使います。
pathは外側から対象へ並び、逆向きの反復がbubbleを表します。停止位置2では外側の1と2だけがcaptureで実行されます。空経路も正常に終了することを確かめています。実際の処理系では対象の存在や経路の作り方も検証されるため、コードの空経路の扱いを、不正な対象を許可する仕様へ読み替えないでください。モデルの前提と実装全体の前提を別々に記録することが大切です。 対象3で停止する追加のassertでは、同じ対象上のcaptureとbubbleの両方を実行し、祖先へは戻りません。
#[derive(Clone, Copy, PartialEq, Debug)]
enum Phase { Capture, Bubble }
fn dispatch(path: &[u32], stop_at: Option<u32>) -> Vec<(u32, Phase)> {
let mut log = Vec::new();
for &id in path {
log.push((id, Phase::Capture));
if stop_at == Some(id) && Some(id) != path.last().copied() { return log; }
}
for &id in path.iter().rev() {
log.push((id, Phase::Bubble));
if stop_at == Some(id) { return log; }
}
log
}
fn main() {
let path = [1, 2, 3]; // root, parent, target; one listener per phase
let full = dispatch(&path, None);
assert_eq!(full.iter().map(|x| x.0).collect::<Vec<_>>(), vec![1,2,3,3,2,1]);
let stopped = dispatch(&path, Some(2));
assert_eq!(stopped, vec![(1,Phase::Capture),(2,Phase::Capture)]);
let at_target = dispatch(&path, Some(3));
assert_eq!(at_target, vec![(1,Phase::Capture),(2,Phase::Capture),
(3,Phase::Capture),(3,Phase::Bubble)]);
assert!(dispatch(&[], None).is_empty());
println!("full={} stopped={}", full.len(), stopped.len());
}副作用の順番を説明できるトレースにする
各リスナーが同じ変数へ値を足すだけでは、最終値から順序を読み取れないことがあります。console.logへ段階と名前を記録したり、異なる文字を順に連結したりして、captureとbubbleの順序を区別します。トレースの件数には上限があるため、長い入力ではすべての詳細が表示されると仮定しないでください。必要な差が短い入力で見えるように、観測のための操作を最小限にします。
ハンドラーがtextContentや属性を変えた後の描画は、配送そのものとは次の境界です。イベントが届かなかったのか、関数が失敗したのか、DOMは変わったが表示計算が違ったのかを切り分けます。対象識別子、呼び出された関数、変更されたノード、描画結果を一つずつ対応させると、反応しないボタンを単なる見た目の問題として扱わず、具体的な段階の問題へ絞れます。
演習:停止位置を一つずつ移動する
演習では三層のDOMを用意し、各ノードに名前付き関数を登録します。最初は停止なしで順序を予測し、次に外側、親、対象の順でstopPropagationの位置を変えます。各入力について、呼ばれる名前の列を実行前に記録してください。見た目のクリック回数ではなく、Rustのトレースに現れる関数と段階を比較します。関係のない兄弟にもリスナーを付け、配送されない理由を説明します。
続いて同じイベントを二件並べ、一件目が変えた値を二件目が読むかを確認します。最後に対象idを存在しない値へ変更し、正常配送との違いを記録してください。提出物にはDOMの親子関係、登録表、予測した呼び出し列、実測の列、失敗の診断を含めます。発展課題ではリスナーが文字列を書き換える例を使い、イベントの対象経路とDOMの内容の変化を分けて説明します。