到達目標:変化した理由を処理順で説明する
ボタンを押すと文字が変わる例でも、文字列を書き換えただけで表示が自動的に正しくなるわけではありません。教材ではRustの評価器がDOMを変更し、その同じDOMからstyle、layout、display listを計算します。この章の目標は、イベント、関数、DOM変更、再計算、描画結果のつながりを一つずつ説明することです。最終画面だけでなく、変更前後のノードと途中結果を比較してください。
配布ソースのmutate_textとrender_documentを起点にします。第3弾の静的な描画パイプラインを、新しいホストDOMへ置き換える構成ではありません。既存のRustのarenaを入力として再利用します。UIが結果を表示するために持つ要素と、教材内部のノードは別物です。この境界を確認すると、Rustが作った表示情報を観察しているのか、ホスト側が勝手に補った見た目を見ているのかを区別できます。
ノードの同一性と子の内容を分ける
getElementByIdで得た対象は、Rustのarena内の識別子で表されます。textContentを変更すると、その要素の表示内容が変わりますが、対象要素が別の識別子になったと即断してはいけません。対象と、その内部の子ノードの扱いを分けて追います。以前の子孫への参照が常に有効だと仮定することも避け、配布実装がどの範囲を置き換えるかを確認してください。
ノードの同一性は、イベント対象と変更結果を結び付ける鍵です。同じid文字列を持つ別のオブジェクトを作って置き換える方式では、既に登録したリスナーや保存した参照の意味が変わります。教材のコードを読むときは、文字列のid属性、arenaの数値識別子、描画命令に出る対象を区別します。名前が同じという理由だけで、それらが同じ役割を持つと考えないようにします。
style・layout・描画命令は違う出力を持つ
styleは、セレクターと属性などから、対応範囲の色や寸法などを求めます。layoutは、その結果と内容を使って箱の位置や大きさを計算します。display listは、どの矩形や文字列をどの順に描くかを表します。属性の変更で色だけが変わる場合と、文字列が長くなって配置に影響する場合を比べると、どの段階が変化したかを見分けやすくなります。
この小さなレンダラーを一般のブラウザと同じ組版やCSSの完全実装として扱わないでください。利用できる属性やCSSの規則は、配布コードの対象範囲に限られます。また、毎回再計算する構成でも再描画の因果関係は学べますが、それを増分再計算の最適化だと呼ぶことはできません。正しさの流れを確認した後で、不要な再計算を減らす設計を別の課題として考えます。
手計算トレース:クリック後に何が変わるか
初期状態でstatus要素にReadyと表示され、クリック用の名前付き関数が登録されているとします。配送されたclickが関数を呼び、textContentをDoneへ変え、その後に描画パイプラインが新しい内容を読みます。表では変化が起きる境界を分けています。イベントが届いたことと、描画命令の文字列が変わったことは別の観測です。途中の段階を飛ばして原因を推測しないようにします。
手計算では対象の数値識別子を一つ決め、各段階で同じ要素へ戻れるかを確認します。文字列が短くなる例だけでなく長くなる例も用意すると、古いlayoutを使い続けている問題を見つけやすくなります。表の文字列や幅は実測ログの固定値ではなく、因果関係を整理するための入力例です。実際の位置や寸法は、配布レンダラーの規則と返された結果で判断してください。
| 段階 | 読むもの | 観測する変化 |
|---|---|---|
| 配送 | 対象識別子とリスナー | 名前付き関数の呼び出し |
| 変更 | 同じarenaのstatus | Ready → Done |
| 再計算 | 更新後のDOMとCSS | styleとlayout |
| 描画 | 更新後の表示命令 | 新しい文字列を表示 |
変更がない場合と失敗した場合を分ける
正常系では、存在する要素の文字列と対応する属性を変更します。境界では同じ値をもう一度設定し、見た目が変わらなくてもハンドラーが実行されたかをトレースで調べます。失敗系では存在しない要素を参照したり、対応していない操作を使ったりします。画面が変わらないという共通の症状だけで、これらを同じ問題にしてはいけません。
画面が変わらない原因には、イベントの対象間違い、リスナー未登録、関数内の失敗、DOM更新後の再計算不足、表示側の古い結果の利用があります。最初にRustのDOMの値を確認し、次にstyleとlayout、最後に表示命令を比較する順序が有効です。途中で診断があった場合は、どの変更まで完了したかを確かめます。実行全体が自動的に巻き戻ると考えず、残っている状態を根拠に判断します。
実行できるRust:同じ対象から新しい描画を作る
次のコードは、同じノードの内容を変え、新しい描画情報を作る独立したホスト用Rustです。幅は一文字8という人工的な規則であり、配布ブラウザの実際の文字計測やWeb標準の組版を表しません。この仮定を明示することで、ノードの同一性、古い表示情報、新しい表示情報の関係だけを検査できます。複雑な描画処理の正しさを、この短い例だけで保証したことにはなりません。
変更前のDrawは値として保存され、新しいNodeの内容を変更しても自動更新されません。renderをもう一度呼んで新しいDrawを作ります。識別子が同じで、幅と色が変わり、同じ状態からの再計算が同じ結果になることをassertで確認します。この三点を実際のトレースでも調べると、対象の取り違え、再計算漏れ、不要な非決定性を別々の問題として説明できます。
#[derive(Clone)]
struct Node { id: u32, text: String, color: &'static str }
#[derive(Debug, PartialEq)]
struct Draw { id: u32, text: String, width: usize, color: &'static str }
fn render(n: &Node) -> Draw {
Draw { id: n.id, text: n.text.clone(), width: n.text.chars().count() * 8,
color: n.color }
}
fn main() {
let mut node = Node { id: 7, text: "Hi".into(), color: "black" };
let before = render(&node);
node.text = "Hello".into(); node.color = "red";
let after = render(&node);
assert_eq!(before.id, after.id);
assert_eq!((before.width, after.width), (16,40));
assert_eq!(after.color, "red");
assert_eq!(render(&node), after);
println!("node={} width:{}->{} color={}", after.id, before.width, after.width, after.color);
}CLIとWASMの結果を同じ入力で比較する
CLIとWASMの比較では、HTML、CSS、JavaScript、イベント列をすべて同じにします。見た目のスクリーンショットだけでなく、Rustが返す構造化された結果を比べます。UIの文字サイズや余白が異なっても、教材のDOMや表示命令が同じかを調べれば、処理系の計算と周囲の見せ方を分離できます。入力を片方だけ少し変更した比較では、結果の差の原因を確定できません。
イベント列の途中経過を調べるときは、短い接頭辞を使います。一件目までの列、二件目までの列という形で実行し、それぞれの結果を比較します。長いトレースをただ眺めるより、変更を起こした最小のイベントを特定できます。ただし毎回初期状態から再実行する接頭辞の比較であることを記録してください。保存された画面を引き継いで実行した結果だと説明すると、再現条件が変わってしまいます。
演習:変更前後の四つの証拠をそろえる
演習では、クリックで短い文字列を長い文字列へ変え、対応する属性も一つ変える入力を作ります。実行前にイベントの呼び出し順、DOMの新しい内容、styleの変化、layoutまたは描画命令の変化を予測してください。次に実際の結果から四つの証拠を集め、対象識別子を使って対応づけます。幅が変わると予測した場合は、どの実装規則からそう考えたかも記録します。
対照として、同じ値の再設定、存在しない対象、イベントなしの入力を用意します。すべてについて「画面が変わったか」だけでなく、「どの段階が実行され、どの状態が変わったか」を記述してください。発展課題では、最終DOMが同じになる二つのイベント列を作り、最終表示の一致と途中のトレースの違いを説明します。最終結果と実行経路を分けて考えることが、再描画を理解する仕上げになります。