Vue watchEffect在await後讀取欄位,為何改值卻沒更新?
切換選單後,Vue畫面上的選項已變,載入內容卻停在第一次?如果你把資料讀取寫在watchEffect(async () => ...)裡,先看那個欄位是在第一個await之前還是之後讀取。watchEffect會自動追蹤同步執行時讀到的響應式資料;非同步函式恢復後才讀到的值,不會因此成為它的依賴。 先做一個沒有網路請求的小例子 下面用Vue 3的Composition API。把程式放到元件的<script setup>,開啟瀏覽器Console;這裡的Promise.resolve()只用來跨過非同步界線,沒有呼叫外部服務。 import { ref, watchEffect, nextTick } from 'vue' const section = ref('首頁') watchEffect(async () => { await Promise.resolve() console.log('讀取內容:', section.value) }) // 等第一次回呼完成後,再模擬使用者切換。 async function testSwitch() { await nextTick() section.value = '商品頁' await nextTick() } void testSwitch() 這段只會印出一次「讀取內容:首頁」。雖然section.value確實改為「商品頁」,回呼內對它的第一次讀取已在await之後,因此這個watchEffect沒有追蹤它。不要只因為函式裡出現了欄位名稱,就認定它已被監看。 把需要追蹤的值先讀出來 先在同步部分取得值,再把這次的值交給後續工作。同一個元件測試時,請用下面整段替換上面的例子,避免同時建立兩個回呼。 import { ref, watchEffect, nextTick } from 'vue' const section = ref('首頁') watchEffect(async () => { const selectedSection = section.value await Promise.resolve() console.log('讀取內容:', selectedSection) }) async function testSwitch() { await nextTick()...
Vue清單要聚焦某筆欄位:用function refs按ID找元素
清單重新排序後,程式用ref陣列的第幾個元素聚焦,結果跳到另一筆輸入欄位。先分清資料ID與DOM陣列位置。Vue官方template refs文件提醒,v-for產生的ref陣列不保證與來源陣列順序相同;不要把某個位置當成穩定的資料識別。 需要聚焦指定項目時,可使用function ref,在元素建立時按ID存進Map,卸載時移除。這讓查找以「哪一筆」為主,而不是猜它現在在第幾個位置。本文處理元素查找,不改清單資料或輸入保存。 key與ref負責不同事情 key讓Vue辨認列表節點;ref則讓程式取得元素或元件參照。清單有穩定key,並不表示你可以把ref陣列任意索引,當作與資料永遠一對一的查找表。 下面每個項目都有數字ID,輸入是實際DOM元素。function ref收到元素時保存;收到null時代表對應參照需要移除。 <script setup> import { ref } from 'vue' const items = ref([{ id: 1 }, { id: 2 }, { id: 3 }]) const fields = new Map() function setField(id, element) { if (element) fields.set(id, element) else fields.delete(id) } function focusField(id) { fields.get(id)?.focus() } </script> <template> <input v-for="item in items" :key="item.id" :ref="element => setField(item.id, element)"> <button @click="focusField(2)">聚焦第二筆ID</button> </template> Map不是拿來顯示資料的響應式來源,只做這份元件內的元素查找。按鈕傳的是ID2,不是陣列索引2;即使清單位置變了,仍以同一個識別找對應輸入。項目的ID需要唯一且穩定,不應每次排序就重新編號。 如果Map的key用數字,外部輸入卻傳字串2,兩者不相等。先保持資料契約一致,或在適當入口明確驗證與轉型,不要在查不到元素時再猜是不是ref失效。記錄合成ID的型別,往往能快速排除這種差異。 卸載時收到null要刪除 function ref不只在建立元素時收到值,元素卸載時也會收到null。若只set、不delete,Map可能留下已經離開DOM的元素。之後再按聚焦,程式還拿得到舊參照,卻不能達成目前畫面上的操作。 清理分支應與建立分支放在同一個小函式,讓生命週期責任清楚。不要把舊元素永久留在全域Map,直到下一次開頁才重設。若一筆資料被刪除,它在查找表裡也應消失。 注意刪掉Map項目,不代表從來源資料刪掉項目。這兩個動作是資料層與DOM參照層的各自工作。範例的setField只更新元素查找,真正移除一筆仍由items的變動觸發渲染。 真清單重排後,仍按ID聚焦 本文案例使用Vue3.5.43與真Chromium,起始ID為1、2、3。按反轉後,實際輸入順序是3、2、1;接著按聚焦ID2,活動元素仍是ID2。沒有把反轉後位置硬寫成某個陣列索引。 再把ID2從來源移除,Map的key只剩1與3;接著聚焦ID3,活動元素為3。這兩項一起核對了查找與null卸載清理,不是只看第一次建立時Map裡有三個元素。 讀者可以在測試清單為input加 data-id,用開發者工具查看活動元素。測試不需接資料庫或真表單提交;先把ID到DOM的對應核清楚,再接回編輯錯誤提示或快捷聚焦功能。 本文的Map清理觀察來自本地列表移除,不包括其他自訂元件的生命週期。若ref指向的是子元件而非input,取得的是元件參照,可用介面也會不同;不能直接對任何元件ref都呼叫DOM focus。...
Vue卡片內按按鈕也觸發外層:click stop阻止冒泡
按收藏按鈕時,卡片的開啟動作也一起執行。先看按鈕是否放在有click監聽的父元素裡。DOM的點擊事件通常會往父層傳播,內層按鈕的處理函式完成後,外層仍可能接到同一個事件。 如果希望這顆按鈕單獨執行,可以在Vue模板用 @click.stop停止事件傳播。這和取消連結的預設導覽不是同一件事;也和子元件emit的事件不同。先分清這次是DOM點擊往外傳,才能加在真正需要的地方。 先用計數看兩個處理函式 以下只示範事件範圍:外層增加卡片次數,內層增加按鈕次數。它不是完整的可存取卡片設計,也沒有真的開商品頁或保存收藏。 <script setup> import { ref } from 'vue' const cardHits = ref(0) const buttonHits = ref(0) </script> <template> <div @click="cardHits++"> <button @click="buttonHits++">收藏</button> </div> <p>{{ cardHits }} / {{ buttonHits }}</p> </template> 點內層按鈕後,兩個計數都可能加一。因為這是同一個點擊先抵達按鈕,再沿DOM父層繼續傳播,不需要第二次真的點到外層。若卡片處理函式做導覽,使用者就會覺得自己只是按收藏,卻被帶走。 查修時從實際按鈕往上看DOM父層,不只看Vue元件名稱。元件模板形成的實際巢狀結構,才決定DOM事件會通過哪些元素。樣式看起來是並排,不代表DOM裡不是父子關係。 只在要獨立處理的按鈕stop 把內層監聽加上stop,Vue會替這個處理流程呼叫相應的事件傳播停止方法。外層普通冒泡click不再因為同一個點擊執行。 <div @click="cardHits++"> <button @click.stop="buttonHits++">收藏</button> </div> 這讓卡片其他地方仍可以執行原本的click,而收藏按鈕只做自己的事。不要在每個子元素都加stop,讓原本想由卡片統一處理的互動也全部被截斷。先畫出這次事件應走到哪一層,再選擇停止點。 如果需要在處理函式中判斷後才停止,也可以取得事件再呼叫 event.stopPropagation()。模板修飾符適合無條件停止的簡單情況;需要依資料條件決定時,函式內處理可能更清楚。兩種寫法應讓維護者看得出條件,不要重複堆疊卻不知道哪個生效。 真點擊比較內外次數 本文用Vue3.5.43與真Chromium,建立兩份相同的巢狀按鈕。一份沒有stop,一份有stop。點第一份按鈕後,內層1、外層1;點第二份後,內層1、外層0。 這份結果證明本例的普通冒泡click被停止,不包含真收藏API或真導覽成功。測自己的卡片時,可以先用相同計數替代業務動作,確認事件範圍,再接回保存與導覽。這樣能避免每次測都觸發正式工作。 修正後還要點卡片其他可操作位置,確認外層原功能仍存在。只測內層不觸發外層,可能漏掉你把整張卡片都改成不會執行的錯誤。內層單獨與外層按預期工作,是兩個都需要成立的結果。 stop不等於prevent stopPropagation()停止事件繼續沿傳播路徑走,不會自動取消該元素的預設行為。preventDefault()則是取消可被取消的預設動作,例如某些連結導覽,卻不會因此阻止事件冒泡。MDN對這兩個API有明確區分。 在Vue裡,.prevent也不能當成.stop的替代。若你要同時阻止傳播與預設動作,可以按這個互動的實際需求組合修飾符;但不要因為看到兩個都叫阻止,就把所有click都寫成stop.prevent。 本文按鈕放在普通div內,主題是事件傳播,沒有連結預設導覽,所以只測stop。若真頁卡片是一個連結,而按鈕又嵌在裡面,除了修飾符還要核HTML結構是否合理。更清楚的設計往往是讓主要連結與次要按鈕各有自己的可操作區域,而不是靠大量阻止事件維持巢狀互動。 capture與self的用途也不同 父層若用捕獲階段監聽,可能在事件到達內層前已經執行。本文的外層是普通冒泡click,不把內層stop推成能回到過去取消所有已經發生的父層處理。若測試與預期不同,查是否有capture監聽或其他全域事件流程。 Vue的 .self要求事件來源就是目前元素,常用來讓背景本身的點擊觸發、忽略子元素來源。這與在特定按鈕上stop的範圍不同:self會對父層收到的來源做篩選,stop則讓那次事件不再繼續傳播。按你真正要保留的互動選,而不是把修飾符當作同義詞。 事件修飾符的排列也會影響生成的處理順序。需要組合時,按Vue官方事件指南理解每一個動作,再用小例子驗證。不要把別處的複合寫法整段貼過來,只因為它曾經讓某個按鈕不跳頁。 元件emit沒有DOM冒泡那條路 如果父元件收到的是子元件 emit('save'),這是Vue元件事件,不是DOM click沿父元素冒泡。元件事件本來就不會自動一路冒泡到所有祖先。這時要查父模板的事件綁定與子元件發出的名稱,不是到處加click.stop。 某個子元件可能同時包含原生按鈕與emit邏輯,兩層都存在,容易混淆。先確認父處理函式由哪一種事件觸發,再選合適修法。原生click停止了,不代表子元件沒有主動emit另一個業務事件。 如果發現一次按鈕操作保存兩次,也要查是否原生click與元件事件各呼叫同一個保存函式。stop只能處理DOM傳播,不能替你去除重複的業務綁定。計數例子能協助定位,但最後仍要把真正觸發鏈看清楚。 從最小事件範圍修起 先在內層加stop,核內外計數,再測卡片其餘入口。接回業務功能時,保存失敗、導覽與鍵盤操作仍依自己的UI需求驗證。不要為了防止一次冒泡,把原本的按鈕換成沒有語意的文字元素。 如果卡片本來就有多個獨立動作,最好讓DOM結構也清楚表達這些入口。事件修飾符能精確控制某次傳播,但不能取代整張卡片的操作設計。讓每個入口的目的與處理函式對上,比全面截斷所有事件更容易維護。 stopPropagation也不會取消同一個元素上其他已註冊的事件處理。若同一按鈕還被另一段程式綁定,按一次仍可能看到額外動作;這不是外層冒泡問題。先查相同元素的監聽來源,別一直往父層加stop。需要管理多個監聽時,讓註冊與解除位置明確,避免元件重建後重複綁定。本文的真案例每個按鈕只有一個內層處理函式,沒有推成所有外掛監聽都已排除。 參考資料 Vue事件修飾 MDN stopPropagation MDN preventDefault MDN事件冒泡 Vue元件事件
Vue收合再打開輸入不見:v-if與v-show保留狀態差別
設定面板輸入了一段文字,收合再打開卻變空白。先看收合條件用了 v-if還是 v-show,再確認文字狀態放在哪個元件。v-if不顯示時會拆掉對應內容;如果輸入草稿只存在子元件本地,重新建立子元件就會重新初始化。 v-show主要切換CSS display,內容仍留在DOM裡。這讓同一個子元件可以保留本地輸入,但也代表它只是不可見,並沒有卸載。選哪一種,不是看名字哪個較好,而是看你希望收合時保留還是重建這份狀態。 先把草稿放在子元件本地 以下DraftField每次建立時,把文字初始化為空。沒有把v-model綁到父頁來源,因此能看清子元件生命週期對本地草稿的影響。 <!-- DraftField.vue --> <script setup> import { ref } from 'vue' const draft = ref('') </script> <template> <input v-model="draft" aria-label="測試草稿"> </template> 如果你的表單草稿其實在父元件,子元件拆掉後父ref仍存在,就可能重新把原文字傳回來。這時文字保持,不代表v-if沒有卸載子元件。要比較元件本地狀態,就像此例一樣讓兩份草稿各自存在自己的子元件裡。 測試時不要把兩個輸入都綁同一個父頁變數。那樣其中一個改值,另一個也顯示相同文字,收合後重建又拿到父值;你會測到父來源共享,而不是v-if與v-show的差別。 同一個子元件,兩個獨立開關 父頁分別控制兩份DraftField。一個用v-if,一個用v-show,初始都顯示。按鈕只是切換開關,不清除或保存文字。 <script setup> import { ref } from 'vue' import DraftField from './DraftField.vue' const ifOpen = ref(true) const showOpen = ref(true) </script> <template> <button @click="ifOpen = !ifOpen">切換if</button> <DraftField v-if="ifOpen" /> <button @click="showOpen = !showOpen">切換show</button> <DraftField v-show="showOpen" /> </template> 兩個開關是不同狀態,所以操作其中一個不應順便改另一個。先在各輸入打Keep,分別收合,再重新開啟。若程式另有重設功能,先不要接進此案例,避免把主動清空與生命週期造成的初始化混在一起。 看DOM、文字與掛載次數 本文使用Vue3.5.43與真Chromium操作。收合後,v-if對應輸入的DOM數量是0;v-show對應輸入仍有1個,但不可見。重新開啟後,if那份文字變成空字串,show那份仍是Keep。 案例也記錄子元件的mounted次數:if為2,show為1。這與DOM和文字一起說明前者建立了新的子元件,後者保留原元件。不是只從「看不到」推測發生哪種操作,而是直接核對元素存在與生命週期。 讀者可以在DraftField的onMounted加一個測試計數,或觀察瀏覽器DOM。這些只是本地合成草稿的比較,不代表真表單資料已保存。收合後文字仍在畫面來源裡,也不能當成伺服器已經收到它。 如果測到兩者都保持文字,先查草稿是否其實在父層、是否有從props重新載入、是否用了其他快取機制。若兩者都變空,則查按鈕或watcher是否主動清空。保留最小例子,才能把額外邏輯的影響分開。 v-show保留狀態,也保留元件的存在 面板不顯示時,v-show不等於元件停止所有工作。元件仍掛載,計時器、watcher或外部訂閱是否繼續運作,取決於你的實作。需要收合時暫停工作,就按開關條件管理,不要只靠display none。 例如一個定時重新查資料的面板,文字需要保留,但收合時不想發請求,可以保留元件,同時讓請求流程讀取面板是否開啟。這是工作是否繼續的需求,與DOM是否拆掉不同。本文沒有測網路或計時器,只提醒不要把兩者當成同一個開關。 相對地,v-if切走會卸載對應子元件,但元件內若建立了需要自行清理的外部資源,也應在適當卸載流程處理。不能把「用了v-if」當成每個自己建立的計時器都自動清掉的保證。...
Vue計算排序後原清單也變:先複製陣列再sort
商品頁一邊顯示原始順序,一邊用computed顯示低價優先。讀取排序清單後,原始清單卻也被排過了。先看getter裡是否直接對來源呼叫 sort()。JavaScript的sort會修改原陣列,不會替你建立一份只供顯示的新清單。 computed用來表達衍生值,getter應避免改來源。只需要排序展示時,先複製陣列再排序;這樣兩份清單可以共用項目資料,卻保留各自的排列。本文專門處理排序造成的來源修改,不調整清單key或商品保存功能。 sort的回傳值仍是原陣列 容易出問題的寫法很短,因而不一定會被注意。getter回傳了排序結果,但排序同時已經作用到items.value。 const items = ref([3, 1, 2]) const sorted = computed(() => items.value.sort((a, b) => a - b)) console.log(sorted.value) console.log(items.value) 這裡的sort不是純計算。computed第一次被讀取時,getter才執行,原清單也就被排成1、2、3。只看宣告sorted那一行後的來源可能尚未變,等模板讀到它才出現變化,容易讓人誤判是哪個按鈕或元件改了資料。 在同一頁的不同區塊,如果都使用items,排序副作用就可能影響另一個區塊。這不是computed自動把所有列表綁成同一順序,而是你在getter裡修改了它們共用的來源。 複製外層,再對副本排序 對只需要改排列的用途,陣列展開可以建立一份新的外層陣列,再在副本上呼叫sort。 import { ref, computed } from 'vue' const items = ref([3, 1, 2]) const sorted = computed(() => [...items.value].sort((a, b) => a - b)) console.log(sorted.value) // [1, 2, 3] console.log(items.value) // [3, 1, 2] 來源與衍生清單現在有不同的外層陣列。sorted變成1、2、3,不要求items也跟著改。你仍可在一處顯示原順序,在另一處顯示排序結果,不必用watcher反覆把一份資料寫回另一份。 支援 toSorted()的執行環境也可用這個非原地排序方法;它提供排序後的新陣列。若專案的目標瀏覽器或執行環境不支援,使用複製後sort仍是清楚的替代。本文真案例採展開與sort,不把toSorted寫成已在所有讀者裝置驗證。 真案例同時核來源與衍生值 本文使用Vue3.5.43的響應式runtime,分別建立兩個起始為3、1、2的ref。一組在computed直接sort,一組先複製再sort。讀取各自的衍生值後,記錄來源排列。 直接sort的一組,來源從3、1、2變成1、2、3;複製後sort的一組,衍生值是1、2、3,來源仍是3、1、2。這份比較只測本機陣列與getter,不代表網站商品資料、使用者操作或正式UI已完成驗收。 讀者在測試元件中,可用兩段 v-for分別展示items與sorted。先看原始順序,再讓模板讀取sorted,觀察兩份清單是否各自保留預期排列。測試不需要接商品API,也不需要修改正式資料;先把陣列副作用核清楚再接回完整功能。 不要只斷言sorted正確。直接sort與副本sort都能得到同樣排序結果,差別藏在來源是否被改。因此測試需要同時保存來源前後順序。若不希望來源改動,就把來源順序未變也當成必要條件。 數字比較函式不能漏 JavaScript預設sort按字串的比較方式排序。對價格、分數等數字,應提供符合需求的比較函式;不然例如10與2可能不是按你期待的大小排列。本文用 (a, b) => a - b表示數字升序。 若清單是商品物件,就比較實際的數字欄位。資料如果是字串價格、缺值或不同幣別,先依資料契約整理,不能只把兩個欄位相減就假定合理。排序比較與陣列複製是兩件事:複製避免改來源,比較函式決定排列規則。...
Vue改值後讀到舊畫面:nextTick等更新完成
程式把計數改成1,接著立刻讀畫面的文字,結果還是0。資料已經更新,畫面不是每一行JavaScript都立即重畫。Vue會把同一輪變動的DOM更新整理成批次,等更新完成後,讀到的才是新畫面。 這種「資料是新的,DOM還是舊的」很常出現在展開面板後量尺寸、增加清單後捲到最後、或切換顯示條件後要聚焦輸入欄位。若下一步需要Vue剛產生的DOM,先改資料,再 await nextTick(),最後才讀或操作元素。它等的是Vue的更新批次,不是一個任意的延遲秒數。 先用文字看時序,不急著量高度 文字內容是最容易辨認的例子。把下面程式放進自己的Vue3測試元件。頁面起始顯示0,按按鈕後,函式會分別印出資料值、立即讀取的文字,以及等待更新後的文字。 <script setup> import { ref, nextTick } from 'vue' const count = ref(0) const output = ref(null) async function changeAndRead() { count.value = 1 console.log('state', count.value) console.log('immediate DOM', output.value.textContent) await nextTick() console.log('updated DOM', output.value.textContent) } </script> <template> <p ref="output">{{ count }}</p> <button @click="changeAndRead">改值後讀畫面</button> </template> 這個範例使用template ref取得元件自己的元素,避免用全頁query selector找錯同名元素。按鈕是在元件掛載後才能點到,因此元素已存在;如果程式可能在元素還沒建立時呼叫,就仍要處理空ref,不能把nextTick當成任何元素都保證存在。 本文真瀏覽器案例採Vue3.5.43,起始文字0,改值後資料是1、立即DOM仍是0,等待nextTick後DOM變1。這個結果比較的是同一輪函式裡的更新時序;不是說使用者畫面會固定卡住某個毫秒數,也不是每次讀取都能觀察到相同延遲。 重複把count設成已經是1的值,並不是新一次值變更。要重做比較,先重設到0並等待那次更新,或重新載入測試頁。否則看到兩次都是1,就可能誤以為第一次觀察錯了,而其實只是測試輸入沒有改變。 await放在改資料之後 nextTick()回傳Promise,可以await,也可以傳回呼。讀者若原本寫在一般函式裡,記得把函式改為async,再按順序放置;不是把它隨便放在任何一行就會有相同作用。 items.value.push({ id: 3, title: 'new item' }) await nextTick() const last = listElement.value?.lastElementChild last?.scrollIntoView({ block: 'nearest' }) 這是清單範例的操作順序:先讓資料包含新項目,等待Vue把它渲染進DOM,再找到最後一個元素。若列表的實際順序經過排序或篩選,最後元素不一定是剛加入那筆,應按穩定ID定位;nextTick只處理時序,不替你辨認哪個元素對應哪筆資料。 同樣地,先 await nextTick() 再修改items,等待的是前一輪,不能保證後面那次修改的DOM也已完成。看到程式有nextTick就判定「已等更新」不夠,要看它與資料變更、DOM讀取三者的先後位置。 固定setTimeout不是同一種等待...
Vue子元件改props連父頁也變:用emit交回修改
把會員物件傳進編輯卡片後,子元件改了 user.name,父頁的名稱竟然也跟著變。你可能以為props是唯讀,所以子元件裡的修改應該沒有作用;問題是,物件的巢狀欄位與整個prop重新賦值,是不同層的操作。 Vue的props採由父到子的資料流,但傳入物件或陣列時,子元件仍可能經由共用參照修改裡面的內容。較清楚的做法是讓子元件回報「想把名稱改成什麼」,再由父元件決定如何修改來源。這樣畫面是否變動,與誰有責任保存資料,就能分開看。 唯讀prop不等於整棵物件都不能改 以下父頁將 user 傳入子元件。子元件收到的物件仍關聯到父頁持有的來源;直接寫裡面的name,可能讓父頁一起顯示新名稱。 <!-- 子元件的問題寫法 --> <script setup> const props = defineProps({ user: Object }) function rename() { props.user.name = 'Direct' } </script> <template> <button @click="rename">改名稱</button> </template> 這與 props.user = anotherObject 不同。後者重新賦值prop本身,不符合單向資料流;前者改共用物件的巢狀欄位,官方文件說明Vue無法合理地阻止所有這類變動。沒有看見唯讀警告,不代表這個元件的資料修改責任就設計好了。 畫面能同步,是因為資料參照與響應式追蹤,不表示父頁已同意保存。若父頁還有「取消」與「儲存」按鈕,子元件一開始就改來源,取消時可能已經找不回原值。這種錯誤也容易藏在幾個共用同一物件的卡片之間:一處編輯,另一處展示突然提前改變。 子元件回報意圖,父元件處理來源 讓子元件發出名稱,而不是直接改props。事件名稱與參數要能表達這個操作,父元件才能驗證或拒絕它。 <!-- RenameButton.vue --> <script setup> defineProps({ user: Object }) const emit = defineEmits(['rename']) function requestRename() { emit('rename', 'Intent') } </script> <template> <p>{{ user.name }}</p> <button @click="requestRename">提出修改</button> </template> 父頁接到事件,才更新自己的狀態。下面使用 ref持有物件,範例以新物件替換來源,保留其他欄位。這不要求所有父元件都一定替換物件;重點是修改動作發生在來源的擁有者那裡。 <script setup> import { ref } from 'vue' import RenameButton from './RenameButton.vue'...
Vue watch沒看到陣列變動:分清替換與深層監聽
清單畫面已經多了一筆資料,放在 watch 裡的儲存或提示邏輯卻沒有執行。這通常不是 Vue 沒有更新,而是畫面和 watcher 觀察的變動範圍不同。把整個陣列換掉、對原陣列 push、修改某個元素的名稱,對監聽器來說是三件事。 先問這個回呼到底要處理什麼:只要清單被替換就重新載入?只要項目增減就更新摘要?還是每個欄位變更都要儲存?答清楚後再選 deep,比把所有監聽都改成 deep: true 更容易維護。 ref包著陣列,不代表watch會深入每個欄位 本文採 Vue 3 的 Composition API,清單放在一個 ref。下方 watcher 預設監聽這個 ref 的值被替換。push 修改的是原陣列的內容;陣列本身仍是同一個,所以預設 watcher 不會因此執行回呼。 import { ref, watch } from 'vue' const items = ref([{ id: 1, name: 'A' }]) watch(items, () => { console.log('array replaced') }) items.value.push({ id: 2, name: 'B' }) // 原陣列增加元素,預設watch不因此觸發。 items.value = [{ id: 3, name: 'C' }] // ref改指向另一個陣列,會觸發。 畫面若使用 v-for 顯示 items,可以因為響應式陣列變動而更新,並不需要等這個 watcher 執行。不要用「畫面有沒有動」判斷 watcher 的監聽條件,也不要為了回呼而把全部資料反覆重建成新陣列。先改對監聽範圍,再考慮資料更新方式。 Vue 3.5的deep:1可以只看到陣列這一層 如果目標是監聽陣列替換,以及...
Vue解構後畫面不更新:reactive欄位用toRefs保留連動
Vue頁面上有數量與總價。按下加一後,數量在資料物件裡已經改變,畫面上的某個數字卻還停在原值。若你曾把 reactive() 的欄位解構出來,例如 const { count } = state,先查那個變數是不是只取得當時的普通數字。它不會因為來源物件後來更新,就自動變成新數字。 問題不是所有解構都不能用,而是被解構的是什麼、後續讀取走哪條路。本文聚焦Vue 3中reactive物件的基本型別欄位,用1變成2的小例子,比較直接解構、toRefs與computed。元件props解構另有編譯器規則,不能把這個例子的結論不分版本地套到所有寫法。 普通數字不會記住它來自哪個欄位 import { reactive } from 'vue' const state = reactive({ count: 1 }) const { count } = state state.count = 2 console.log(state.count) // 2 console.log(count) // 1 解構時讀到的 count 是1,之後程式更新的是代理物件上的 state.count。兩個讀取位置已分開。普通數字沒有替你保存回到state欄位的路徑,因此後面再讀count仍是1。把const改成let,只讓這個變數能重新指派,不能自動建立與state的連動。 在頁面排查時,先找模板實際使用的名稱。畫面若顯示的是解構出來的count,更新state.count就可能看不出變化;畫面若直接讀state.count,就會使用代理物件。不要只在console列印整個物件,看到物件已更新就假設模板讀的也是同一處。 最小修法是繼續讀state.count 如果元件很小,沒有必要為了少寫state就解構所有欄位。維持同一個reactive物件,事件更新它,模板也讀它,資料來源通常更容易追。以下是數量輸入的小元件,初始數量為1。 <script setup> import { reactive } from 'vue' const state = reactive({ count: 1 }) </script> <template> <button @click="state.count++"> 加一 </button> <p>數量:{{ state.count }}</p> </template> 讀取與更新都沿state.count走,省去額外的同步變數。接上自己的商品頁時,仍要處理數量上限、最小值與送出前驗證;這段只示範畫面連動,不代表購物車、庫存或結帳系統已處理。若元件有多個來源資料,先分清哪些是可編輯狀態,哪些是推導結果。 需要解構時,用toRefs保留欄位路徑 import { reactive, toRefs } from...
Vue搜尋結果晚回來蓋掉新結果:取消舊請求
搜尋框已改成新字詞,畫面卻突然跳回舊結果。請求發出得早,不代表一定先回來;舊請求較慢、新請求較快,若兩個回應都直接寫入同一份結果,最後完成的舊請求就會蓋掉新內容。 要守住最新搜尋,可以在字詞改變時取消舊請求,同時檢查請求序號,讓只有目前這一次能更新結果、錯誤與載入狀態。取消和限制寫入各有作用,不要只處理結果,卻讓舊請求的finally把新查詢的轉圈提早關掉。 先把回應順序放慢,確認真的是舊請求 在自有測試頁,讓old查詢延遲900毫秒,new查詢延遲100毫秒。先輸入old,80毫秒後改成new。new先完成,old後完成;沒有保護的區塊最後顯示old,取消舊請求並核對序號的區塊則保留new。 搜尋已改成new,舊回應仍把這一區改回old。 同樣的請求順序下,修正版只顯示最新查詢。 這是實際Vue 3頁面向自有HTTP測試服務發請求的結果。延遲是為了重現亂序而安排,不是正式搜尋速度。正式網站還要核對API資料、查詢參數與權限,不能把前端顯示new就當成搜尋內容全部正確。 watch清理上一輪請求 下列範例適用已建立的Vue 3單檔元件,放在script setup。query是搜尋字詞,results保存API回傳的items陣列。示例API路徑要換成自己的入口,並依實際JSON欄位調整,不能直接假定所有服務都回items。 import { ref, watch } from 'vue'; const query = ref(''); const results = ref([]); const loading = ref(false); const errorText = ref(''); let latest = 0; watch(query, async (value, oldValue, onCleanup) => { const requestId = ++latest; const controller = new AbortController(); onCleanup(() => controller.abort()); results.value = []; errorText.value = ''; if (!value.trim()) { loading.value = false; return; } loading.value = true; try { const response =...
Vue列表刪掉一行後輸入內容跑位:key不能隨便用索引
列表第二行的備註明明填好了,刪掉第一行後,備註卻出現在另一筆資料旁邊。先看每行的key:如果使用陣列索引,刪除或排序後,同一個位置就可能代表不同資料,元件裡的輸入草稿卻被留在原位置。 key不是用來消除警告的裝飾。它告訴Vue哪些節點或元件仍是同一個項目。列表有輸入框、展開狀態或子元件草稿時,這個身分尤其重要。 用一段備註重現跑位 準備首頁101、分類頁102、聯絡頁103三筆資料,每行各有一個子元件保存備註。左側使用index當key,右側使用item.id。兩邊都在分類頁填「分類頁待修改」,接著刪掉首頁。 在本文Vue 3案例中,index版的分類頁變成空白,備註跑到聯絡頁103;ID版的備註仍跟著分類頁102。兩邊刪除後的資料順序相同,差別是Vue用什麼身分重用子元件。 刪掉首頁後,索引版的草稿仍留在原位置。 同一筆ID仍是同一個元件,分類頁備註留在分類頁。 這是自建Vue頁面的實際桌面操作,不是後台資料已被改寫。案例只保留前端草稿,沒有提交到伺服器;看到輸入跑位,還不能推成資料庫的內容也移到另一筆。 索引會變,資料身分應保持穩定 原本索引0、1、2對應101、102、103。刪除101後,索引0、1改成102、103。若key仍是0、1,原key1的元件就可能被重用來顯示103,並保留它的備註狀態。 <!-- 有輸入草稿的列表,不要用位置代表資料身分 --> <NoteRow v-for="(item, index) in items" :key="index" :item="item" /> <!-- 使用同一筆資料穩定且唯一的ID --> <NoteRow v-for="item in items" :key="item.id" :item="item" /> 同一個列表裡,key應唯一。既有資料通常用後端提供的ID;還沒儲存的新項目,可以在建立資料時產生自己的穩定ID,之後編輯、排序與刪除都保留它。不要每次渲染才重新產生亂數,否則每次更新都像換了一批新元件。 標題不一定適合當key。兩筆文章可能同名,使用者也可能修改名稱;資料本身沒換,只因標題變動就重建元件,輸入狀態可能被清掉。要找的是身分,不是現在看起來不重複的文字。 這個例子的草稿存在子元件 以下以已建立的Vue 3單檔元件專案為前提。先建立NoteRow.vue,把這一段放進該檔;每個元件各自保存note,並使用v-model更新輸入值。 <script setup> import { ref } from 'vue'; defineProps({ item: Object }); const note = ref(''); </script> <template> <label> {{ item.title }}(ID {{ item.id }}) <input v-model="note" placeholder="輸入備註"> </label> </template> 父元件再建立三筆資料,匯入NoteRow。第一段放父元件的script setup,第二段放同一個檔案的template;不是貼進普通HTML就能執行的完整頁面。 import { ref } from 'vue'; import NoteRow from './NoteRow.vue'; const...
