
在 iOS 開發中,上下拉刷新幾乎是列表頁必備的互動之一。雖然 MJRefresh 在 Objective-C 生態中非常受歡迎,但在 Swift 專案裡,也可以自行打造一個輕量、易於客製的刷新元件。透過 UIScrollView 的滾動監聽與狀態管理,就能實作出接近常見刷新體驗的效果。





下拉刷新的核心概念並不複雜。首先,把刷新控件加入 scrollView 的頂部或底部,然後監聽它的滾動位置與內容變化。當使用者拖曳到一定距離並放開時,就切換到載入狀態,開始執行資料更新;完成後再回到正常狀態。
在 Swift 中,可以透過 extension 為 UIScrollView 增加刷新相關的方法與屬性。若要保存 header 與 footer 控件,可以選擇使用關聯物件,也可以透過 tag 來存取。兩種方式都能讓呼叫端以一致的方法加入或移除刷新元件。
在方法設計上,可以透過泛型與協定約束,讓 header 或 footer 的動畫器必須是 UIView,並且實作刷新代理。這樣能提高 API 的靈活性,也方便後續替換不同樣式的動畫。
刷新控件通常會有四種狀態:正常、拖曳中、放開即刷新、以及正在載入。透過這些狀態,可以決定要顯示什麼文字、圖示或動畫。
在滾動過程中,可以依 contentOffset 計算拖曳進度,再根據進度切換狀態。當使用者放開手指且進度足夠時,就進入載入狀態;若進度不足,則回到正常狀態。
開始刷新時,通常需要調整 scrollView 的 contentInset,讓刷新控件停留在可見區域內。結束刷新時,則要把 contentInset 還原,避免影響原本的版面。
若是上拉刷新,還需要額外監聽 contentSize 的變化,確保 footer 能被重新定位到內容底部。

可以定義一個刷新代理,讓 header 或 footer 在狀態改變、進度更新、開始與結束刷新時,都能觸發自定義行為。這樣就能把 UI 呈現與資料請求分離,讓元件更易 reuse。
實務上,可以提供兩種常見動畫器:一種是文字與指示器型,另一種是 GIF 圖片型。前者適合簡潔風格,後者則能呈現更活潑的視覺效果。
使用時,只需要建立自定義的 animator,設定提示文字、刷新時間與動畫行為,再把它加入 tableView 即可。資料請求完成後,呼叫停止刷新方法,就能結束動畫並恢復列表。
打造一個類似 MJRefresh 的 Swift 刷新控件,重點不在於複製全部功能,而是理解滾動、狀態、inset 與代理設計之間的關係。只要掌握這些核心概念,就能依專案需求做出輕量且易於維護的刷新體驗。