LESSON-16 · TOPIC 03

DocumentFragment

能先在 DocumentFragment 組裝三個節點,再一次加入正式 DOM。

code-edit安全 DOM 查找與可重複渲染|DocumentFragment本頁只練一個責任

本頁只練什麼

能先在 DocumentFragment 組裝三個節點,再一次加入正式 DOM。

把建立與插入分開可讓 render 流程清楚,並避免每筆資料都直接操作 live container。

要修改的檔案:files/starter/main.js

定位:先在 append 前記錄 fragment.childElementCount。|依 starter-3 定位,只修改「DocumentFragment」的責任。

任務情境

先結果,再原理;完成後要能說出自己看見的證據。

現在的問題

render 迴圈同時負責建立與插入,難以檢查中間結果。

起始狀態:空 list 與三筆文字資料。

完成後要看到

fragmentBefore=3、domAfter=3、fragmentAfter=0、appendCalls=1。

驗收證據:fragmentBefore=3、domAfter=3、fragmentAfter=0

何時會用到

從陣列建立多個 DOM 節點並批次提交到容器。

常見混淆:fragment 不是複製節點;append 會移動其 children。

觀念與最小範例

這段程式是理解起點,不是要你直接跳過 Starter。

DocumentFragment Document fragment batch insertion

先在看不見的暫存盒裝好三項,再一次放進畫面。

正式說法:DocumentFragment 是無 parent 的輕量 Document 節點;append 時其 children 會移入目標,fragment 隨後變空。

const fragment=document.createDocumentFragment(); fragment.append(li); list.append(fragment)。

三步完成本主題

每一步都留下可觀察結果;如果沒看到,先看「卡住先查」。

  1. Step 1|先看見目前缺口,不急著貼答案。

    檔案:files/starter/main.js 定位:先在 append 前記錄 fragment.childElementCount。

    要做:先重新載入 Starter,記錄目前畫面、DOM、Computed、Console 或文件內容。

    預期:能指出「先在 append 前記錄 fragment.childElementCount。」目前的缺口。

    證據:保存 files/starter/main.js 的目前狀態,並指出下一步只會修改哪個檔案責任。

    卡住先查:確認開啟的是 files/starter/main.js,且定位到 先在 append 前記錄 fragment.childElementCount。。

  2. Step 2|只修改本主題的一個責任。

    檔案:files/starter/main.js 定位:先在 append 前記錄 fragment.childElementCount。

    要做:把三項加入 fragment,再一次 append 到 list。

    預期:fragmentBefore=3、domAfter=3、fragmentAfter=0、appendCalls=1。

    證據:fragmentBefore=3、domAfter=3、fragmentAfter=0

    卡住先查:先在 append 前記錄 fragment.childElementCount。

  3. Step 3|重新載入並以證據驗收,不以『看起來差不多』判定完成。

    檔案:files/starter/main.js 定位:先在 append 前記錄 fragment.childElementCount。

    要做:重新整理頁面,再逐項比對預期結果與 evidence。

    預期:fragmentBefore=3、domAfter=3、fragmentAfter=0、appendCalls=1。

    證據:fragmentBefore=3、domAfter=3、fragmentAfter=0

    卡住先查:先在 append 前記錄 fragment.childElementCount。

觀察示範

這個示範只讓你看懂概念,不會替你修改 Starter,也不會自動宣告完成。

DocumentFragmentruntime fixture · read-only demo
本主題示範畫面:

    驗收證據

    勾選只是學習紀錄;真正完成仍要回到 Starter 的實際結果。

    提示 1|方向

    迴圈內只填 fragment。

    提示 2|關鍵片段

    迴圈結束才 list.append(fragment)。

    提示 3|完整解答與原因

    完整解答與原因:三個 li 先 append 到 DocumentFragment,最後 list.append(fragment) 一次;children 會移到 list,所以 fragmentAfter=0。

    完成後進入下一階段,或回到入口選下一個 topic。

    開始 Starter →回到主題清單