移動設備的屏幕尺寸天生有限,用戶一眼能看到的信息量也就那麼多。當內容超出一屏時,就需要靠滾動手勢把視口之外的內容拉進來。普通的 UIView 並不具備滾動能力,而 UIScrollView 正是為此而生——它是一個可滾動的容器視圖,裝得下大量內容,並讓用戶通過滑動瀏覽全部。
系統「設置」這類頁面就是最典型的例子。
上手只有兩步:
1. 把要展示的內容添加到 UIScrollView 上;
2. 設置 contentSize,告訴它內容整體有多大——也就是滾動的邊界在哪裡、到什麼位置算到底。
本文所說的「內容視圖」,在官方文檔裡叫 content view,指的是 UIScrollView 中用來承載內容的那部分。
// 內容視圖的大小,默認為CGSizeZero @property(nonatomic) CGSize contentSize; // 為內容視圖周圍增加可滾動區域,默認為UIEdgeInsetsZero @property(nonatomic) UIEdgeInsets contentInset; // 內容視圖的原點相對於scrollView的原點的偏移量(左上方向偏移為正數),默認為CGPointZero @property(nonatomic) CGPoint contentOffset; // 設置內容視圖的原點相對於scrollView的原點的偏移量 - (void)setContentOffset:(CGPoint)contentOffset animated:(BOOL)animated;
// 是否允許滑動,默認為YES @property(nonatomic,getter=isScrollEnabled) BOOL scrollEnabled; // 是否只允許同時滑動一個方向,默認為NO @property(nonatomic, getter=isDirectionalLockEnabled) BOOL directionalLockEnabled; // 是否允許點擊狀態欄讓scrollView滑動到頂部,默認為YES @property(nonatomic) BOOL scrollsToTop; // 是否按頁數進行滑動,默認為NO @property(nonatomic, getter=isPagingEnabled) BOOL pagingEnabled; // 是否有觸底反彈效果,默認為YES @property(nonatomic) BOOL bounces; // 是否總是有觸底反彈效果,默認為NO(前提 bounces = YES) @property(nonatomic) BOOL alwaysBounceHorizontal; @property(nonatomic) BOOL alwaysBounceVertical; // 手指離開屏幕後的減速比率 @property(nonatomic) CGFloat decelerationRate; // 將指定區域滑動到剛好可見處 - (void)scrollRectToVisible:(CGRect)rect animated:(BOOL)animated;
// 指示器樣式,默認為UIScrollViewIndicatorStyleDefault @property(nonatomic) UIScrollViewIndicatorStyle indicatorStyle; // 為指示器周圍增加可滾動區域 @property(nonatomic) UIEdgeInsets scrollIndicatorInsets; // 是否在滑動時指示器可見,默認為YES @property(nonatomic) BOOL showsHorizontalScrollIndicator; @property(nonatomic) BOOL showsVerticalScrollIndicator; // 閃一下指示器,提醒用戶該處可滑動 - (void)flashScrollIndicators;
理解 UIScrollView 的觸摸事件,關鍵在於它面臨的一個兩難:手指按在子視圖上時,它無法立刻判斷用戶是想滾動內容,還是想點擊這個子視圖。
因此按下的一瞬間,UIEvent 從 UIApplication 傳到 UIScrollView 後會先被攔截,暫不下發給子視圖,同時啟動一個 150ms 的計時器觀察後續動作:
1. 計時結束前手指一旦移動,直接滾動內容視圖,事件不再下發;
2. 計時結束時手指未移動,則調用 -touchesShouldBegin:withEvent:inContentView: 決定是否把事件交給子視圖(返回 NO 則不下發,默認 YES);
3. 事件已下發後手指又移動了,則調用 -touchesShouldCancelInContentView: 決定是否取消已下發的事件。
// 是否已觸碰內容視圖准備滑動 @property(nonatomic,readonly,getter=isTracking) BOOL tracking; // 是否已經開始滑動 @property(nonatomic,readonly,getter=isDragging) BOOL dragging; // 是否處於減速狀態 @property(nonatomic,readonly,getter=isDecelerating) BOOL decelerating; // 是否延遲事件傳遞,默認為YES @property(nonatomic) BOOL delaysContentTouches; // 是否可以取消內容視圖被觸摸,默認為YES @property(nonatomic) BOOL canCancelContentTouches; // 返回是否將事件傳遞給子視圖,默認YES - (BOOL)touchesShouldBegin:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event inContentView:(UIView *)view; // 返回是否取消已傳遞給子視圖的事件 - (BOOL)touchesShouldCancelInContentView:(UIView *)view;
雙指縮放時,系統會同步調整內容視圖的偏移量與縮放比例。
// 最小縮放比例,默認為1.0 @property(nonatomic) CGFloat minimumZoomScale; // 最大縮放比例,默認為1.0(必須大於minimumZoomScale) @property(nonatomic) CGFloat maximumZoomScale; // 當前縮放比例 @property(nonatomic) CGFloat zoomScale; - (void)setZoomScale:(CGFloat)scale animated:(BOOL)animated; - (void)zoomToRect:(CGRect)rect animated:(BOOL)animated; // 是否允許縮放時觸底反彈 @property(nonatomic) BOOL bouncesZoom; @property(nonatomic,readonly,getter=isZooming) BOOL zooming; @property(nonatomic,readonly,getter=isZoomBouncing) BOOL zoomBouncing;
// 隱藏鍵盤模式,默認為None @property(nonatomic) UIScrollViewKeyboardDismissMode keyboardDismissMode;
- (void)scrollViewDidScroll:(UIScrollView *)scrollView; - (void)scrollViewWillBeginDragging:(UIScrollView *)scrollView; - (void)scrollViewWillEndDragging:(UIScrollView *)scrollView withVelocity:(CGPoint)velocity targetContentOffset:(inout CGPoint *)targetContentOffset; - (void)scrollViewDidEndDragging:(UIScrollView *)scrollView willDecelerate:(BOOL)decelerate; - (void)scrollViewWillBeginDecelerating:(UIScrollView *)scrollView; - (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView; - (BOOL)scrollViewShouldScrollToTop:(UIScrollView *)scrollView; - (void)scrollViewDidScrollToTop:(UIScrollView *)scrollView; - (void)scrollViewDidEndScrollingAnimation:(UIScrollView *)scrollView;
- (void)scrollViewDidZoom:(UIScrollView *)scrollView; - (UIView *)viewForZoomingInScrollView:(UIScrollView *)scrollView; - (void)scrollViewWillBeginZooming:(UIScrollView *)scrollView withView:(UIView *)view; - (void)scrollViewDidEndZooming:(UIScrollView *)scrollView withView:(UIView *)view atScale:(CGFloat)scale;

原理:系統為了避免 UIScrollView 被導航欄遮擋,會在其恰好是控制器視圖的第 0 個子視圖時,自動把 contentInset 與 scrollIndicatorInsets 設為 UIEdgeInsetsMake(64, 0, 0, 0);存在 UITabBar 時則設為 UIEdgeInsetsMake(0, 0, 49, 0)。想要內容滾到導航欄下方,只要把 UIScrollView 的 frame 撐滿整個屏幕,並通過 self.automaticallyAdjustsScrollViewInsets = NO; 關掉系統的自動調整即可。

原理:兩種常見思路。
方式一:在懸停位置預先放一個外觀相同的控件,在 -scrollViewDidScroll: 裡跟蹤 contentOffset,未達條件時隱藏它,達到條件時顯示。
方式二:同樣跟蹤 contentOffset,未達條件時讓待懸停控件掛在 scrollView 上,達到條件後把它移到 scrollView 的父視圖上。
- (void)scrollViewDidScroll:(UIScrollView *)scrollView {
if (scrollView.contentOffset.y >= 100) {
CGRect rect = label.frame;
rect.origin.y = 0;
label.frame = rect;
[self.view addSubview:label];
} else {
CGRect rect = label.frame;
rect.origin.y = 100;
label.frame = rect;
[scrollView addSubview:label];
}
}

原理:在 -scrollViewDidScroll: 中根據 contentOffset 的變化動態計算縮放比例。
- (void)scrollViewDidScroll:(UIScrollView *)scrollView {
CGFloat scale = 1 - (scrollView.contentOffset.y / 100);
scale = (scale >= 1) ? scale : 1;
scale = (scale <= 2) ? scale : 2;
imageView.transform = CGAffineTransformMakeScale(scale, scale);
}

原理:已知圖片數組有 N 個元素時,創建 N+2 個 UIImageView。第 1 到第 N 個放真實內容,第 0 個複製第 N 個,第 N+1 個複製第 1 個。滑到頭尾兩個「假」圖片時,在 -scrollViewDidScroll: 裡直接把 contentOffset 校正回真實位置,視覺上就實現了無縫循環。

UIScrollView 幾乎是所有列表與滑動交互的基石,把 contentSize、contentInset、contentOffset 三者關係理清,再配合代理方法做偏移量跟蹤,絕大多數常見效果都能自己寫出來。有疑問歡迎留言交流。