您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

UIPageControl 與 UIScrollView 搭配:頁碼指示器與縮放

編輯:iOS 開發綜合

輪播圖下方那一排小圓點就是 UIPageControl。它本身不負責滾動,只負責「顯示目前第幾頁/共幾頁」並回報使用者點了哪一頁。搭配 UIScrollView 就能做出一組完整的翻頁體驗。

三個關鍵屬性

  • numberOfPages:總頁數,決定有幾顆點。
  • currentPage:目前頁(從 0 開始)。
  • pageIndicatorTintColor/currentPageIndicatorTintColor:未選中與選中點的顏色。

程式碼

#import "MainViewController.h"

#define WIDTH  self.view.frame.size.width
#define HEIGHT self.view.frame.size.height

@interface MainViewController () <UIScrollViewDelegate>
@property (nonatomic, retain) UIScrollView *scrollView;
@property (nonatomic, retain) UIImageView  *imageView;
@end

@implementation MainViewController

- (void)dealloc {
    [_scrollView release];
    [_imageView release];
    [super dealloc];
}

- (void)viewDidLoad {
    [super viewDidLoad];

    // ── 建立滾動區 ──
    self.scrollView = [[UIScrollView alloc] initWithFrame:self.view.frame];
    self.scrollView.backgroundColor = [UIColor yellowColor];
    [self.view addSubview:self.scrollView];
    [self.scrollView release];

    self.scrollView.contentSize = CGSizeMake(13 * WIDTH, HEIGHT - 100);
    self.scrollView.pagingEnabled = YES;

    for (NSInteger i = 0; i < 13; i++) {
        NSString *picName = [NSString stringWithFormat:@"cymbal_%02ld.jpg", (long)i];
        self.imageView = [[UIImageView alloc] initWithImage:[UIImage imageNamed:picName]];
        self.imageView.frame = CGRectMake(i * WIDTH, 0, WIDTH, HEIGHT - 100);
        [self.scrollView addSubview:self.imageView];
        [self.imageView release];
    }

    self.scrollView.contentOffset = CGPointMake(0, 0);
    self.scrollView.bounces = NO;
    self.scrollView.showsHorizontalScrollIndicator = NO;
    self.scrollView.showsVerticalScrollIndicator = NO;
    self.scrollView.delegate = self;

    // ── 縮放設定 ──
    self.scrollView.maximumZoomScale = 2;    // 最大放大到 2 倍
    self.scrollView.minimumZoomScale = 0.5;  // 最小縮到 0.5 倍
    self.scrollView.zoomScale = 1;           // 初始比例

    // ── 頁碼指示器 ──
    UIPageControl *page = [[UIPageControl alloc]
        initWithFrame:CGRectMake(100, 580, 200, 40)];
    page.backgroundColor = [UIColor redColor];
    [self.view addSubview:page];
    [page release];

    page.numberOfPages = 13;                              // 點的數量 = 頁數
    page.pageIndicatorTintColor = [UIColor blackColor];   // 未選中
    page.currentPageIndicatorTintColor = [UIColor whiteColor];   // 選中

    [page addTarget:self action:@selector(pageAction:)
   forControlEvents:UIControlEventValueChanged];
    page.tag = 1000;
}

#pragma mark - 縮放:回傳要被縮放的那個子視圖
- (UIView *)viewForZoomingInScrollView:(UIScrollView *)scrollView {
    return [scrollView.subviews firstObject];
}

#pragma mark - 點擊小圓點 → 跳到該頁
- (void)pageAction:(UIPageControl *)page {
    NSLog(@"%ld", (long)page.currentPage);   // currentPage 從 0 起算
    [self.scrollView setContentOffset:CGPointMake(WIDTH * page.currentPage, 0)
                             animated:YES];
}

#pragma mark - 手動滑動 → 讓小圓點跟著動
- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView {
    UIPageControl *page = (UIPageControl *)[self.view viewWithTag:1000];
    page.currentPage = self.scrollView.contentOffset.x / WIDTH;
}

@end

雙向同步是重點

scrollView 與 pageControl 必須互相更新,缺一不可:

  • 點小圓點 → 改 scrollView 的 contentOffset(pageAction:)
  • 手動滑動 → 改 pageControl 的 currentPage(scrollViewDidEndDecelerating:)

只做了其中一邊,就會出現「點了會跳但滑了點不變」或反之的情況。

幾個實務改進建議

  • 用 scrollViewDidScroll 而非 DidEndDecelerating:後者只在「使用者甩動後停下」時觸發。若用程式碼設定 animated:NO 的 offset,或使用者慢慢拖曳放開沒有慣性,它不會被呼叫。改用 scrollViewDidScroll: 搭配 round(offset.x / WIDTH) 會更即時。
  • 不要用 tag 找 pageControl:把它宣告成屬性即可,viewWithTag: 是脆弱且難以追蹤的寫法。
  • 縮放後版面會錯位:開啟 zoom 之後,原本的 frame 座標系不再對應視覺位置。若同時需要分頁與縮放,實務上會把每頁各自包成一個容器 view,讓縮放只發生在該頁內部。
  • viewForZoomingInScrollView 回傳 nil 就不會縮放:範例回傳 subviews.firstObject,若 scrollView 沒有子視圖會是 nil,縮放手勢自然失效。
  • UIPageControl 在 iOS 14 後有改版:新增 backgroundStyle、directionalLayoutEnabled 等屬性,外觀與行為都比舊版彈性。另外若頁數很多(數十頁以上),小圓點會擠成一團,這種情況應改用 UIPageControl 的 visiblePage 技巧或乾脆換成自訂的分頁元件。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved