LESSON-21 · TOPIC 03

emits 與 payload 契約

能宣告 select 事件,讓子卡片只送出 serviceId,並由父層驗證事件次數與 payload。

code-edit元件輸入、事件與 slot 契約|emits 與 payload 契約本頁只練一個責任

本頁只練什麼

能宣告 select 事件,讓子卡片只送出 serviceId,並由父層驗證事件次數與 payload。

未命名/未定義 payload 的事件會讓父層依賴整個內部物件,元件重構時容易破壞呼叫方。

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

定位:先固定事件名稱與 payload shape,再檢查 handler。|依 starter-3 定位,只修改「emits 與 payload 契約」的責任。

任務情境

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

現在的問題

點一次按鈕父層執行兩次,或收到 undefined 但不知道是哪個欄位錯。

起始狀態:父層 selectedId 空白、eventCount=0。

完成後要看到

declared=true、eventCount=1、payloadId=service-42。

驗收證據:declared=true、eventCount=1、payloadId=service-42

何時會用到

子元件回報選取、刪除請求或完成操作,父層仍負責狀態時。

常見混淆:元件自訂事件不會像原生 click 一樣向 DOM ancestor bubbling;父層需在元件上監聽。

觀念與最小範例

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

emits 與 payload 契約 Declared component event and payload contract

子元件按鈕只寄一張寫著『選了 service-42』的小紙條,父層決定下一步。

正式說法:Component emits declaration defines outbound custom events; `$emit(name,payload)` dispatches to the parent listener without DOM bubbling semantics。

emits:['select']; emit('select', service.id);父層 @select='handleSelect'。

三步完成本主題

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

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

    檔案:files/starter/main.js 定位:先固定事件名稱與 payload shape,再檢查 handler。

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

    預期:能指出「先固定事件名稱與 payload shape,再檢查 handler。」目前的缺口。

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

    卡住先查:確認開啟的是 files/starter/main.js,且定位到 先固定事件名稱與 payload shape,再檢查 handler。。

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

    檔案:files/starter/main.js 定位:先固定事件名稱與 payload shape,再檢查 handler。

    要做:按一次子卡片 select,驗證宣告存在、父層只收到一次且 id 正確。

    預期:declared=true、eventCount=1、payloadId=service-42。

    證據:declared=true、eventCount=1、payloadId=service-42

    卡住先查:先固定事件名稱與 payload shape,再檢查 handler。

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

    檔案:files/starter/main.js 定位:先固定事件名稱與 payload shape,再檢查 handler。

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

    預期:declared=true、eventCount=1、payloadId=service-42。

    證據:declared=true、eventCount=1、payloadId=service-42

    卡住先查:先固定事件名稱與 payload shape,再檢查 handler。

觀察示範

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

emits 與 payload 契約runtime fixture · read-only demo
本主題示範畫面:

驗收證據

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

提示 1|方向

事件名稱與 payload 都要有明確契約。

提示 2|關鍵片段

宣告 select,子層 emit service-42,父層 listener 計數。

提示 3|完整解答與原因

完整解答與原因:元件宣告 select,按鈕只 emit 一次 serviceId;父層 handler 記錄 id 與次數,使資料方向與 payload 都可驗證。

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

開始 Starter →回到主題清單