UIScrollView 是 iOS 滾動體系的基石,UITableView、UICollectionView 乃至 UIPageViewController 都建立在它之上。理解它的幾個關鍵屬性與委派方法,等於掌握了整個滾動家族的行為模型。
contentSize:畫布大小,決定內容可滾動的範圍。contentOffset:畫布相對內容原點的偏移量,決定目前顯示的是哪一塊。bounces:是否允許越界彈動。pagingEnabled:是否按頁滾動,一次滑動剛好移動一個畫面寬度或高度。userInteractionEnabled:是否接受觸碰事件。#import <UIKit/UIKit.h>
@interface ViewController : UIViewController <UIScrollViewDelegate> {
// 滾動視圖成員變數
UIScrollView *_scrollView;
}
@end
#import "ViewController.h"
@interface ViewController ()
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
_scrollView = [[UIScrollView alloc] init];
// 設定位置與尺寸
_scrollView.frame = CGRectMake(10, 50, 300, 400);
// 關閉彈動效果
_scrollView.bounces = NO;
// 是否接受觸碰事件:YES 接受,NO 不接受
_scrollView.userInteractionEnabled = YES;
// 設定畫布大小(此處為縱向滾動)
_scrollView.contentSize = CGSizeMake(300, 400 * 9);
for (int i = 0; i < 10; i++) {
NSString *strName = [NSString stringWithFormat:@"17_%d.png", i + 1];
UIImage *image = [UIImage imageNamed:strName];
UIImageView *iView = [[UIImageView alloc] init];
iView.image = image;
// 決定每張圖在畫布中的位置
iView.frame = CGRectMake(0, 400 * i, 300, 400);
[_scrollView addSubview:iView];
}
[self.view addSubview:_scrollView];
// 關閉按頁滾動
_scrollView.pagingEnabled = NO;
// _scrollView.pagingEnabled = YES;
// 畫布的偏移位置,決定最終顯示的畫面
_scrollView.contentOffset = CGPointMake(0, 0);
// 設定委派物件
_scrollView.delegate = self;
}
除了讓使用者手動拖動,也可以直接改寫 contentOffset 跳到指定座標,或呼叫 scrollRectToVisible:animated: 平滑捲動到目標區域:
- (void)touchesBegan:(NSSet<UITouch> *)touches withEvent:(UIEvent *)event {
// 直接跳到指定座標:
// _scrollView.contentOffset = CGPointMake(0, 0);
// 動畫捲動到指定區域
[_scrollView scrollRectToVisible:CGRectMake(0, 0, 300, 400) animated:YES];
}
// 只要 offset 發生變化就會呼叫,是監控滾動位置最直接的入口
- (void)scrollViewDidScroll:(UIScrollView *)scrollView {
NSLog(@"Y=%f", scrollView.contentOffset.y);
}
// 即將開始被拖動
- (void)scrollViewWillBeginDragging:(UIScrollView *)scrollView {
NSLog(@"Will Begin Drag");
}
// 即將結束拖動,velocity 為目前速度,targetContentOffset 為預計停止位置
// (可透過 inout 參數修改最終落點,常用於自訂吸附效果)
- (void)scrollViewWillEndDragging:(UIScrollView *)scrollView
withVelocity:(CGPoint)velocity
targetContentOffset:(inout CGPoint *)targetContentOffset {
NSLog(@"Will End Drag");
}
// 已結束拖動;decelerate 表示後續是否還會進入減速階段
- (void)scrollViewDidEndDragging:(UIScrollView *)scrollView
willDecelerate:(BOOL)decelerate {
NSLog(@"Did End Drag");
}
// 即將進入減速
- (void)scrollViewWillBeginDecelerating:(UIScrollView *)scrollView {
NSLog(@"Will Begin Decelerating");
}
// 減速結束,也就是畫面完全靜止的瞬間
- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView {
NSLog(@"視圖停止移動");
}
- (void)didReceiveMemoryWarning {
[super didReceiveMemoryWarning];
// 釋放可重建的資源
}
@end
contentSize 若小於滾動視圖本身尺寸,畫面根本不會滾動,這是初學者最常遇到的「滾不動」原因。scrollViewDidScroll: 會被高頻呼叫,其中不要放耗時運算;若需要節流,可自行記錄上次處理的 offset 做判斷。bounces 後,越界回弹消失,但 scrollViewDidScroll: 仍會回報邊界內的變化。pagingEnabled,建議搭配 scrollViewWillEndDragging:withVelocity:targetContentOffset: 微調落點,以處理頁面寬度不剛好等於畫面寬度的情況。