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

UIScrollView 詳解:初始化設定、屬性對照與 delegate 回呼時機

編輯:iOS 開發綜合

UIScrollView 是使用率極高卻又常被誤解的元件。誤解多半來自一個事實:contentSize 沒設對,畫面就不會動。這篇從實作一路整理到屬性對照表。

第一步:宣告並遵守協定

#import <UIKit/UIKit.h>

@interface Activity01ViewController : UIViewController <UIScrollViewDelegate> {
    UIScrollView *myscrollview;
}
@property (nonatomic, retain) UIScrollView *myscrollview;
@end

第二步:初始化與常見設定

- (void)viewDidLoad {
    [super viewDidLoad];

    myscrollview = [[UIScrollView alloc]
        initWithFrame:CGRectMake(0.0, 44, 768, 1004)];
    myscrollview.directionalLockEnabled = YES;   // 只能單一方向滑動
    myscrollview.pagingEnabled = NO;             // 是否整頁翻動
    myscrollview.backgroundColor = [UIColor blackColor];
    myscrollview.showsVerticalScrollIndicator = YES;
    myscrollview.indicatorStyle = UIScrollViewIndicatorStyleWhite;
    myscrollview.showsHorizontalScrollIndicator = NO;
    myscrollview.delegate = self;

    // 關鍵:contentSize 決定可滾動範圍
    CGSize newSize = CGSizeMake(self.view.frame.size.width,
                                self.view.frame.size.height + 1);
    [myscrollview setContentSize:newSize];

    UIImageView *myimage = [[UIImageView alloc]
        initWithImage:[UIImage imageNamed:@"Activity01.png"]];
    [myimage setFrame:CGRectMake(0, 0, 768, 1004)];
    [myscrollview addSubview:myimage];

    [self.view addSubview:myscrollview];
}

範例中把 contentSize 的高度設為 view 高度 +1,就是為了剛好產生一點點可滾動空間。實務上 contentSize 通常應該等於內容子視圖的實際尺寸。

屬性對照表

內容與範圍

  • contentOffset(CGPoint):目前滾動的位置。
  • contentSize(CGSize):可滾動範圍的大小。
  • contentInset(UIEdgeInsets):視圖在 scrollView 中的位置(內縮邊距)。

滾動行為

  • directionalLockEnabled:是否限制單一方向滾動。
  • bounces:遇到邊界是否反彈。
  • alwaysBounceVertical / alwaysBounceHorizontal:即使內容小於畫面,是否仍允許該方向反彈。
  • pagingEnabled:是否整頁翻動。
  • scrollEnabled:是否可滾動。
  • decelerationRate:減速率,數值越小減速越慢、滑行越遠。
  • delaysContentTouches:是否延遲觸發開始滾動的方法。
  • canCancelContentTouches:控制項是否可取消 touch 事件。

滾動條

  • showsHorizontalScrollIndicator / showsVerticalScrollIndicator:是否顯示各方向滾動條。
  • indicatorStyle:滾動條樣式。
  • scrollIndicatorInsets:滾動條在 scrollView 中的位置。

縮放

  • minimumZoomScale / maximumZoomScale:縮放上下限。
  • zoomScale:目前縮放比例。
  • bouncesZoom:縮放時是否反彈。
  • zooming / zoomBouncing:唯讀,分別表示「正在縮放」與「正在縮放反彈」。

狀態監控(皆為唯讀)

  • tracking:是否正在被跟隨觸碰(手指按著但未移動到判定門檻)。
  • dragging:是否正在被拖曳。
  • decelerating:是否正在減速。
  • scrollsToTop:點狀態列時是否滾回頂部。

小技巧:若不想讓 scrollView 上下滑動,把 contentSize 的高度設為 0 即可:scrollview.contentSize = CGSizeMake(你要的長度, 0);

delegate 回呼與觸發時機

#pragma mark UIScrollViewDelegate

// 只要滾動了就會觸發(包含程式碼設定 contentOffset)
- (void)scrollViewDidScroll:(UIScrollView *)scrollView {
    NSLog(@"ContentOffset x is %f, y is %f",
          scrollView.contentOffset.x, scrollView.contentOffset.y);
}

// 開始拖曳
- (void)scrollViewWillBeginDragging:(UIScrollView *)scrollView;

// 結束拖曳;decelerate 表示是否還會繼續滑行
- (void)scrollViewDidEndDragging:(UIScrollView *)scrollView
                  willDecelerate:(BOOL)decelerate;

// 即將開始減速
- (void)scrollViewWillBeginDecelerating:(UIScrollView *)scrollView;

// 減速結束(手指再次觸碰也會中斷減速)
- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView;

// 由程式碼觸發的捲動動畫結束時
- (void)scrollViewDidEndScrollingAnimation:(UIScrollView *)scrollView;

縮放相關

// 回傳要縮放哪個子視圖(必須是 scrollView 的子視圖)
- (UIView *)viewForZoomingInScrollView:(UIScrollView *)scrollView {
    return viewA;
}

// 縮放結束後呼叫
- (void)scrollViewDidEndZooming:(UIScrollView *)scrollView
                       withView:(UIView *)view
                        atScale:(float)scale;

回到頂部

// 回傳 NO 可關閉「點狀態列自動滾回頂部」的預設行為
- (BOOL)scrollViewShouldScrollToTop:(UIScrollView *)scrollView {
    return YES;
}

- (void)scrollViewDidScrollToTop:(UIScrollView *)scrollView;

實務上最容易搞錯的三件事

  • contentSize 忘了設:這佔了新手問題的絕大多數。內容不會動,九成是這裡沒設或設太小。
  • scrollViewDidScroll 觸發次數遠超預期:這個方法在 deceleration 期間會被連續呼叫,若裡面放了耗時運算會嚴重影響效能,必要時要自行節流。
  • 縮放時子視圖要綁定 delegate 的 viewForZooming:只設定 minimumZoomScale / maximumZoomScale 是不足以啟用縮放手勢的。

最後提醒:以上寫法使用 retain 與手動配置 frame,屬 MRC 時代風格。現代專案請改用 strong/weak、Auto Layout,並優先考慮直接用 UITableView 或 UICollectionView 取代手動 scrollView——除非你確實需要完全自訂的捲動行為。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved