MJRefresh組織架構(gòu)

image
1.導(dǎo)入MJRefresh到項(xiàng)目中
cocoapods導(dǎo)入:pod 'MJRefresh'
將MJRefresh文件夾中的所有內(nèi)容拖拽進(jìn)項(xiàng)目中。
兩種方式任選其一。使用時(shí)別忘記引入頭文件:#import "MJRefresh.h"
2.UITableView下拉刷新和上拉刷新
2.1 默認(rèn)下拉界面
// 設(shè)置回調(diào)(一旦進(jìn)入刷新狀態(tài)就會調(diào)用這個(gè)refreshingBlock)
self.tableView.mj_header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{
//進(jìn)行數(shù)據(jù)刷新操作
}];
// 馬上進(jìn)入刷新狀態(tài)
[self.tableView.mj_header beginRefreshing];
2.2 下拉刷新設(shè)置動畫圖片
// 設(shè)置回調(diào)(一旦進(jìn)入刷新狀態(tài),就調(diào)用target的action,也就是調(diào)用self的loadNewData方法)
self.tableView.mj_header = [MJChiBaoZiHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)];
// 馬上進(jìn)入刷新狀態(tài)
[self.tableView.mj_header beginRefreshing];
ps:MJChiBaoZiHeader是繼承自MJRefreshGifHeader,在這里面可以自定義加載動畫圖片
#import "MJChiBaoZiHeader.h"
@implementation MJChiBaoZiHeader
#pragma mark - 重寫方法
#pragma mark 基本設(shè)置
- (void)prepare
{
[super prepare];
// 設(shè)置普通狀態(tài)的動畫圖片
NSMutableArray *idleImages = [NSMutableArray array];
for (NSUInteger i = 1; i<=60; i++) {
UIImage *image = [UIImage imageNamed:[NSString stringWithFormat:@"dropdown_anim__000%zd", i]];
[idleImages addObject:image];
}
[self setImages:idleImages forState:MJRefreshStateIdle];
// 設(shè)置即將刷新狀態(tài)的動畫圖片(一松開就會刷新的狀態(tài))
NSMutableArray *refreshingImages = [NSMutableArray array];
for (NSUInteger i = 1; i<=3; i++) {
UIImage *image = [UIImage imageNamed:[NSString stringWithFormat:@"dropdown_loading_0%zd", i]];
[refreshingImages addObject:image];
}
[self setImages:refreshingImages forState:MJRefreshStatePulling];
// 設(shè)置正在刷新狀態(tài)的動畫圖片
[self setImages:refreshingImages forState:MJRefreshStateRefreshing];
}
@end
2.3 默認(rèn)下拉刷新+隱藏時(shí)間
// 設(shè)置回調(diào)(一旦進(jìn)入刷新狀態(tài),就調(diào)用target的action,也就是調(diào)用self的loadNewData方法)
MJRefreshNormalHeader *header = [MJRefreshNormalHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)];
// 設(shè)置自動切換透明度(在導(dǎo)航欄下面自動隱藏)
header.automaticallyChangeAlpha = YES;
// 隱藏時(shí)間
header.lastUpdatedTimeLabel.hidden = YES;
// 馬上進(jìn)入刷新狀態(tài)
[header beginRefreshing];
// 設(shè)置header
self.tableView.mj_header = header;
2.4 默認(rèn)下拉刷新+隱藏時(shí)間、隱藏狀態(tài)
// 設(shè)置回調(diào)(一旦進(jìn)入刷新狀態(tài),就調(diào)用target的action,也就是調(diào)用self的loadNewData方法)
MJChiBaoZiHeader *header = [MJChiBaoZiHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)];
// 隱藏時(shí)間
header.lastUpdatedTimeLabel.hidden = YES;
// 隱藏狀態(tài)
header.stateLabel.hidden = YES;
// 馬上進(jìn)入刷新狀態(tài)
[header beginRefreshing];
// 設(shè)置header
self.tableView.mj_header = header;
2.5 默認(rèn)下拉刷新+自定義文字
// 設(shè)置回調(diào)(一旦進(jìn)入刷新狀態(tài),就調(diào)用target的action,也就是調(diào)用self的loadNewData方法)
MJRefreshNormalHeader *header = [MJRefreshNormalHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)];
// 設(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];
// 馬上進(jìn)入刷新狀態(tài)
[header beginRefreshing];
// 設(shè)置刷新控件
self.tableView.mj_header = header;
2.6 下拉刷新+自定義header
// 設(shè)置回調(diào)(一旦進(jìn)入刷新狀態(tài),就調(diào)用target的action,也就是調(diào)用self的loadNewData方法)
self.tableView.mj_header = [MJDIYHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)];
[self.tableView.mj_header beginRefreshing];
ps: MJDIYHeader是繼承自MJRefreshHeader,在這里面進(jìn)行自定義header視圖的操作
#import "MJDIYHeader.h"
@interface MJDIYHeader()
//在這里聲明子控件的全局變量
@end
@implementation MJDIYHeader
#pragma mark - 重寫方法
#pragma mark 在這里做一些初始化配置(比如添加子控件)
- (void)prepare
{
[super prepare];
// 設(shè)置控件的高度
self.mj_h = 50;
// 在這里添加子控件
}
#pragma mark 在這里設(shè)置子控件的位置和尺寸
- (void)placeSubviews
{
[super placeSubviews];
//在這里設(shè)置子控件的位置和尺寸
}
#pragma mark 監(jiān)聽scrollView的contentOffset改變
- (void)scrollViewContentOffsetDidChange:(NSDictionary *)change
{
[super scrollViewContentOffsetDidChange:change];
}
#pragma mark 監(jiān)聽scrollView的contentSize改變
- (void)scrollViewContentSizeDidChange:(NSDictionary *)change
{
[super scrollViewContentSizeDidChange:change];
}
#pragma mark 監(jiān)聽scrollView的拖拽狀態(tài)改變
- (void)scrollViewPanStateDidChange:(NSDictionary *)change
{
[super scrollViewPanStateDidChange:change];
}
#pragma mark 監(jiān)聽控件的刷新狀態(tài)
- (void)setState:(MJRefreshState)state
{
MJRefreshCheckState;
switch (state) {
case MJRefreshStateIdle:
/** 普通閑置狀態(tài) */
//在這里設(shè)置子控件在普通閑置狀態(tài)的界面展示
break;
case MJRefreshStatePulling:
/** 松開就可以進(jìn)行刷新的狀態(tài) */
//在這里設(shè)置子控件在松開就可以進(jìn)行刷新的狀態(tài)的界面展示
break;
case MJRefreshStateRefreshing:
/** 正在刷新中的狀態(tài) */
//在這里設(shè)置子控件在正在刷新中的狀態(tài)的界面展示
break;
default:
break;
}
}
#pragma mark 監(jiān)聽拖拽比例(控件被拖出來的比例)
- (void)setPullingPercent:(CGFloat)pullingPercent
{
[super setPullingPercent:pullingPercent];
}
@end
2.7 上拉刷新 默認(rèn)界面
// 設(shè)置回調(diào)(一旦進(jìn)入刷新狀態(tài)就會調(diào)用這個(gè)refreshingBlock)
self.tableView.mj_footer = [MJRefreshAutoNormalFooter footerWithRefreshingBlock:^{
[weakSelf loadMoreData];
}];
2.8 上拉刷新+設(shè)置動畫
// 設(shè)置回調(diào)(一旦進(jìn)入刷新狀態(tài),就調(diào)用target的action,也就是調(diào)用self的loadMoreData方法)
self.tableView.mj_footer = [MJChiBaoZiFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];
#import "MJChiBaoZiFooter.h"
@implementation MJChiBaoZiFooter
#pragma mark - 重寫方法
#pragma mark 基本設(shè)置
- (void)prepare
{
[super prepare];
// 設(shè)置正在刷新狀態(tài)的動畫圖片
NSMutableArray *refreshingImages = [NSMutableArray array];
for (NSUInteger i = 1; i<=3; i++) {
UIImage *image = [UIImage imageNamed:[NSString stringWithFormat:@"dropdown_loading_0%zd", i]];
[refreshingImages addObject:image];
}
[self setImages:refreshingImages forState:MJRefreshStateRefreshing];
}
@end
2.9 上拉刷新 隱藏刷新狀態(tài)的文字
// 設(shè)置回調(diào)(一旦進(jìn)入刷新狀態(tài),就調(diào)用target的action,也就是調(diào)用self的loadMoreData方法)
MJChiBaoZiFooter *footer = [MJChiBaoZiFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];
// 當(dāng)上拉刷新控件出現(xiàn)50%時(shí)(出現(xiàn)一半),就會自動刷新。這個(gè)值默認(rèn)是1.0(也就是上拉刷新100%出現(xiàn)時(shí),才會自動刷新)
// footer.triggerAutomaticallyRefreshPercent = 0.5;
// 隱藏刷新狀態(tài)的文字
footer.refreshingTitleHidden = YES;
// 設(shè)置footer
self.tableView.mj_footer = footer;
2.10 上拉刷新 禁止自動加載
// 設(shè)置回調(diào)(一旦進(jìn)入刷新狀態(tài),就調(diào)用target的action,也就是調(diào)用self的loadMoreData方法)
MJRefreshAutoNormalFooter *footer = [MJRefreshAutoNormalFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];
// 禁止自動加載
footer.automaticallyRefresh = NO;
// 設(shè)置footer
self.tableView.mj_footer = footer;
2.11 上拉刷新 自定義文字
// 設(shè)置回調(diào)(一旦進(jìn)入刷新狀態(tài),就調(diào)用target的action,也就是調(diào)用self的loadMoreData方法)
MJRefreshAutoNormalFooter *footer = [MJRefreshAutoNormalFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];
// 設(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];
// 設(shè)置footer
self.tableView.mj_footer = footer;
3.UIWebView的下拉刷新和上拉刷新
#pragma mark - 示例
- (void)example31
{
__weak UIWebView *webView = self.webView;
webView.delegate = self;
__weak UIScrollView *scrollView = self.webView.scrollView;
// 添加下拉刷新控件
scrollView.mj_header= [MJRefreshNormalHeader headerWithRefreshingBlock:^{
[webView reload];
}];
// 如果是上拉刷新,就以此類推
}
#pragma mark - webViewDelegate
- (void)webViewDidFinishLoad:(nonnull UIWebView *)webView
{
[self.webView.scrollView.mj_header endRefreshing];
}
4.UICollectionView的下拉刷新和上拉刷新
#pragma mark - 示例
#pragma mark UICollectionView 上下拉刷新
- (void)example21
{
__weak __typeof(self) weakSelf = self;
// 下拉刷新
self.collectionView.mj_header= [MJRefreshNormalHeader headerWithRefreshingBlock:^{
// 增加5條假數(shù)據(jù)
for (int i = 0; i<10; i++) {
[weakSelf.colors insertObject:MJRandomColor atIndex:0];
}
// 模擬延遲加載數(shù)據(jù),因此2秒后才調(diào)用(真實(shí)開發(fā)中,可以移除這段gcd代碼)
dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(MJDuration * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
[weakSelf.collectionView reloadData];
// 結(jié)束刷新
[weakSelf.collectionView.mj_header endRefreshing];
});
}];
[self.collectionView.mj_header beginRefreshing];
// 上拉刷新
self.collectionView.mj_footer = [MJRefreshBackNormalFooter footerWithRefreshingBlock:^{
// 增加5條假數(shù)據(jù)
for (int i = 0; i<5; i++) {
[weakSelf.colors addObject:MJRandomColor];
}
// 模擬延遲加載數(shù)據(jù),因此2秒后才調(diào)用(真實(shí)開發(fā)中,可以移除這段gcd代碼)
dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(MJDuration * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
[weakSelf.collectionView reloadData];
// 結(jié)束刷新
[weakSelf.collectionView.mj_footer endRefreshing];
});
}];
// 默認(rèn)先隱藏footer
self.collectionView.mj_footer.hidden = YES;
}