makepad-2.0-events

makepad-2.0-events 技能概覽

makepad-2.0-events 的用途

makepad-2.0-events 技能是用來處理 Makepad 2.0 的事件與動作流程，避免你在 callback 形狀、state 流向或 render 時機上靠猜。當你需要把 Splash 裡的 UI 互動接到 Rust 端邏輯，或是在除錯「為什麼事件沒有觸發、沒有往下傳、或沒有更新畫面」時，這個技能特別有用。

適合誰使用

如果你正在開發或維護 Makepad 前端 UI，尤其是依賴 on_click、on_render、on_return、on_startup、MatchEvent 或 script_eval! 的元件式應用，就很適合使用 makepad-2.0-events 技能。它也很適合 Frontend Development 類工作，難點不只是語法，而是要判斷邏輯該放在 Splash、Rust，還是兩者之間的橋接層。

它的不同之處

這個技能的核心是 Makepad 的雙層模型：用內嵌 Splash handler 處理局部 UI 行為，用 Rust 的 event matching 負責更廣泛的應用邏輯、非同步工作與外部 state。這種分層正是要不要採用它的關鍵。如果你只是想要一個通用提示來「處理事件」，很容易漏掉 Makepad 專屬規則；這個技能能幫你選對層級，並且正確串接。

如何使用 makepad-2.0-events 技能

安裝與先讀路徑

先用該目錄一貫的 skill 指令安裝 makepad-2.0-events 技能，接著先開 SKILL.md，再看 references/event-patterns.md。對這個 repo 來說，這兩個檔案是最快把 makepad-2.0-events usage 變成可用做法的路徑，因為 reference 檔裡有可直接套用、也可改寫的實作範例，不必從頭重寫事件程式碼。

把粗略目標轉成可用提示

想要效果最好，請描述三件事：widget 或事件來源、你預期的 state 變化、以及更新應該發生在哪裡。弱一點的需求會是「讓按鈕能動」。更強的提示則像是：「使用 makepad-2.0-events，把 Splash 裡的 Button click 串到 state.counter 更新，然後透過 script_eval! 和 .render() 重新刷新標籤。」這樣技能才有足夠結構去判斷要用 inline handler、Rust matching，還是 runtime patching。

在 repo 裡該先看什麼

先看 references/event-patterns.md，那裡有完整流程，例如按鈕 click、startup render，以及由 state 驅動的 UI refresh。接著再看 SKILL.md 裡的 event 章節，確認 handler 名稱、bridge macros 與 scope 邊界。如果你要把範例改成自己的 app，先搜尋最接近的既有 event path，再動手，不要急著自己發明新的流程。

實務使用建議

優先保留最小可完成的事件鏈：事件來源、handler、state mutation、re-render。在 Makepad 2.0 裡，採用上的問題通常不是事件本身，而是邏輯放錯層，或 state 改完後忘了 render。當你用 makepad-2.0-events 技能做 Frontend Development 時，提示要明確寫清楚：回應應該留在 Splash、搬到 Rust，還是透過 script_eval! 或 script_apply_eval! 跨橋處理。

makepad-2.0-events 技能 FAQ

這只適用於 Makepad 2.0 的 UI 事件嗎？

是的。makepad-2.0-events 技能是專門針對 Makepad 2.0 的事件與動作處理，不是通用前端事件系統。如果你用的是 React、Vue 或其他框架，概念上可能有參考價值，但程式碼不會直接沿用。

使用前需要先懂 Makepad 嗎？

有基本 Makepad 基礎會更好，但如果你正在學框架、又需要一份可直接安裝使用的事件流程指南，這個技能仍然很實用。特別是在你已經知道 UI 想做什麼，但不確定該寫 on_click、MatchEvent，還是 bridge macro 的時候，它最有幫助。

什麼情況下不該用這個技能？

如果你的任務主要是版面、樣式，或與應用架構無關，就不用優先考慮 makepad-2.0-events。如果問題本身不是事件驅動型，也建議跳過，因為這個技能是為互動處理、callback 行為與 state 更新而優化的。

它比通用提示好在哪裡？

通用提示可以抽象地解釋事件，但 makepad-2.0-events 技能是針對 Makepad 的實際 control flow、命名與程式碼形狀調校過的。當你需要的是可運作的事件路徑，而不只是概念答案時，這點就很重要。

如何改善 makepad-2.0-events 技能

把完整互動路徑交代清楚

最好的 makepad-2.0-events 使用方式，是把事件來源、預期輸出與 state 的擁有者都說明白。例如：「當 TextInput 變更時，在 Splash 更新 state.query，只在 Rust 裡做 debounce，然後重新渲染過濾後的清單。」這比單純說「處理輸入變更」更有效，因為它明確指出邏輯該放哪裡，以及什麼行為才算成功。

把你遇到的失敗模式寫出來

如果是在除錯，請直接點出症狀：callback 沒有觸發、state 有變但 UI 沒更新、或 action 有進到 Rust 但沒有影響 widget tree。這些細節能幫 makepad-2.0-events 技能分辨是 handler 串接、bridge 使用，還是 render 時機出了問題。

從可運作的範例逐步迭代

先用 reference 範例當底，再一次只改一個變數：widget 類型、事件類型，或 state 更新路徑。這樣可以減少猜測，也更容易看出問題到底是語法、scope，還是 lifecycle。對 makepad-2.0-events 來說，這通常是提升輸出品質最快的方式。

直接要求你真正需要的層級

如果你只需要局部 UI 行為，就要求 Splash-only 解法。如果你需要商業邏輯、非同步工作，或外部整合，就要求 Rust 端的 MatchEvent 流程。明確選對層級，是這個技能最重要的品質槓桿，也能避免把不同責任混在一起，產生過度複雜的答案。