在使用 UpdatePanel 時,常會遇到一個惱人的問題:非同步回傳完成後,頁面上的捲軸位置跑到頂端,使用者必須重新捲動,體驗因此變差。要解決這個問題,可以透過隱藏控制項保存捲軸位置,再在頁面載入完成後還原。
整體做法很簡單:先用 onscroll 事件保存目前的 scrollTop 值,並用 HiddenField 記錄;回傳完成後,再依這個值重新設定捲軸位置。
首先在需要保存捲軸位置的 div 上加入 onscroll 事件。當使用者捲動時,將該 div 的 scrollTop 寫入 HiddenField。接著在頁面的 load 完成事件中,透過 Sys.WebForms.PageRequestManager 註冊 pageLoaded。當 pageLoaded 觸發時,再從 HiddenField 取出先前保存的值,並設定給該 div 的 scrollTop。
這樣一來,即使 UpdatePanel 完成回傳,頁面仍能回到使用者原本的位置。
如果網站使用母版頁,也可以把這個功能放到母版頁中,讓所有頁面共用。先在母版頁加入 HiddenField,再撰寫 SetScrollPosition 函式。這個函式會把控制項的 id 與 scrollTop 值一起保存,並以某個分隔符號串接,例如 id 加上捲軸值。
在 pageLoaded 事件中,再把字串拆開,取出控制項 id 與捲軸值,然後找到對應控制項並設定 scrollTop。如此一來,不同頁面只要給控制項加上 id 與 onscroll 事件,就能共用這套邏輯。
這種方式適合需要保留捲軸位置的情境,例如長清單、日誌頁或資料列表。實作時要特別注意控制項 id 是否正確,以及 pageLoaded 是否只在需要時執行,避免多餘的 DOM 操作。
整體來說,這個方法的核心就是「先保存,再還原」。只要掌握 HiddenField 與 pageLoaded 的配合,就能有效改善 UpdatePanel 回傳後捲軸跑掉的問題。