UIScrollView 是 iOS 裡最基礎也最常被繼承的元件,UITableView、UICollectionView、UITextView 底下都是它。把它的屬性與代理方法一次搞清楚,後續自訂滾動行為就不再是黑箱。
預設 CGPointZero,用來設定或讀取目前的滾動偏移量。
// 設定滾動偏移量 scrollView.contentOffset = CGPointMake(0, 200);
預設 CGSizeZero,決定內容的實際尺寸,也就是可滾動的範圍。
// 設定滾動範圍:高度為畫面的兩倍
scrollView.contentSize = CGSizeMake(self.view.bounds.size.width,
self.view.bounds.size.height * 2);
預設 UIEdgeInsetsZero,用來在內容之外加上額外的滾動邊距。UIEdgeInsetsMake 的參數順序是逆時針的上、左、下、右。
// 在頂部留出 100pt 的額外滾動空間 scrollView.contentInset = UIEdgeInsetsMake(100, 0, 0, 0);
預設 YES,也就是邊界回彈的彈簧效果。
scrollView.bounces = NO; // 關閉回彈
預設 NO,開啟後會以整個 view 寬度為單位分頁停靠。
scrollView.pagingEnabled = YES;
預設 YES,控制是否允許使用者滾動。
scrollView.scrollEnabled = NO; // 禁止滾動
設為 YES 時,一次只能沿單一方向滾動,避免斜向游移。
調整松手後的減速曲線,數值越小減速越快、滑行距離越短。
前者控制是否延後觸發開始滾動的方法,後者決定子 view 收到 touch 後能否被滾動手勢取消。若cell 內有需要即時回應的按鈕,這兩個屬性往往是問題根源。
預設皆為 1.0。要啟用縮放,除了設定上下限,還必須實作代理方法 viewForZoomingInScrollView: 並指定要縮放的子 view。
scrollView.minimumZoomScale = 0.8; // 允許縮至 0.8 倍 scrollView.maximumZoomScale = 2.0; // 允許放大到 2 倍
showsHorizontalScrollIndicator 與 showsVerticalScrollIndicator 預設都是 YES,正式環境通常會關掉。
scrollView.showsHorizontalScrollIndicator = NO; scrollView.showsVerticalScrollIndicator = NO;
indicatorStyle 則用來設定滾動條樣式(預設、黑色、白色)。
tracking 表示目前是否正被手指跟蹤;dragging 表示是否處於拖曳狀態;decelerating 表示是否正在減速。這三個唯讀屬性常用來判斷手勢階段。
使用代理前,類別必須遵守 UIScrollViewDelegate 協議,並設定 delegate:
scrollView.delegate = self;
// 偏移量一改變就會呼叫,也就是每次滾動都會觸發 - (void)scrollViewDidScroll:(UIScrollView *)scrollView; // 縮放時呼叫 - (void)scrollViewDidZoom:(UIScrollView *)scrollView NS_AVAILABLE_IOS(3_2); // 指定哪個子 view 參與縮放,該 view 必須是 scrollView 的子 view - (UIView *)viewForZoomingInScrollView:(UIScrollView *)scrollView; // 即將開始縮放 - (void)scrollViewWillBeginZooming:(UIScrollView *)scrollView withView:(UIView *)view NS_AVAILABLE_IOS(3_2); // 完成縮放 - (void)scrollViewDidEndZooming:(UIScrollView *)scrollView withView:(UIView *)view atScale:(float)scale;
viewForZoomingInScrollView: 的常見寫法:
- (UIView *)viewForZoomingInScrollView:(UIScrollView *)scrollView {
return scrollView.subviews[0];
}
// 即將開始拖曳
- (void)scrollViewWillBeginDragging:(UIScrollView *)scrollView;
// 即將結束拖曳,可取得速度與預估停靠位置
- (void)scrollViewWillEndDragging:(UIScrollView *)scrollView
withVelocity:(CGPoint)velocity
targetContentOffset:(inout CGPoint *)targetContentOffset NS_AVAILABLE_IOS(5_0);
// 已結束拖曳,decelerate 表示後續是否還會減速
- (void)scrollViewDidEndDragging:(UIScrollView *)scrollView willDecelerate:(BOOL)decelerate;
// 即將開始減速
- (void)scrollViewWillBeginDecelerating:(UIScrollView *)scrollView;
// 減速結束
- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView;
未開啟分頁時:
scrollViewWillBeginDragging → scrollViewDidScroll → scrollViewWillEndDragging → scrollViewDidEndDragging
開啟分頁時:
scrollViewWillBeginDragging → scrollViewDidScroll → scrollViewDidEndDragging → scrollViewWillBeginDecelerating → scrollViewDidScroll → scrollViewDidEndDecelerating
記住這兩條鏈,做無限輪播、視差滾動或手勢與動畫協調時,就知道該把邏輯掛在哪個環節。