到達目標:画面の文字から木の変更へ戻る
ボタンを押して表示がBeforeからAfterへ変わったとき、変化したのはHTMLファイルでしょうか、それとも読み込み後のDOMでしょうか。JavaScriptは通常、すでに作られた文書の要素やテキストへ操作を行います。元の応答本文が同時に書き換わるわけではありません。この章では、要素を特定する、木を変更する、更新が必要な状態を記録する、という三つの段階を分けます。前提は第1弾のDOM構築と、関数・束縛の基本です。到達点は、文字が変わったという最終結果から、操作対象のノードと親子関係の変化を説明できることです。
教材のDOMとイベントのデモでは、DOMをページ本体とは別のデータとして保持します。入力は型の決まった操作へ変換され、利用者が書いた文字列を実ページへ挿入しません。木の表示、現在の参照、変わったノード、後段の更新対象を並べて確認してください。入力の文字が画面に見えても、それをHTMLとして実行したことにはなりません。概念模型の出力と、実ブラウザの文書を直接変更する操作を区別するのが、この実験の境界です。
IDで探すことと参照を持つことは違う
querySelectorのような検索は、その時点の木と条件から要素を選びます。得た参照は、同じ見た目の別要素を毎回探し直すための名前ではなく、あるノードを指します。検索時に該当要素がなければnullになるため、操作へ進む前に結果を確認します。教材ではID・タグ・classの限定した検索を扱い、複雑なCSSセレクタへ対応したようには見せません。同じタグが複数ある例では、どれが選ばれたかを木の位置で確かめます。
要素を木から外しても、変数などから参照されていれば、そのノードが即座に存在しなくなるとは限りません。文書に接続されているかと、プログラムから参照できるかは別です。また、HTML上のid属性と、模型がノードを識別する内部IDを同一視しません。属性を書き換えても同じノードとして追跡できるよう、木の同一性は安定した識別子で表します。検索の失敗を、別の似たノードへの操作で勝手に補うことはしません。
追加は親と子の両側を更新する
createElementで作った要素は、まだ文書の子とは限りません。appendChildなどで追加するとき、親の子一覧に現れることと、子の親参照がその親を指すことの両方を一致させます。既存のノードを別の親へ追加すれば、通常は複製ではなく移動になります。旧親から外す処理を忘れると、一つのノードが二つの親に属する不正な模型になります。祖先を自分の子へ追加するような循環も、変更を始める前に拒否します。
| 操作 | 変更前 | 変更後 |
|---|---|---|
| create new | ノードがない | 親を持たないnewができる |
| append root,new | rootの子はlabel | rootの子はlabel,new |
| text label,After | labelの文字はBefore | labelの文字はAfter |
| 循環する追加 | rootが祖先 | 拒否し、元の木を保つ |
textContentは表示文字の一部だけとは限らない
要素のtextContentへ文字列を代入すると、その要素の子を置き換えるため、入れ子のspanやその下のテキストが外れることがあります。ボタンの中の数値だけを変えたいのに、ボタン全体へ代入すると、アイコン用の子要素も消えるという失敗が起こります。テキストを持つ適切な要素へ参照を絞るか、必要なテキストノードだけを更新する設計にします。模型で要素のtextという簡略フィールドを使う場合も、実DOMの子の置換を省略した表現だと理解してください。
空文字の代入、存在しない対象、同じ値の再設定を比べると、何を更新と数えるかが明確になります。空文字は有効な結果ですが、対象が見つからないことは別の失敗です。同じ文字列へ設定した場合に描画がどこまで省略されるかは実装次第なので、教材では木の変更と更新対象の記録を先に定義します。DOMが変わったことから、毎回すべてのレイアウトがやり直されたと飛躍しないよう、後段のdirty状態と分けます。
実装例:一つの親と循環しない木を守る
次のコードはDOMそのものではなく、親と子を両側で持つ小さな木の実装です。ノード作成、rootへの追加、labelの文字変更を行います。最後にrootをnewの子へ移そうとすると循環するため、変更前に拒否します。出力はlabel,new Afterです。このモデルのtextは子テキストを省略した値であり、HTMLパーサやtextContent全体の実装ではありません。何を省略したコードかを明確にすると、不変条件を試す小例として使えます。
追加処理が例外を返す直前に、旧親の子一覧をすでに書き換えていたらどうなるでしょうか。循環の検査を先に済ませ、更新を始めてから新しい失敗条件を発見しない順序にすることで、拒否後も元の木を保てます。実用的な実装では同じ親への移動や順序指定も必要になります。まず不正入力で木が半分だけ変更されないことを確かめ、それから対応する操作を増やします。
const nodes = new Map([
['root', {id: 'root', parent: null, children: ['label'], text: ''}],
['label', {id: 'label', parent: 'root', children: [], text: 'Before'}]
]);
function append(parentId, childId) {
const parent = nodes.get(parentId), child = nodes.get(childId);
if (!parent || !child) throw new Error('missing node');
for (let p = parent; p; p = nodes.get(p.parent)) {
if (p.id === child.id) throw new Error('cycle');
}
if (child.parent) {
const old = nodes.get(child.parent);
old.children = old.children.filter(id => id !== child.id);
}
parent.children.push(childId);
child.parent = parentId;
}
nodes.set('new', {id: 'new', parent: null, children: [], text: 'Added'});
append('root', 'new');
nodes.get('label').text = 'After';
console.assert(nodes.get('root').children.join(',') === 'label,new');
console.assert(nodes.get('label').text === 'After');
let rejected = false;
try { append('new', 'root'); } catch { rejected = true; }
console.assert(rejected && nodes.get('root').parent === null);
console.log(nodes.get('root').children.join(','), nodes.get('label').text);変更した木と表示済みの画面を分ける
DOM操作が完了した直後でも、画面の描画がすでに終わっているとは限りません。木の変更をもとにスタイルや配置、描画の更新が必要かを判断します。テキストの長さが変われば配置へ影響することがあり、色だけの変更とは同じ分類になりません。後のイベントループでは、現在のDOM、計算済みの配置、表示済みの画面を分けて観察します。DOMを読む処理が返る時点と、利用者が新しいピクセルを見る時点を分ければ、非同期処理や描画機会の説明もつながります。
更新対象は、単に変更したノードIDの一覧だけでは足りない場合があります。子の大きさの変更が親や後続要素の位置へ影響するなら、依存関係をたどる必要があります。今回の教材では固定した小さな木と更新規則に限定します。局所的な変更から必ず全ページ再計算になる、とも、変更した一ノードだけで必ず終わる、とも一般化せず、模型の規則でどこまでdirtyを広げたかを確認します。
演習:更新する対象を最小の要素へ絞る
DOMとイベントのデモで、ボタン全体を更新してしまう操作を、目的のラベルだけへ届くよう修正します。まず発火対象と更新対象が同じとは限らないことを確認してください。修正後はラベルの文字を変えた場合、似たclassの別要素がある場合、対象が見つからない場合を試します。成功例では目的の文字が変わり、兄弟や親の関係が保たれ、失敗例では別の要素を勝手に書き換えないことを確認します。
ノートには、検索条件、選ばれた内部ノードID、変更前後の子一覧、更新対象を残します。次に同じノードを別の親へ移し、以前に取得した参照がどのノードを指すかを説明してください。削除と参照消失、移動と複製、DOM更新と描画完了をそれぞれ区別できれば、次章のイベントでtargetとcurrentTargetを読み分ける準備が整います。再実行では前回の木を持ち越さず、同じ初期入力から同じ状態列を得られることも検査します。