電商與外送平台經常需要「下拉進入活動會場」這種互動。它看似只是下拉刷新,實則在一般刷新之外,還多了一層全屏 promotion 的展示邏輯。本文以 Swift 為例,說明如何一步步完成這個效果。
理想情況下,只要一行設定,就能讓 tableView 支援下拉活動會場:
self.tableView.showPullPromotion = true
這代表我們需要為 UIScrollView 建立擴充,並在內部動態加入一個負責展示活動圖片的 view。
首先,建立一個 PullPromotionView,作為 scrollView 的 observer,用來監聽 contentOffset 變化。當使用者往下拉時,根據偏移量切換不同狀態,例如停止、觸發刷新、觸發全屏活動、刷新中、活動展示中。
接著,透過 UIScrollView 的擴充,把這個自訂 view 以關聯物件方式掛上,讓呼叫端可以用簡潔 API 控制顯示與否。
這個互動最容易混亂的地方,是狀態太多。若沒有清楚定義狀態機,很容易出現動畫互相覆蓋、刷新與活動場互相衝突等問題。
因此,我把狀態分成 stopped、refreshTriggered、promotionTriggered、refreshing、promotionShowing 五種,並在每次狀態切換時,同步調整 contentInset、contentOffset 與提示文字。
除了活動會場本身,還需要一個提示元件,告訴使用者「下拉可刷新」、「釋放可刷新」、「正在刷新」或「進入活動會場」。這個元件可以隨著狀態改變文字與可見性。
在動畫上,要注意 UITableView 的 contentOffset 變化可能導致渲染不連續。若需要更精細控制,可以改用 CADisplayLink 自行驅動動畫。
這個互動的難點不在於單一行代碼,而在於狀態切換與視圖層級管理。只要把狀態機設計清楚,後續要加上視差、箭頭動畫或背景模糊,都會容易很多。