LESSON-21 · TOPIC 02

禁止直接修改 prop

能證明 setup 中收到的 prop 是唯讀介面,並以事件請求父層更新資料而非在子層改寫。

code-edit元件輸入、事件與 slot 契約|禁止直接修改 prop本頁只練一個責任

本頁只練什麼

能證明 setup 中收到的 prop 是唯讀介面,並以事件請求父層更新資料而非在子層改寫。

父層重新渲染會覆蓋子層直接修改,資料來源也會變得無法追蹤。

要修改的檔案:files/starter/index.html

定位:先問誰擁有 title,再檢查子層是否對 prop assignment。|依 starter-2 定位,只修改「禁止直接修改 prop」的責任。

任務情境

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

現在的問題

子卡片改了標題,父層下一次更新後又跳回舊文字。

起始狀態:父層 title=原始服務,子層只有讀取與請求按鈕。

完成後要看到

propReadonly=true、requestCount=1、parentValue=新版服務、mutationWarnings=0。

驗收證據:propReadonly=true、requestCount=1、parentValue=新版服務、mutationWarnings=0

何時會用到

子元件提供編輯/選取操作,但來源資料由父層清單或頁面狀態擁有時。

常見混淆:把 prop 複製成本地 ref 會建立另一份狀態,不會自動保持雙向同步。

觀念與最小範例

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

禁止直接修改 prop One-way prop data flow

資料由父層往下給;子層想改時要舉手通知,真正的筆仍在父層手上。

正式說法:Props form a one-way-down binding and are shallow readonly in child setup; state ownership remains in parent, updated through an explicit event boundary.

const props=define/read props;emit('request-update','新版服務');父層 handler 更新 title。

三步完成本主題

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

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

    檔案:files/starter/index.html 定位:先問誰擁有 title,再檢查子層是否對 prop assignment。

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

    預期:能指出「先問誰擁有 title,再檢查子層是否對 prop assignment。」目前的缺口。

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

    卡住先查:確認開啟的是 files/starter/index.html,且定位到 先問誰擁有 title,再檢查子層是否對 prop assignment。。

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

    檔案:files/starter/index.html 定位:先問誰擁有 title,再檢查子層是否對 prop assignment。

    要做:由子元件送出一次更新請求,讀 prop readonly 與父層更新結果。

    預期:propReadonly=true、requestCount=1、parentValue=新版服務、mutationWarnings=0。

    證據:propReadonly=true、requestCount=1、parentValue=新版服務、mutationWarnings=0

    卡住先查:先問誰擁有 title,再檢查子層是否對 prop assignment。

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

    檔案:files/starter/index.html 定位:先問誰擁有 title,再檢查子層是否對 prop assignment。

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

    預期:propReadonly=true、requestCount=1、parentValue=新版服務、mutationWarnings=0。

    證據:propReadonly=true、requestCount=1、parentValue=新版服務、mutationWarnings=0

    卡住先查:先問誰擁有 title,再檢查子層是否對 prop assignment。

觀察示範

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

禁止直接修改 propruntime fixture · read-only demo
本主題示範畫面:

驗收證據

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

提示 1|方向

子層不要直接寫輸入值;改成發出請求。

提示 2|關鍵片段

子層 emit request-update,父層 handler 寫自己的 ref。

提示 3|完整解答與原因

完整解答與原因:setup props 是 readonly;子層只 emit 新值,父層收到一次後更新 owned state,避免直接修改警告與重渲染覆蓋。

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

開始 Starter →回到主題清單