您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 使用技巧 >> iOS 技巧大全

iOS 多圖無縫輪播元件的封裝與使用

編輯:iOS 技巧大全

「有沒有圖片無限滾動的 demo?」這個問題被問過很多次。網路上正經的輪播 demo 我這兒還真沒有,於是乾脆自己封裝一個可以直接放進專案的版本。沒研究過別人的實作細節,這版是借用 Web 前端的幻燈片思路做的——之前寫前端時就是這麼實現的,今天把它搬到 iPhone 上。若想找成熟方案,iCarousel(https://github.com/nicklockwood/iCarousel)相當強大,雖然沒必要重複造輪子,但理解原理還是有價值。

一、效果、原理與呼叫方式

1. 執行效果

下面的 GIF 是實際運行結果:間隔一段時間後圖片自動切換,也支援手指滑動。切到某張圖時點擊它,會透過 block 回呼把該圖的 index 傳出來——demo 裡用提示框顯示,實務上拿到 index 能做的事情就多了。index 就是圖片的 tag,標記著你點的是哪張。

2. 原理

一句話概括:要顯示 3 張圖,就在 scrollView 上貼 4 張,順序是 3-1-2-3。首次顯示位置設在第 2 格(也就是 1),往後滑到最後那張 3 時,無動畫地跳回第 1 格(同樣是 3),繼續往後滾。因為頭尾兩張圖相同,這個跳躍肉眼完全看不出來。

3. 元件呼叫方式

初始化與屬性設定分五步:

(1)確定元件位置
(2)準備圖片名稱陣列
(3)用便利構造器初始化並傳入陣列
(4)設定屬性(選用):scrollInterval 為切換間隔,animationInterVale 為切換動畫時長
(5)用 addTapEventForImageWithBlock: 掛上點擊回呼

-(void)addZLImageViewDisPlayView {
    // 決定顯示位置
    CGRect screenFrame = [[UIScreen mainScreen] bounds];
    CGRect frame = CGRectMake(10, 60, screenFrame.size.width - 20, 200);

    NSArray *imageArray = @[@"01.jpg", @"02.jpg", @"03.jpg"];

    // 初始化元件
    ZLImageViewDisplayView *imageViewDisplay =
        [ZLImageViewDisplayView zlImageViewDisplayViewWithFrame:frame WithImages:imageArray];

    imageViewDisplay.scrollInterval   = 2;    // 自動切換間隔(秒)
    imageViewDisplay.animationInterVale = 0.6; // 切換動畫時長(秒)

    [self.view addSubview:imageViewDisplay];

    [imageViewDisplay addTapEventForImageWithBlock:^(NSInteger imageIndex) {
        NSString *str = [NSString stringWithFormat:@"我是第%ld張圖片", imageIndex];
        UIAlertView *alter = [[UIAlertView alloc] initWithTitle:@"提示"
                                                        message:str
                                                       delegate:nil
                                              cancelButtonTitle:@"OK"
                                              otherButtonTitles:nil, nil];
        [alter show];
    }];
}

二、核心程式碼

1. 便利初始化

傳入 frame 與圖片名稱陣列,在其中完成屬性預設值設定與各項初始化呼叫。

#pragma mark - 便利初始化方法
- (instancetype)initWithFrame:(CGRect)frame WithImages:(NSArray *)images {
    self = [super initWithFrame:frame];
    if (self) {
        _widthOfView  = frame.size.width;
        _heightView   = frame.size.height;

        _scrollInterval    = 3;
        _animationInterVale = 0.7;
        _currentPage       = 1;                       // 目前顯示第幾張
        _imageViewcontentModel = UIViewContentModeScaleAspectFill;
        self.clipsToBounds = YES;

        [self initMainScrollView];                    // 建立 scrollView
        [self addImageviewsForMainScrollWithImages:images];
        [self addTimerLoop];                          // 建立 timer
        [self addPageControl];                        // 建立 page control
    }
    return self;
}

2. 便利構造器

#pragma mark - 便利構造器
+ (instancetype)zlImageViewDisplayViewWithFrame:(CGRect)frame WithImages:(NSArray *)images {
    ZLImageViewDisplayView *instance =
        [[ZLImageViewDisplayView alloc] initWithFrame:frame WithImages:images];
    return instance;
}

3. 初始化 ScrollView

#pragma mark - 初始化 ScrollView
- (void)initMainScrollView {
    _mainScrollView = [[UIScrollView alloc] initWithFrame:CGRectMake(0, 0, _widthOfView, _heightView)];
    _mainScrollView.contentSize = CGSizeMake(_widthOfView, _heightView);
    _mainScrollView.pagingEnabled = YES;
    _mainScrollView.showsHorizontalScrollIndicator = NO;
    _mainScrollView.showsVerticalScrollIndicator = NO;
    _mainScrollView.delegate = self;
    [self addSubview:_mainScrollView];
}

4. 加上 PageControl

#pragma mark - 添加 PageControl
- (void)addPageControl {
    _imageViewPageControl = [[UIPageControl alloc] initWithFrame:CGRectMake(0, _heightView - 20, _widthOfView, 20)];
    _imageViewPageControl.numberOfPages = _imageViewArray.count;
    _imageViewPageControl.currentPage   = _currentPage - 1;
    _imageViewPageControl.tintColor     = [UIColor blackColor];
    [self addSubview:_imageViewPageControl];
}

5. 貼上 ImageView

這是整個元件的關鍵。contentSize 設為「圖片數 + 1」頁寬,第 0 格放最後一張圖,之後依序排列,最後把 contentOffset 設到第 1 格。

#pragma mark - 給 ScrollView 添加 ImageView
-(void)addImageviewsForMainScrollWithImages:(NSArray *)images {
    _mainScrollView.contentSize = CGSizeMake(_widthOfView * (images.count + 1), _heightView);
    _imageViewArray = images;

    for (int i = 0; i < _imageViewArray.count + 1; i++) {
        CGRect currentFrame = CGRectMake(_widthOfView * i, 0, _widthOfView, _heightView);
        UIImageView *tempImageView = [[UIImageView alloc] initWithFrame:currentFrame];
        tempImageView.contentMode  = _imageViewcontentModel;
        tempImageView.clipsToBounds = YES;

        // 第 0 格放最後一張,其餘依序
        NSString *imageName = (i == 0) ? [_imageViewArray lastObject] : _imageViewArray[i - 1];

        UIImage *imageTemp = [UIImage imageNamed:imageName];
        [tempImageView setImage:imageTemp];
        [_mainScrollView addSubview:tempImageView];
    }

    _mainScrollView.contentOffset = CGPointMake(_widthOfView, 0);
}

6. 建立計時器

- (void)addTimerLoop {
    if (_timer == nil) {
        _timer = [NSTimer scheduledTimerWithTimeInterval:_scrollInterval
                                                  target:self
                                                selector:@selector(changeOffset)
                                                userInfo:nil
                                                 repeats:YES];
    }
}

7. 計時器要執行的事

時間到就動畫切到下一張;若目前已在最後一格,動畫跑完後無痛跳回第 0 格。

-(void)changeOffset {
    _currentPage++;
    if (_currentPage == _imageViewArray.count + 1) {
        _currentPage = 1;
    }

    [UIView animateWithDuration:_animationInterVale animations:^{
        _mainScrollView.contentOffset = CGPointMake(_widthOfView * _currentPage, 0);
    } completion:^(BOOL finished) {
        if (_currentPage == _imageViewArray.count) {
            _mainScrollView.contentOffset = CGPointMake(0, 0);
        }
    }];

    _imageViewPageControl.currentPage = _currentPage - 1;
}

8. 手動滑動

支援手動的關鍵在 scrollView 的代理回呼裡,判斷是否滑到了頭尾並做無痛跳轉。

- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView {
    NSInteger currentPage = scrollView.contentOffset.x / _widthOfView;

    if (currentPage == 0) {
        _mainScrollView.contentOffset = CGPointMake(_widthOfView * _imageViewArray.count, 0);
        _imageViewPageControl.currentPage = _imageViewArray.count;
        _currentPage = _imageViewArray.count;
    }

    if (_currentPage + 1 == currentPage || currentPage == 1) {
        _currentPage = currentPage;
        if (_currentPage == _imageViewArray.count + 1) {
            _currentPage = 1;
        }
        if (_currentPage == _imageViewArray.count) {
            _mainScrollView.contentOffset = CGPointMake(0, 0);
        }
        _imageViewPageControl.currentPage = _currentPage - 1;
        [self resumeTimer];
        return;
    }
}

9. 暫停計時器

手動滑動後若不暫停計時器,剛放開手就可能立刻被自動切換搶走畫面。這裡把下一次觸發時間往後推。

#pragma mark - 暫停計時器
-(void)resumeTimer {
    if (![_timer isValid]) {
        return;
    }
    [_timer setFireDate:[NSDate dateWithTimeIntervalSinceNow:_scrollInterval - _animationInterVale]];
}

10. 對外介面

#import <UIKit/UIKit.h>

// 點擊圖片的回呼,參數為圖片索引(也就是頁數)
typedef void (^TapImageViewButtonBlock)(NSInteger imageIndex);

@interface ZLImageViewDisplayView : UIView

@property (nonatomic, assign) CGFloat scrollInterval;     // 切換間隔,選用,預設 3 秒
@property (nonatomic, assign) CGFloat animationInterVale; // 切換動畫時長,選用,預設 0.7 秒

+ (instancetype)zlImageViewDisplayViewWithFrame:(CGRect)frame WithImages:(NSArray *)images;
- (instancetype)initWithFrame:(CGRect)frame WithImages:(NSArray *)images;
- (void)addTapEventForImageWithBlock:(TapImageViewButtonBlock)block;

@end

三、專案分享

元件與 demo 已放在 GitHub:https://github.com/lizelu/ZLImageViewDisplay

這只是輪播的一種解法,下一篇會用兩個 ImageView 複用的方式實作另一版。程式寫得比較趕,難免有疏漏,歡迎指正。

另外補充一個實務上必須處理的細節:NSTimer 在 iOS 上會被 Run Loop 的預設模式忽略,當使用者拖動 scrollView 時計時器不會觸發,反而造成「滑動中剛好暫停」的假象。若要嚴格控制,應改用 CADisplayLink 或把 timer 加入 UITrackingRunLoopMode。此外,離開頁面時務必 invalidate 計時器並移除,否則 timer 強引用 self 會導致這個 view 永遠無法釋放。

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