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。...
