UIScrollView 是 iOS 中多數滑動效果的基礎。以下示範一個常見應用:把數張圖片橫向排列,配合 UIPageControl 顯示頁碼,並在滑動結束時同步指示器。
@interface BoViewController : UIViewController <UIScrollViewDelegate>
@property (retain, nonatomic) UIScrollView *scrollView; // 滾動視圖
@property (retain, nonatomic) UIPageControl *pageControl; // 頁碼指示器
@property (retain, nonatomic) NSMutableArray *images; // 存放圖片
@end
- (void)viewDidLoad {
[super viewDidLoad];
self.scrollView = [[UIScrollView alloc] initWithFrame:CGRectMake(0, 0, 320, 345)];
self.pageControl = [[UIPageControl alloc] initWithFrame:CGRectMake(0, 344, 320, 36)];
self.images = [NSMutableArray arrayWithObjects:
[UIImage imageNamed:@"text1.png"],
[UIImage imageNamed:@"text2.png"],
[UIImage imageNamed:@"text3.png"],
[UIImage imageNamed:@"text4.png"], nil];
[self.view addSubview:self.scrollView];
[self.view addSubview:self.pageControl];
self.view.backgroundColor = [UIColor blackColor];
[self setupPage:nil];
}
setupPage: 負責配置 scrollView 的各項屬性並鋪排子視圖:
- (void)setupPage:(id)sender {
self.scrollView.delegate = self;
self.scrollView.backgroundColor = [UIColor blackColor];
self.scrollView.canCancelContentTouches = NO;
self.scrollView.indicatorStyle = UIScrollViewIndicatorStyleWhite;
self.scrollView.clipsToBounds = YES;
self.scrollView.scrollEnabled = YES;
// 分頁模式:讓滑動自動對齊到「一頁」的寬度
self.scrollView.pagingEnabled = YES;
self.scrollView.directionalLockEnabled = NO;
self.scrollView.alwaysBounceHorizontal = NO;
self.scrollView.alwaysBounceVertical = NO;
self.scrollView.showsHorizontalScrollIndicator = NO;
self.scrollView.showsVerticalScrollIndicator = NO;
NSUInteger pages = 0;
int originX = 0;
for (UIImage *image in self.images) {
UIImageView *pImageView = [[[UIImageView alloc] initWithFrame:CGRectZero] autorelease];
pImageView.backgroundColor = [UIColor colorWithRed:0.6 green:0.6 blue:0.6 alpha:1.0];
[pImageView setImage:image];
// 每個子視圖佔滿一個「頁」,x 座標依序遞增
CGRect rect = self.scrollView.frame;
rect.origin.x = originX;
rect.origin.y = 0;
rect.size.width = self.scrollView.frame.size.width;
rect.size.height = self.scrollView.frame.size.height;
pImageView.frame = rect;
pImageView.contentMode = UIViewContentModeScaleAspectFill;
[self.scrollView addSubview:pImageView];
originX += self.scrollView.frame.size.width; // 下一頁的 x
pages++;
}
[self.pageControl addTarget:self action:@selector(changePage:)
forControlEvents:UIControlEventValueChanged];
self.pageControl.numberOfPages = pages;
self.pageControl.currentPage = 0;
self.pageControl.tag = 110;
// 關鍵:contentSize 必須等於「總頁數 × 頁寬」
[self.scrollView setContentSize:CGSizeMake(originX, self.scrollView.bounds.size.height)];
}
點擊頁碼時的對應處理:
- (void)changePage:(id)sender {
NSLog(@"指示器的當前索引值為:%i", self.pageControl.currentPage);
CGRect rect = self.scrollView.frame;
rect.origin.x = self.pageControl.currentPage * self.scrollView.frame.size.width;
rect.origin.y = 0;
[self.scrollView scrollRectToVisible:rect animated:YES];
}
反過來,使用者滑動時要更新頁碼,則實作委派方法:
#pragma mark ----- UIScrollViewDelegate -----
- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView {
CGFloat pageWith = scrollView.frame.size.width;
// 依 contentOffset 推回目前頁碼
int page = floor((scrollView.contentOffset.x - pageWith / 2) / pageWith) + 1;
self.pageControl.currentPage = page;
}
- (void)didReceiveMemoryWarning {
[super didReceiveMemoryWarning];
}
- (void)dealloc {
[_pageControl release];
[_scrollView release];
[super dealloc];
}
兩個最容易出錯的地方:一是 contentSize 若設錯,滑到底會出現空白或滑不動;二是子視圖的 y 座標與 scrollView 的 bounds 必須對齊,否則每頁會出現上下錯位。至於 scrollViewDidEndDecelerating: 中的公式,用「contentOffset 減半頁再除以頁寬,然後 floor 加一」是為了讓臨界點落在頁面中央而非邊緣,滑到一半以上才算換頁,手感會自然很多。