作為一個(gè)iOS開(kāi)發(fā)者,我們經(jīng)常需要用到輪播圖,比如:我們首頁(yè)頂部的廣告輪播,商品詳情頁(yè)面的商品圖片輪播等,如果我們每個(gè)地方都去直接定義scrollView,然后設(shè)置定時(shí)器等等操作,就會(huì)覺(jué)得很繁瑣....于是就想著封裝一個(gè)輪播圖庫(kù)FFScrollView
老慣例哈,先給出gitHub上的代碼地址哈:
https://github.com/BrightMoment/FFScrollView
1.首先看下FFScrollView.h中的代碼
#import <UIKit/UIKit.h>
typedef enum
{
FFScrollViewSelecttionTypeTap = 100, //默認(rèn)的為可點(diǎn)擊模式
FFScrollViewSelecttionTypeNone //不可點(diǎn)擊的
}FFScrollViewSelecttionType;
@protocol FFScrollViewDelegate <NSObject>
@optional
- (void)scrollViewDidClickedAtPage:(NSInteger)pageNumber;
@end
@interface FFScrollView : UIView <UIScrollViewDelegate>
{
NSTimer *timer;
NSArray *sourceArr;
NSString * tagStr;
UILabel * lable1;
UILabel * lable2;
UILabel * lable3;
}
@property(strong,nonatomic) UIScrollView *scrollView;
@property(strong,nonatomic) UIPageControl *pageControl;
@property(assign,nonatomic) FFScrollViewSelecttionType selectionType;
@property(assign,nonatomic) id <FFScrollViewDelegate> pageViewDelegate;
- (id)initPageViewWithFrame:(CGRect)frame views:(NSArray *)views tag:(NSString *)tag;
@end
上面代碼主要看下這部分
typedef enum
{
FFScrollViewSelecttionTypeTap = 100, //默認(rèn)的為可點(diǎn)擊模式
FFScrollViewSelecttionTypeNone //不可點(diǎn)擊的
}FFScrollViewSelecttionType;
@protocol FFScrollViewDelegate <NSObject>
@optional
- (void)scrollViewDidClickedAtPage:(NSInteger)pageNumber;
@end
我們程序中常用的輪播圖大致分為2種,一種是可以點(diǎn)擊跳轉(zhuǎn)到其他頁(yè)面的;一種是只用于展示的....所以這邊我們枚舉了2種類型
還有一個(gè)代理FFScrollViewDelegate,主要是用來(lái)處理點(diǎn)擊后的事件的
2.下面我們來(lái)看看FFScrollView.m文件
#import "FFScrollView.h"
@implementation FFScrollView
@synthesize scrollView;
@synthesize pageControl;
@synthesize selectionType;
@synthesize pageViewDelegate;
- (id)initWithFrame:(CGRect)frame
{
self = [super initWithFrame:frame];
if (self) {
}
return self;
}
#pragma mark-- init methods
- (id)initPageViewWithFrame:(CGRect)frame views:(NSArray *)views tag:(NSString *)tag
{
self = [super initWithFrame:frame];
if (self) {
selectionType = FFScrollViewSelecttionTypeTap;
sourceArr = views;
tagStr=tag;
self.userInteractionEnabled = YES;
[self iniSubviewsWithFrame:frame];
}
return self;
}
-(void)iniSubviewsWithFrame:(CGRect)frame
{
CGFloat width = frame.size.width;
CGFloat height = frame.size.height;
CGRect fitRect = CGRectMake(0, 0, width, height);
self.scrollView = [[UIScrollView alloc]initWithFrame:fitRect];
self.scrollView.pagingEnabled = YES;
self.scrollView.delegate = self;
self.scrollView.contentSize = CGSizeMake(width*(sourceArr.count+2), height);
self.scrollView.showsVerticalScrollIndicator = NO;
self.scrollView.showsHorizontalScrollIndicator = NO;
[self addSubview:self.scrollView];
UIImageView *firstImageView = [[UIImageView alloc]initWithFrame:fitRect];
[firstImageView sd_setImageWithURL:[NSURL URLWithString:[sourceArr lastObject]] placeholderImage:defaultImage640];
[self.scrollView addSubview:firstImageView];
lable2 =[[UILabel alloc] initWithFrame:CGRectMake(self.frame.size.width-80, self.frame.size.height-30, 80, 20)];
lable2.font=[UIFont systemFontOfSize:18.0f];
lable2.textColor=[UIColor whiteColor];
lable2.textAlignment=1;
// if([tagStr isEqualToString:@"home"])
// {
// [self addSubview:lable2];
// }
lable2.text=[NSString stringWithFormat:@"%zi/%zi",1,sourceArr.count];
for (int i = 0; i < sourceArr.count; i++) {
UIImageView *imageview = [[UIImageView alloc]initWithFrame:CGRectMake(width*(i+1), 0, width, height)];
[imageview sd_setImageWithURL:[NSURL URLWithString:[sourceArr objectAtIndex:i]] placeholderImage:defaultImage640];
[self.scrollView addSubview:imageview];
}
UIImageView *lastImageView = [[UIImageView alloc]initWithFrame:CGRectMake(width*(sourceArr.count+1), 0, width, height)];
[lastImageView sd_setImageWithURL:[NSURL URLWithString:[sourceArr objectAtIndex:0]] placeholderImage:defaultImage640];
[self.scrollView addSubview:lastImageView];
lable3.text=[NSString stringWithFormat:@"%zi/%zi",1,sourceArr.count];
self.pageControl = [[UIPageControl alloc]initWithFrame:CGRectMake(0, height-30, width, 30)];
self.pageControl.numberOfPages = sourceArr.count;
self.pageControl.currentPage = 0;
self.pageControl.enabled = YES;
// [self addSubview:self.pageControl];
[self.scrollView scrollRectToVisible:CGRectMake(width, 0, width, height) animated:NO];
timer = [NSTimer scheduledTimerWithTimeInterval:2.0 target:self selector:@selector(nextPage:) userInfo:nil repeats:YES];
UITapGestureRecognizer *singleTap = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(singleTap:)];
singleTap.numberOfTapsRequired = 1;
[self addGestureRecognizer:singleTap];
}
#pragma mark --- custom methods
//自動(dòng)滾動(dòng)到下一頁(yè)
-(IBAction)nextPage:(id)sender
{
CGFloat pageWidth = self.scrollView.frame.size.width;
int currentPage = self.scrollView.contentOffset.x/pageWidth;
if (currentPage == 0) {
self.pageControl.currentPage = sourceArr.count-1;
}
else if (currentPage == sourceArr.count+1) {
self.pageControl.currentPage = 0;
}
else {
self.pageControl.currentPage = currentPage-1;
}
NSInteger currPageNumber = self.pageControl.currentPage;
CGSize viewSize = self.scrollView.frame.size;
CGRect rect = CGRectMake((currPageNumber+2)*pageWidth, 0, viewSize.width, viewSize.height);
[self.scrollView scrollRectToVisible:rect animated:YES];
currPageNumber++;
if (currPageNumber == sourceArr.count) {
CGRect newRect=CGRectMake(viewSize.width, 0, viewSize.width, viewSize.height);
[self.scrollView scrollRectToVisible:newRect animated:NO];
currPageNumber = 0;
}
self.pageControl.currentPage = currPageNumber;
lable2.text=[NSString stringWithFormat:@"%zi/%zi",currPageNumber+1,sourceArr.count];
}
//點(diǎn)擊圖片的時(shí)候 觸發(fā)
- (void)singleTap:(UITapGestureRecognizer *)tapGesture
{
if (selectionType != FFScrollViewSelecttionTypeTap) {
return;
}
if (pageViewDelegate && [pageViewDelegate respondsToSelector:@selector(scrollViewDidClickedAtPage:)]) {
[pageViewDelegate scrollViewDidClickedAtPage:self.pageControl.currentPage];
}
}
#pragma mark---- UIScrollView delegate methods
-(void)scrollViewWillBeginDragging:(UIScrollView *)scrollView
{
//開(kāi)始拖動(dòng)scrollview的時(shí)候 停止計(jì)時(shí)器控制的跳轉(zhuǎn)
[timer invalidate];
timer = nil;
}
-(void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView
{
CGFloat width = self.scrollView.frame.size.width;
CGFloat heigth = self.scrollView.frame.size.height;
//當(dāng)手指滑動(dòng)scrollview舷嗡，而scrollview減速停止的時(shí)候 開(kāi)始計(jì)算當(dāng)前的圖片的位置
int currentPage = self.scrollView.contentOffset.x/width;
if (currentPage == 0) {
[self.scrollView scrollRectToVisible:CGRectMake(width*sourceArr.count, 0, width, heigth) animated:NO];
self.pageControl.currentPage = sourceArr.count-1;
}
else if (currentPage == sourceArr.count+1) {
[self.scrollView scrollRectToVisible:CGRectMake(width, 0, width, heigth) animated:NO];
self.pageControl.currentPage = 0;
}
else {
self.pageControl.currentPage = currentPage-1;
}
//拖動(dòng)完畢的時(shí)候 重新開(kāi)始計(jì)時(shí)器控制跳轉(zhuǎn)
timer = [NSTimer scheduledTimerWithTimeInterval:2.0f target:self selector:@selector(nextPage:) userInfo:nil repeats:YES];
}
上面的initPageViewWithFrame方法是我們創(chuàng)建這樣一個(gè)輪播控件的初始化方法....
下面的代碼是我們點(diǎn)擊輪播圖時(shí)的點(diǎn)擊事件,并用代理的方式傳給我們的代理對(duì)象...我們?cè)诖韺?duì)象中實(shí)現(xiàn)這個(gè)方法就可以了
//點(diǎn)擊圖片的時(shí)候 觸發(fā)
- (void)singleTap:(UITapGestureRecognizer *)tapGesture
{
if (selectionType != FFScrollViewSelecttionTypeTap) {
return;
}
if (pageViewDelegate && [pageViewDelegate respondsToSelector:@selector(scrollViewDidClickedAtPage:)]) {
[pageViewDelegate scrollViewDidClickedAtPage:self.pageControl.currentPage];
}
}
3.我們具體看下這個(gè)控件的使用方法
- (id)initPageViewWithFrame:(CGRect)frame views:(NSArray *)views tag:(NSString *)tag
其中views這個(gè)參數(shù)我們可以傳入圖片的鏈接地址(如果圖片來(lái)自于網(wǎng)絡(luò));自然也可以傳入圖片的名稱
先給出創(chuàng)建FFScrollView的代碼片段()
首先遵守這個(gè)協(xié)議@interface HomeViewController : CommonViewController<FFScrollViewDelegate>
然后
//在某個(gè)ViewController的.m文件中
-(void)addTopBanner:(NSArray *)array
{
FFScrollView *ffScroll=[[FFScrollView alloc]initPageViewWithFrame:CGRectMake(0, 0, SCREEN_WIDTH, 150) views:array tag:@"home"];
ffScroll.pageViewDelegate=self;
[scr addSubview:ffScroll];
}
#pragma mark - FFScrollViewDelegate
-(void)scrollViewDidClickedAtPage:(NSInteger)pageNumber
{
//根據(jù)點(diǎn)擊的圖片索引pageNumber,來(lái)編寫(xiě)具體的點(diǎn)擊事件
}
更詳細(xì)的介紹,去查看我gitHub上的代碼吧
https://github.com/BrightMoment/FFScrollView
