UIScrollView 是 iOS 中最常用的滾動容器之一,但在實際專案中,它的一些行為細節常常讓人頭痛。本文將從一個真實的踩坑經歷出發,剖析 UIScrollView 的事件攔截機制,並整理它的常見用法。
某次開發中,我在 UIViewController 上建立了一個 UIScrollView,並在其中加入了一個 UISlider 元件。奇怪的是,當我嘗試滑動 UISlider 時,往往滑不動——手勢總是被 UIScrollView「搶走」用來滾動自身,讓人非常苦惱。
深入了解後才發現,這與 UIScrollView 的事件處理機制有關。UIScrollView 重載了 hitTest 方法:當手指觸碰螢幕時,它會先攔截所有事件並等待約 150 毫秒。在這段時間內:
因此,直接快速拖動 UISlider 時,觸碰時間往往在 150ms 以內,UIScrollView 誤以為你要滾動自己,於是攔截了事件,導致 UISlider 收不到滑動事件。反之,只要按住 UISlider 一會兒再拖動,觸碰時間超過 150ms,滑動事件才會正常傳給 UISlider。
嘗試過幾種做法後,最可行的方式是重寫 UIScrollView 的 hitTest 方法,在滑動 UISlider 時讓 UIScrollView 不可滾動。需要注意的是,如果直接把 UIScrollView 拖進 StoryBoard,是無法在 ViewController 中重寫 hitTest 的。正確做法是新建一個繼承自 UIScrollView 的類別,在其中重寫該方法,再使用這個自訂類別即可。
以下程式碼展示了 UIScrollView 的一些常見設定與代理方法,說明都寫在註解裡:
- (void)viewDidLoad {
[super viewDidLoad];
scrollView = [[UIScrollView alloc] initWithFrame:CGRectMake(0, 0, 320, 460)];
scrollView.backgroundColor = [UIColor redColor];
scrollView.delegate = self;
// 設定內容大小
scrollView.contentSize = CGSizeMake(320, 460*10);
// 是否分頁
// scrollView.pagingEnabled = YES;
// 是否滾動
// scrollView.scrollEnabled = NO;
// 設定內容的內縮邊距
// scrollView.contentInset = UIEdgeInsetsMake(0, 50, 50, 0);
// 閃一下滾動指示器,提示使用者
[scrollView flashScrollIndicators];
// 是否鎖定單一方向滾動
scrollView.directionalLockEnabled = YES;
[self.view addSubview:scrollView];
}
在代理方法中,可以精細監控滾動的各種狀態:
// 是否支持滑動至頂部
- (BOOL)scrollViewShouldScrollToTop:(UIScrollView *)scrollView {
return YES;
}
// 已經滑動
- (void)scrollViewDidScroll:(UIScrollView *)scrollView {
NSLog(@"scrollViewDidScroll");
}
// 開始拖動
- (void)scrollViewWillBeginDragging:(UIScrollView *)scrollView {
NSLog(@"scrollViewWillBeginDragging");
}
// 結束拖動(decelerate 表示是否還會繼續減速)
- (void)scrollViewDidEndDragging:(UIScrollView *)scrollView willDecelerate:(BOOL)decelerate {
NSLog(@"scrollViewDidEndDragging");
}
// 減速停止
- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView {
NSLog(@"scrollViewDidEndDecelerating");
}
此外,UIScrollView 還支援縮放功能,透過 viewForZoomingInScrollView: 返回要縮放的視圖即可。掌握這些屬性與代理方法,你就能應對絕大多數滾動相關的需求,並優雅地避開事件攔截的坑。