v0.6.22

響應式資料

最後更新


本頁說明 app.data 如何偵測變更、何時觸發重新渲染,以及哪些寫法不會觸發。

運作方式


data 選項會被 createReactiveObject 以 Proxy 遞迴包裝:讀取巢狀物件時回傳新的 Proxy,寫入時若新值與舊值不同(!==)就通知生命週期排程更新。
  1. <div id="app">
  2. <p>{{ count }} · {{ user.name }} · {{ LENGTH(items) }}</p>
  3. <button @click="update">Update</button>
  4. </div>
  5. <script>
  6. const app = new QUI({
  7. id: "app",
  8. data: { count: 0, user: { name: "Pardn" }, items: [] },
  9. event: {
  10. update: () => {
  11. app.data.count++;
  12. app.data.user.name = "Chiu";
  13. app.data.items.push("A");
  14. },
  15. },
  16. when: {
  17. updated: () => console.log("updated", app.data.count),
  18. },
  19. });
  20. </script>
即時預覽 · @pardnchiu/quickui@0.6.22

三行寫入都會觸發更新;300 ms 內的多次寫入合併為一次渲染。

觸發條件


寫法是否觸發
app.data.key = value(值改變)是
巢狀屬性、陣列索引、push / splice是
寫入相同的值否
delete app.data.key否,Proxy 沒有攔截刪除
app.data = { ... } 整個取代否,取代後的物件不是 Proxy
once: true否,資料不包 Proxy,只渲染一次

存取時機


app.data 在 i18n 載入完成後才指派,即使沒有設定 i18n 也會延後到下一個 microtask。在 new QUI() 之後同步寫入的值會寫到暫存物件而遺失;請在 rendered 鉤子 或事件處理函式中讀寫。

模板取值規則


規則說明
路徑以 . 存取巢狀值,例如 {{ user.name }}
作用域先找目前 :for 項目的資料,找不到再找根資料
找不到值{{ }} 原樣保留在畫面上
可用型別字串、數字、布林、陣列、純物件;函式與 Date 會在快照時遺失
EN