MJRefresh适用哪些控件的刷新呢？github官网上给出了四个，其实不难猜到就是主要的那几个可以滚动的控件(UITextView除外)，主要就是四个：UIScrollView、 UITableView、UICollectionView、UIWebView。
API集成
主要的集成方式有两种：
- 自动集成：通过cocoapods集成。
- 手动集成：通过github下载，手动拖动到项目中。
API结构
我们先看一下有哪些源文件。
API结构-1
API结构-2
这个家族的文件就目前的更新情况而言，已经全部在这里了。我们在看一下下面这个图表。
API图表
下面对这个图标进行说明：
- 红色的部分，可直接使用
- 下拉刷新 1）Normal: MJRefreshNormalHeader 2) Gif：MJRefreshGifHeader
- 上拉刷新：1）自动刷新 Normal：MJRefreshAutoNormalFooter 和 Gif：MJRefreshAutoGifFooter 2）自动回弹 Normal：MJRefreshBackNormalFooter 和 Gif：MJRefreshBackGifFooter。
- 其他颜色的部分不可以直接使用。
除了我们直接用，我们还可以DIY刷新，使用下面的。
DIY刷新
API中几个重要的类
1. MJRefreshComponent.h /** The Base Class of refresh control */ @interface MJRefreshComponent : UIView #pragma mark - Control the state of Refresh /** BeginRefreshing */ - (void)beginRefreshing; /** EndRefreshing */ - (void)endRefreshing; /** IsRefreshing */ - (BOOL)isRefreshing; #pragma mark - Other * According to the drag ratio to change alpha automatically @property (assign, nonatomic, getter=isAutomaticallyChangeAlpha) BOOL automaticallyChangeAlpha; @end 2. MJRefreshHeader.h @interface MJRefreshHeader : MJRefreshComponent /** Creat header */ + (instancetype)headerWithRefreshingBlock:(MJRefreshComponentRefreshingBlock)refreshingBlock; /** Creat header */ + (instancetype)headerWithRefreshingTarget:(id)target refreshingAction:(SEL)action; /** This key is used to storage the time that the last time of drown-down successfully */ @property (copy, nonatomic) NSString *lastUpdatedTimeKey; /** The last time of drown-down successfully */ @property (strong, nonatomic, readonly) NSDate *lastUpdatedTime; /** Ignored scrollView contentInset top */ @property (assign, nonatomic) CGFloat ignoredScrollViewContentInsetTop; @end 3. MJRefreshFooter.h @interface MJRefreshFooter : MJRefreshComponent /** Creat footer */ + (instancetype)footerWithRefreshingBlock:(MJRefreshComponentRefreshingBlock)refreshingBlock; /** Creat footer */ + (instancetype)footerWithRefreshingTarget:(id)target refreshingAction:(SEL)action; /** NoticeNoMoreData */ - (void)noticeNoMoreData; /** ResetNoMoreData（Clear the status of NoMoreData ） */ - (void)resetNoMoreData; /** Ignored scrollView contentInset bottom */ @property (assign, nonatomic) CGFloat ignoredScrollViewContentInsetBottom; /** Automaticlly show or hidden by the count of data（Show-have data，Hidden- no data） */ @property (assign, nonatomic) BOOL automaticallyHidden;@end
4. MJRefreshAutoFooter.h @interface MJRefreshAutoFooter : MJRefreshFooter /** Is Automatically Refresh(Default is Yes) */ @property (assign, nonatomic, getter=isAutomaticallyRefresh) BOOL automaticallyRefresh; /** When there is much at the bottom of the control is automatically refresh(Default is 1.0，Is at the bottom of the control appears in full, will refresh automatically) */ @property (assign, nonatomic) CGFloat triggerAutomaticallyRefreshPercent; @end 几种使用方式
下面简单的介绍几种使用方式，内容来源于github。谢谢每一个作者的分享，谢谢大家。
下拉刷新
1. Default模式刷新
self.tableView.header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{ //Call this Block When enter the refresh status automatically }]; 或 // Set the callback（Once you enter the refresh status，then call the action of target，that is call [self loadNewData]） self.tableView.header = [MJRefreshNormalHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)]; // Enter the refresh status immediately [self.tableView.header beginRefreshing]; 看下面的gif图。
default模式
2. 带有动画图片的刷新
// Set the callback（一Once you enter the refresh status，then call the action of target，that is call [self loadNewData]） MJRefreshGifHeader *header = [MJRefreshGifHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)]; // Set the ordinary state of animated images [header setImages:idleImages forState:MJRefreshStateIdle]; // Set the pulling state of animated images（Enter the status of refreshing as soon as loosen） [header setImages:pullingImages forState:MJRefreshStatePulling]; // Set the refreshing state of animated images [header setImages:refreshingImages forState:MJRefreshStateRefreshing]; // Set header self.tableView.mj_header = header; 我们看一下下面的gif图。
animate-image
3. 隐藏时间的刷新
// Hide the time header.lastUpdatedTimeLabel.hidden = YES; 我们看下面的gif图。
hide-time-fresh
4. 隐藏状态和时间的刷新
// Hide the time header.lastUpdatedTimeLabel.hidden = YES; // Hide the status header.stateLabel.hidden = YES; 看下下面的gif图。
hide_time_status_fresh
5. DIY文案刷新
// Set title [header setTitle:@"Pull down to refresh" forState:MJRefreshStateIdle]; [header setTitle:@"Release to refresh" forState:MJRefreshStatePulling]; [header setTitle:@"Loading ..." forState:MJRefreshStateRefreshing]; // Set font header.stateLabel.font = [UIFont systemFontOfSize:15]; header.lastUpdatedTimeLabel.font = [UIFont systemFontOfSize:14]; // Set textColor header.stateLabel.textColor = [UIColor redColor]; header.lastUpdatedTimeLabel.textColor = [UIColor blueColor]; 看一下gif图。
DIY_fresh
6. 自定义控件的刷新
self.tableView.mj_header = [MJDIYHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)]; // Implementation reference to MJDIYHeader.h和MJDIYHeader.m 看下面的gif图。
control_fresh
上拉刷新
1. Default模式刷新
self.tableView.mj_footer = [MJRefreshAutoNormalFooter footerWithRefreshingBlock:^{ //Call this Block When enter the refresh status automatically }]; 或 // Set the callback（Once you enter the refresh status，then call the action of target，that is call [self loadMoreData]） self.tableView.mj_footer = [MJRefreshAutoNormalFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)]; 看下面的gif图。
default_fresh
2. 动画刷新
// Set the callback（Once you enter the refresh status，then call the action of target，that is call [self loadMoreData]） MJRefreshAutoGifFooter *footer = [MJRefreshAutoGifFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)]; // Set the refresh image [footer setImages:refreshingImages forState:MJRefreshStateRefreshing]; // Set footer self.tableView.mj_footer = footer; 看下面的gif图。
animate_image_fresh
3. 隐藏状态的刷新
// Hide the title of refresh status footer.refreshingTitleHidden = YES; // If does have not above method，then use footer.stateLabel.hidden = YES; 看下面的gif图。
hide_status_fresh
4. 全部加载完毕的刷新
//Become the status of NoMoreData [footer noticeNoMoreData]; 我们看下面的gif图。
all_load_fresh
5. DIY文字的刷新
// Set title [footer setTitle:@"Click or drag up to refresh" forState:MJRefreshStateIdle]; [footer setTitle:@"Loading more ..." forState:MJRefreshStateRefreshing]; [footer setTitle:@"No more data" forState:MJRefreshStateNoMoreData]; // Set font footer.stateLabel.font = [UIFont systemFontOfSize:17]; // Set textColor footer.stateLabel.textColor = [UIColor blueColor]; 我们看下面的gif图。
DIY_title_fresh
6. 隐藏footer的刷新
//Hidden current control of the pull to refresh self.tableView.mj_footer.hidden = YES; 我们看gif图。
hide_after_loadall
7. 自动回弹的刷新
self.tableView.mj_footer = [MJRefreshBackNormalFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)]; 我们看一下gif图。
autoback_fresh
8. 图片自动回弹的刷新
MJRefreshBackGifFooter *footer = [MJRefreshBackGifFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)]; // Set the normal state of the animated image [footer setImages:idleImages forState:MJRefreshStateIdle]; // Set the pulling state of animated images（Enter the status of refreshing as soon as loosen） [footer setImages:pullingImages forState:MJRefreshStatePulling]; // Set the refreshing state of animated images [footer setImages:refreshingImages forState:MJRefreshStateRefreshing]; // Set footer self.tableView.mj_footer = footer; 我们看下下面gif图。
autoback_image_fresh
9.自定义控件的自动刷新
self.tableView.mj_footer = [MJDIYAutoFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)]; // Implementation reference to MJDIYAutoFooter.h和MJDIYAutoFooter.m 下面我们看gif图。
autofresh_control_fresh
10.自定义控件的自动回弹刷新
self.tableView.mj_footer = [MJDIYBackFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)]; // Implementation reference to MJDIYBackFooter.h和MJDIYBackFooter.m 我们看下gif图。
autoback_control_fresh
11.上下拉刷新
// The drop-down refresh self.collectionView.mj_header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{ //Call this Block When enter the refresh status automatically }]; // The pull to refresh self.collectionView.mj_footer = [MJRefreshAutoNormalFooter footerWithRefreshingBlock:^{ //Call this Block When enter the refresh status automatically }]; 我们看一下下边的gif图。
up_down_fresh
12.webview下拉刷新
//Add the control of The drop-down refresh self.webView.scrollView.mj_header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{ //Call this Block When enter the refresh status automatically }]; 我们看一下下面的gif图。
webview_fresh
我的一个非常简单的应用举例
我利用MJRefresh非常简单的实现了上拉和下拉刷新，这只是给大家看看的例子，在例子中我利用延时模拟网络加载。希望对入门级的同学会有帮助。
先看代码结构。
代码结构
然后我们看代码。
1. AppDelegate.m #import "AppDelegate.h" #import "JJMainVC.h" @interface AppDelegate () @end @implementation AppDelegate - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds]; JJMainVC *mainVC = [[JJMainVC alloc] init]; UINavigationController *nav = [[UINavigationController alloc] initWithRootViewController:mainVC]; self.window.rootViewController = nav; [self.window makeKeyAndVisible]; return YES; } @end 2. JJMainVC.h #import <UIKit/UIKit.h> @interface JJMainVC : UIViewController @end 3. JJMainVC.m #import "JJMainVC.h" #import "Masonry.h" #import "JJTableViewCell.h" #import "MJRefresh.h" @interface JJMainVC () <UITableViewDelegate, UITableViewDataSource> @property (nonatomic, strong) UITableView *tableView; @property (nonatomic, assign) NSInteger currentPage; @end @implementation JJMainVC static NSString * const kJJMainVCReuseIdentify = @"kJJMainVCReuseIdentify"; #pragma mark - Override Base Function - (void)viewDidLoad { [super viewDidLoad]; self.title = @"MJRefresh Demo"; [self setupUI]; } - (void)viewWillLayoutSubviews { [super viewWillLayoutSubviews]; //tableview [self.tableView mas_makeConstraints:^(MASConstraintMaker *make) { make.left.right.top.bottom.equalTo(self.view); }]; } #pragma mark - Object Private Function - (void)setupUI { //tableview加载 UITableView *tableView = [[UITableView alloc] init]; tableView.rowHeight = 80.0; tableView.delegate = self; tableView.dataSource = self; [tableView registerClass:[JJTableViewCell class] forCellReuseIdentifier:kJJMainVCReuseIdentify]; tableView.backgroundColor = [UIColor lightGrayColor]; [self.view addSubview:tableView]; self.tableView = tableView; //头部刷新控件 tableView.mj_header = [MJRefreshNormalHeader headerWithRefreshingTarget:self refreshingAction:@selector(downFreshloadData)]; [tableView.mj_header beginRefreshing]; //尾部刷新控件 tableView.mj_footer = [MJRefreshAutoNormalFooter footerWithRefreshingTarget:self refreshingAction:@selector(upFreshLoadMoreData)]; [tableView.mj_footer beginRefreshing]; } //下拉刷新 - (void)downFreshloadData { //这里加入的是网络请求，带上相关参数，利用网络工具进行请求。我这里没有网络就模拟一下数据吧。 //网络不管请求成功还是失败都要结束更新。 NSLog(@"我在下拉刷新"); //利用延时函数模拟网络加载 dispatch_time_t time = dispatch_time(DISPATCH_TIME_NOW, (int64_t)(3 * NSEC_PER_SEC)); dispatch_after(time, dispatch_get_main_queue(), ^{ [self.tableView.mj_header endRefreshing]; }); } //上拉加载更多 - (void)upFreshLoadMoreData { //在这里上拉加载更多，将加载的数据拼接在数据源后面就可以了。 //利用延时函数模拟网络加载 dispatch_time_t time = dispatch_time(DISPATCH_TIME_NOW, (int64_t)(3 * NSEC_PER_SEC)); dispatch_after(time, dispatch_get_main_queue(), ^{ [self.tableView.mj_footer endRefreshing]; }); } #pragma mark - UITableViewDelegate, UITableViewDataSource - (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section { return 10; } - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath { JJTableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:kJJMainVCReuseIdentify forIndexPath:indexPath]; return cell; } @end 4. JJTableViewCell.h #import <UIKit/UIKit.h> @interface JJTableViewCell : UITableViewCell @end 5. JJTableViewCell.m #import "JJTableViewCell.h" #import "Masonry.h" @interface JJTableViewCell () @property (nonatomic, strong) UIImageView *avatarImageView; @property (nonatomic, strong) UILabel *nameLabel; @property (nonatomic, strong) UILabel *descLabel; @end @implementation JJTableViewCell #pragma mark - Override Base Function - (instancetype)initWithStyle:(UITableViewCellStyle)style reuseIdentifier:(NSString *)reuseIdentifier { if (self = [super initWithStyle:style reuseIdentifier:reuseIdentifier]) { [self setupUI]; } return self; } - (void)layoutSubviews { [super layoutSubviews]; //头像 [self.avatarImageView mas_makeConstraints:^(MASConstraintMaker *make) { make.centerY.equalTo(self); make.left.equalTo(self).offset(20.0); make.width.height.equalTo(@50); }]; //姓名 [self.nameLabel sizeToFit]; [self.nameLabel mas_makeConstraints:^(MASConstraintMaker *make) { make.left.equalTo(self.avatarImageView.mas_right).offset(20.0); make.top.equalTo(self.avatarImageView); }]; //介绍 [self.descLabel sizeToFit]; [self.descLabel mas_makeConstraints:^(MASConstraintMaker *make) { make.left.equalTo(self.nameLabel); make.bottom.equalTo(self.avatarImageView); }]; } #pragma mark - Object Private Function - (void)setupUI { //头像 UIImageView *avatarImageView = [[UIImageView alloc] init]; avatarImageView.image = [UIImage imageNamed:@"Snip20170430_5.png"]; [self.contentView addSubview:avatarImageView]; self.avatarImageView = avatarImageView; //姓名 UILabel *nameLabel = [[UILabel alloc] init]; nameLabel.text = @"香格里拉"; nameLabel.textColor = [UIColor blueColor]; nameLabel.font = [UIFont systemFontOfSize:14.0]; [self.contentView addSubview:nameLabel]; self.nameLabel = nameLabel; //介绍 UILabel *descLabel = [[UILabel alloc] init]; descLabel.text = @"这是一个迷人的地方，可以去看看~~~"; descLabel.textColor = [UIColor redColor]; descLabel.font = [UIFont systemFontOfSize:14.0]; [self.contentView addSubview:descLabel]; self.descLabel = descLabel; } @end