MJRefresh
An easy way to use pull-to-refresh
用法簡單的下拉刷新框架：一行代碼搞定
Contents
Getting StartedFeatures【支持哪些控件的刷新】
Installation【如何使用MJRefresh】
Who's using【已經(jīng)超過上百個App正在使用MJRefresh】
Classes【MJRefresh類結(jié)構(gòu)圖】
常見APIMJRefreshComponent.h
MJRefreshHeader.h
MJRefreshFooter.h
MJRefreshAutoFooter.h
ExamplesReference【參考】
下拉刷新01-默認(rèn)
下拉刷新02-動畫圖片
下拉刷新03-隱藏時間
下拉刷新04-隱藏狀態(tài)和時間
下拉刷新05-自定義文字
下拉刷新06-自定義刷新控件
上拉刷新01-默認(rèn)
上拉刷新02-動畫圖片
上拉刷新03-隱藏刷新狀態(tài)的文字
上拉刷新04-全部加載完畢
上拉刷新05-自定義文字
上拉刷新06-加載后隱藏
上拉刷新07-自動回彈的上拉01
上拉刷新08-自動回彈的上拉02
上拉刷新09-自定義刷新控件(自動刷新)
上拉刷新10-自定義刷新控件(自動回彈)
UICollectionView01-上下拉刷新
UIWebView01-下拉刷新
UIScrollView
UITableView
UICollectionView
UIWebView
cocoapods導(dǎo)入：pod 'MJRefresh'
手動導(dǎo)入：將MJRefresh
文件夾中的所有文件拽入項目中
導(dǎo)入主頭文件：#import "MJRefresh.h"
Base CustomMJRefresh.bundle MJRefresh.hMJRefreshConst.h MJRefreshConst.mUIScrollView+MJExtension.h UIScrollView+MJExtension.mUIScrollView+MJRefresh.h UIScrollView+MJRefresh.mUIView+MJExtension.h UIView+MJExtension.m
已經(jīng)超過上百個App正在使用MJRefresh
[圖片上傳中蛛碌。让禀。屁柏。（1）]
更多App信息可以關(guān)注：M了個J-博客園
MJRefresh類結(jié)構(gòu)圖
[圖片上傳中。褥蚯。。（2）]
圖中紅色文字的類
：可以直接拿來用下拉刷新控件的種類默認(rèn)（Normal）：MJRefreshNormalHeader
動圖（Gif）：MJRefreshGifHeader
上拉刷新控件的種類自動刷新（Auto）默認(rèn)（Normal）：MJRefreshAutoNormalFooter
動圖（Gif）：MJRefreshAutoGifFooter
自動回彈（Back）默認(rèn)（Normal）：MJRefreshBackNormalFooter
動圖（Gif）：MJRefreshBackGifFooter
圖中非紅色文字的類
：拿來繼承奴拦，用于自定義刷新控件
關(guān)于如何自定義刷新控件畦攘，可以參考下圖的類[圖片上傳中。李茫。揭保。（3）]
/** 刷新控件的基類 */@interface MJRefreshComponent : UIView#pragma mark - 刷新狀態(tài)控制/** 進(jìn)入刷新狀態(tài) */- (void)beginRefreshing;/** 結(jié)束刷新狀態(tài) */- (void)endRefreshing;/** 是否正在刷新 */- (BOOL)isRefreshing;#pragma mark - 其他/** 根據(jù)拖拽比例自動切換透明度 */@property (assign, nonatomic, getter=isAutomaticallyChangeAlpha) BOOL automaticallyChangeAlpha;@end
@interface MJRefreshHeader : MJRefreshComponent/** 創(chuàng)建header */+ (instancetype)headerWithRefreshingBlock:(MJRefreshComponentRefreshingBlock)refreshingBlock;/** 創(chuàng)建header */+ (instancetype)headerWithRefreshingTarget:(id)target refreshingAction:(SEL)action;/** 這個key用來存儲上一次下拉刷新成功的時間 */@property (copy, nonatomic) NSString *lastUpdatedTimeKey;/** 上一次下拉刷新成功的時間 */@property (strong, nonatomic, readonly) NSDate *lastUpdatedTime;/** 忽略多少scrollView的contentInset的top */@property (assign, nonatomic) CGFloat ignoredScrollViewContentInsetTop;@end
@interface MJRefreshFooter : MJRefreshComponent/** 創(chuàng)建footer */+ (instancetype)footerWithRefreshingBlock:(MJRefreshComponentRefreshingBlock)refreshingBlock;/** 創(chuàng)建footer */+ (instancetype)footerWithRefreshingTarget:(id)target refreshingAction:(SEL)action;/** 提示沒有更多的數(shù)據(jù) */- (void)noticeNoMoreData;/** 重置沒有更多的數(shù)據(jù)（消除沒有更多數(shù)據(jù)的狀態(tài)） */- (void)resetNoMoreData;/** 忽略多少scrollView的contentInset的bottom */@property (assign, nonatomic) CGFloat ignoredScrollViewContentInsetBottom;/** 自動根據(jù)有無數(shù)據(jù)來顯示和隱藏（有數(shù)據(jù)就顯示，沒有數(shù)據(jù)隱藏） */@property (assign, nonatomic) BOOL automaticallyHidden;@end
@interface MJRefreshAutoFooter : MJRefreshFooter/** 是否自動刷新(默認(rèn)為YES) */@property (assign, nonatomic, getter=isAutomaticallyRefresh) BOOL automaticallyRefresh;/** 當(dāng)?shù)撞靠丶霈F(xiàn)多少時就自動刷新(默認(rèn)為1.0魄宏，也就是底部控件完全出現(xiàn)時秸侣，才會自動刷新) */@property (assign, nonatomic) CGFloat triggerAutomaticallyRefreshPercent;@end
* 由于這個框架的功能較多，就不寫具體文字描述其用法* 大家可以直接參考示例中的MJTableViewController、MJCollectionViewController味榛、MJWebViewController椭坚，更為直觀快速
[圖片上傳中。搏色。善茎。（4）]
下拉刷新01-默認(rèn)
self.tableView.header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{ // 進(jìn)入刷新狀態(tài)后會自動調(diào)用這個block}];或// 設(shè)置回調(diào)（一旦進(jìn)入刷新狀態(tài)，就調(diào)用target的action继榆，也就是調(diào)用self的loadNewData方法）self.tableView.header = [MJRefreshNormalHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)];// 馬上進(jìn)入刷新狀態(tài)[self.tableView.header beginRefreshing];
[圖片上傳中巾表。。略吨。（5）]
下拉刷新02-動畫圖片
// 設(shè)置回調(diào)（一旦進(jìn)入刷新狀態(tài)，就調(diào)用target的action考阱，也就是調(diào)用self的loadNewData方法）MJRefreshGifHeader *header = [MJRefreshGifHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)];// 設(shè)置普通狀態(tài)的動畫圖片[header setImages:idleImages forState:MJRefreshStateIdle];// 設(shè)置即將刷新狀態(tài)的動畫圖片（一松開就會刷新的狀態(tài)）[header setImages:pullingImages forState:MJRefreshStatePulling];// 設(shè)置正在刷新狀態(tài)的動畫圖片[header setImages:refreshingImages forState:MJRefreshStateRefreshing];// 設(shè)置headerself.tableView.header = header;
[圖片上傳中翠忠。。乞榨。（6）]
下拉刷新03-隱藏時間
// 隱藏時間header.lastUpdatedTimeLabel.hidden = YES;
[圖片上傳中秽之。。吃既。（7）]
下拉刷新04-隱藏狀態(tài)和時間
// 隱藏時間header.lastUpdatedTimeLabel.hidden = YES;// 隱藏狀態(tài)header.stateLabel.hidden = YES;
[圖片上傳中考榨。。鹦倚。（8）]
下拉刷新05-自定義文字
// 設(shè)置文字[header setTitle:@"Pull down to refresh" forState:MJRefreshStateIdle];[header setTitle:@"Release to refresh" forState:MJRefreshStatePulling];[header setTitle:@"Loading ..." forState:MJRefreshStateRefreshing];// 設(shè)置字體header.stateLabel.font = [UIFont systemFontOfSize:15];header.lastUpdatedTimeLabel.font = [UIFont systemFontOfSize:14];// 設(shè)置顏色header.stateLabel.textColor = [UIColor redColor];header.lastUpdatedTimeLabel.textColor = [UIColor blueColor];
[圖片上傳中河质。。震叙。（9）]
下拉刷新06-自定義刷新控件
self.tableView.header = [MJDIYHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)];// 具體實現(xiàn)參考MJDIYHeader.h和MJDIYHeader.m
[圖片上傳中掀鹅。。媒楼。（10）]
上拉刷新01-默認(rèn)
self.tableView.footer = [MJRefreshAutoNormalFooter footerWithRefreshingBlock:^{ // 進(jìn)入刷新狀態(tài)后會自動調(diào)用這個block}];或// 設(shè)置回調(diào)（一旦進(jìn)入刷新狀態(tài)乐尊，就調(diào)用target的action，也就是調(diào)用self的loadMoreData方法）self.tableView.footer = [MJRefreshAutoNormalFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];
[圖片上傳中划址。扔嵌。。（11）]
上拉刷新02-動畫圖片
// 設(shè)置回調(diào)（一旦進(jìn)入刷新狀態(tài)夺颤，就調(diào)用target的action痢缎，也就是調(diào)用self的loadMoreData方法）MJRefreshAutoGifFooter *footer = [MJRefreshAutoGifFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];// 設(shè)置刷新圖片[footer setImages:refreshingImages forState:MJRefreshStateRefreshing];// 設(shè)置尾部self.tableView.footer = footer;
[圖片上傳中。拂共。牺弄。（12）]
上拉刷新03-隱藏刷新狀態(tài)的文字
// 隱藏刷新狀態(tài)的文字footer.refreshingTitleHidden = YES;// 如果沒有上面的方法，就用footer.stateLabel.hidden = YES;
[圖片上傳中宜狐。势告。蛇捌。（13）]
上拉刷新04-全部加載完畢
// 變?yōu)闆]有更多數(shù)據(jù)的狀態(tài)[footer noticeNoMoreData];
[圖片上傳中。咱台。络拌。（14）]
上拉刷新05-自定義文字
// 設(shè)置文字[footer setTitle:@"Click or drag up to refresh" forState:MJRefreshStateIdle];[footer setTitle:@"Loading more ..." forState:MJRefreshStateRefreshing];[footer setTitle:@"No more data" forState:MJRefreshStateNoMoreData];// 設(shè)置字體footer.stateLabel.font = [UIFont systemFontOfSize:17];// 設(shè)置顏色footer.stateLabel.textColor = [UIColor blueColor];
[圖片上傳中。回溺。春贸。（15）]
上拉刷新06-加載后隱藏
// 隱藏當(dāng)前的上拉刷新控件self.tableView.footer.hidden = YES;
[圖片上傳中。遗遵。萍恕。（16）]
上拉刷新07-自動回彈的上拉01
self.tableView.footer = [MJRefreshBackNormalFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];
[圖片上傳中。车要。允粤。（17）]
上拉刷新08-自動回彈的上拉02
MJRefreshBackGifFooter *footer = [MJRefreshBackGifFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];// 設(shè)置普通狀態(tài)的動畫圖片[footer setImages:idleImages forState:MJRefreshStateIdle];// 設(shè)置即將刷新狀態(tài)的動畫圖片（一松開就會刷新的狀態(tài)）[footer setImages:pullingImages forState:MJRefreshStatePulling];// 設(shè)置正在刷新狀態(tài)的動畫圖片[footer setImages:refreshingImages forState:MJRefreshStateRefreshing];// 設(shè)置尾部self.tableView.footer = footer;
[圖片上傳中。翼岁。类垫。（18）]
上拉刷新09-自定義刷新控件(自動刷新)
self.tableView.footer = [MJDIYAutoFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];// 具體實現(xiàn)參考MJDIYAutoFooter.h和MJDIYAutoFooter.m
[圖片上傳中。琅坡。悉患。（19）]
上拉刷新10-自定義刷新控件(自動回彈)
self.tableView.footer = [MJDIYBackFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];// 具體實現(xiàn)參考MJDIYBackFooter.h和MJDIYBackFooter.m
[圖片上傳中。榆俺。售躁。（20）]
UICollectionView01-上下拉刷新
// 下拉刷新self.collectionView.header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{ // 進(jìn)入刷新狀態(tài)后會自動調(diào)用這個block}];// 上拉刷新self.collectionView.footer = [MJRefreshAutoNormalFooter footerWithRefreshingBlock:^{ // 進(jìn)入刷新狀態(tài)后會自動調(diào)用這個block}];
[圖片上傳中。谴仙。迂求。（21）]
UIWebView01-下拉刷新
// 添加下拉刷新控件self.webView.scrollView.header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{ // 進(jìn)入刷新狀態(tài)后會自動調(diào)用這個block}];
[圖片上傳中。晃跺。揩局。（22）]
提醒
本框架純ARC，兼容的系統(tǒng)>=iOS6.0掀虎、iPhone\iPad橫豎屏
