UIScrollView 的 delegate 方法看起來多,其實可以依「拖拽 → 減速 → 停止」這條時間軸來記。搞懂每個回調發生的時機與呼叫頻率,才能避免效能與邏輯上的坑。
// 每次 contentOffset 改變都會觸發,滾動過程中會被呼叫非常多次
- (void)scrollViewDidScroll:(UIScrollView *)scrollView
{
CGPoint point = scrollView.contentOffset;
NSLog(@"%f, %f", point.x, point.y);
// 注意:當 contentSize 小於 frame 時,不會觸發滾動
}
// 縮放過程中觸發,同樣會連續呼叫多次
- (void)scrollViewDidZoom:(UIScrollView *)scrollView
{
NSLog(@"zoomScale = %f", scrollView.zoomScale);
}
// 指定參與縮放的就視圖,不實作則縮放功能無效
- (UIView *)viewForZoomingInScrollView:(UIScrollView *)scrollView
{
return self.imgView;
}
效能提醒:scrollViewDidScroll: 是每秒數十次的熱點路徑。在裡面做 layout、網路請求或大量運算,滾動一定掉幀。
// 開始拖拽:一次有效滑動只呼叫一次
- (void)scrollViewWillBeginDragging:(UIScrollView *)scrollView
// 手指即將離開螢幕
// 注意:pagingEnabled 為 YES 時不會呼叫此方法
- (void)scrollViewWillEndDragging:(UIScrollView *)scrollView
withVelocity:(CGPoint)velocity
targetContentOffset:(inout CGPoint *)targetContentOffset
// 手指已離開螢幕
- (void)scrollViewDidEndDragging:(UIScrollView *)scrollView
willDecelerate:(BOOL)decelerate
targetContentOffset 是 inout 參數,你可以在這裡改寫最終停靠位置,實作自訂吸附效果時非常有用。willDecelerate 表示手指離開後是否還會繼續滑行——若為 NO,代表滑動到此結束。
// 開始減速,發生在 scrollViewDidEndDragging: 之後
- (void)scrollViewWillBeginDecelerating:(UIScrollView *)scrollView
// 減速結束、即將停止:一次有效滑動只呼叫一次
- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView
{
// 常見用法:對齊到某一頁
[_scrollView setContentOffset:CGPointMake(0, 500) animated:YES];
}
這裡藏著一個實務陷阱:如果在 scrollViewDidEndDecelerating: 中呼叫 setContentOffset:animated:YES,會啟動一段新的動畫,而動畫結束後不會再觸發 didEndDecelerating。所以「滑動完全停止後要做某事」的邏輯,不能只放在這裡。
// 僅當滾動是透過動畫方式發生時才會呼叫;沒有動畫則完全不觸發
- (void)scrollViewDidEndScrollingAnimation:(UIScrollView *)scrollView
{
// 能觸發此方法的動畫 API 主要是:
// - setContentOffset:animated:
// - scrollRectToVisible:animated:
}
// 即將開始縮放:一次有效縮放只呼叫一次
- (void)scrollViewWillBeginZooming:(UIScrollView *)scrollView withView:(UIView *)view
// 縮放結束,且比例回到 minimumZoomScale 與 maximumZoomScale 之間時呼叫
- (void)scrollViewDidEndZooming:(UIScrollView *)scrollView
withView:(UIView *)view
atScale:(float)scale
// 點擊狀態列是否能滾回頂部,需先設定 _scrollView.scrollsToTop = YES
- (BOOL)scrollViewShouldScrollToTop:(UIScrollView *)scrollView
{
return YES;
}
// 已滾動到頂部
- (void)scrollViewDidScrollToTop:(UIScrollView *)scrollView
補充一個細節:同一時間只有一個 scrollView 的 scrollsToTop 會生效。若畫面上有多個 scrollView,點狀態列只會作用在其中一個。
若 decelerate 為 NO,流程在第 4 步就結束了。把這條鏈記牢,絕大多數 scrollView 相關的行為問題都能對號入座。