俗話說 “工欲善其事,必先利其器”,好的成熟的第三方,是我們開發路上的利器;俗話又說“君子生非異也,善假於物也”
NB的人並不是生下來就和別人不一樣,只是他們擅於使用工具罷了!
,熟練使用這些第三方,你就是開發者的"君子"!本篇旨在更詳細指導怎么使用對應的第三方,不會過多說明第三方怎么實現!
就像你買了部新手機,說明書只說明怎么使用(及注意事項),並不說明手機由什么構造以及怎么制造!
。
PPDemos地址
注意demo用的是3.1.2版本,運行可能出現Terminating app due to uncaught exception 'NSRangeException', reason: '*** -[NSTaggedPointerString substringToIndex:]: Index 9223372036854775807 out of bounds; string length 2'
,請更新到最新就好了2016--07--04
一. 新舊版本比較
舊版本使用說明
#import "UIScrollView+MJRefresh.h" /** MJ友情提示: 1. 添加頭部控件的方法 [self.tableView addHeaderWithTarget:self action:@selector(headerRereshing)]; 或者 [self.tableView addHeaderWithCallback:^{ }]; 2. 添加尾部控件的方法 [self.tableView addFooterWithTarget:self action:@selector(footerRereshing)]; 或者 [self.tableView addFooterWithCallback:^{ }]; 3. 可以在MJRefreshConst.h和MJRefreshConst.m文件中自定義顯示的文字內容和文字顏色 4. 本框架兼容iOS6\\\\iOS7,iPhone\\\\iPad橫豎屏 5.自動進入刷新狀態 1> [self.tableView headerBeginRefreshing]; 2> [self.tableView footerBeginRefreshing]; 6.結束刷新 1> [self.tableView headerEndRefreshing]; 2> [self.tableView footerEndRefreshing]; */
新版本介紹
version= '3.1.5',2016-06-13
1.添加前綴mj_
;
2.支持國際化zh-Hans(簡體中文)
,zh-Hant(繁體中文)
,en(英文)
3.可以自定義刷新控件
4.更加自由化,支持文字,圖片,GIF等混合搭配(有點扯
)最新的MJRefresh的GitHub倉庫截圖如
圖mj-01
:![]()
圖mj-01 MJRefresh的GitHub倉庫截圖
二.MJRefresh解析
1 . MJRefresh的框架圖如圖mj-02
:

2 . MJRefresh的框架圖梳理
類 | 作用 |
---|---|
MJRefreshComponent | 繼承自UIView ,最基本的刷新類 |
MJRefreshHeader | 最基本的下拉刷新類 |
MJRefreshStateHeader | 可以下拉刷新,但是只有文字 |
MJRefreshNormalHeader | 默認的刷新樣式,有文字,有上下箭頭,有菊花 |
抱歉說下:上面MJ的框架圖說的已經很詳細了,具體的上拉加載更多就不寫了
3 . MJRefresh使用技巧或建議
3.1 無論是下拉刷新還是上拉加載,都最好使用
圖mj-02
分支最后面的某一個,因為越后面分工越詳細,刷新控件處理的越細致;
3.2 自定義刷新控件,后面有講解
;
三 .MJRefresh詳細使用指導所有說明都配合代碼講解
① MJRefresh默認的
下拉刷新
和上拉加載
- (void)viewDidLoad { [super viewDidLoad]; // Do any additional setup after loading the view. //默認【下拉刷新】 self.tableView.mj_header = [MJRefreshNormalHeader headerWithRefreshingTarget:self refreshingAction:@selector(refresh)]; //默認【上拉加載】 self.tableView.mj_footer = [MJRefreshAutoNormalFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMore)]; } -(void)refresh { [self getNetworkData:YES]; } -(void)loadMore { [self getNetworkData:NO]; }
② MJRefresh默認的
下拉刷新
和上拉加載
【使用Block方法】
- (void)viewDidLoad { [super viewDidLoad]; // Do any additional setup after loading the view. __weak typeof(self) weakSelf = self; //默認block方法:設置下拉刷新 self.tableView.mj_header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{ [weakSelf getNetworkData:YES]; }]; //默認block方法:設置上拉加載更多 self.tableView.mj_footer = [MJRefreshAutoNormalFooter footerWithRefreshingBlock:^{ //Call this Block When enter the refresh status automatically [weakSelf getNetworkData:NO]; }]; }
③ MJRefresh更自定義化的
下拉刷新
和上拉加載
- 動畫圖片樣式;
- 隱藏刷新控件狀態或者時間樣式;
- 自定義刷新狀態和刷新時間文字樣式【當然了,對應的Label不能隱藏】
- (void)viewDidLoad { [super viewDidLoad]; //樣式一:設置一張圖片(無動畫效果) // NSArray *idleImages = [NSArray arrayWithObject:[UIImage imageNamed:@"xiala_icon.png"]]; //樣式二:設置多張圖片(有動畫效果) NSArray *idleImages = [NSArray arrayWithObjects: [UIImage imageNamed:@"dropdown_loading_01.png"], [UIImage imageNamed:@"dropdown_loading_02.png"], [UIImage imageNamed:@"dropdown_loading_03.png"],nil]; NSArray *pullingImages = [NSArray arrayWithObject:[UIImage imageNamed:@"shifang_icon.png"]]; NSArray *refreshingImages = [NSArray arrayWithObjects: [UIImage imageNamed:@"load_view_01.png"], [UIImage imageNamed:@"load_view_02.png"], [UIImage imageNamed:@"load_view_03.png"], [UIImage imageNamed:@"load_view_04.png"], [UIImage imageNamed:@"load_view_05.png"], [UIImage imageNamed:@"load_view_06.png"], [UIImage imageNamed:@"load_view_07.png"], [UIImage imageNamed:@"load_view_08.png"], [UIImage imageNamed:@"load_view_09.png"], [UIImage imageNamed:@"load_view_010.png"], nil]; // MJRefreshGifHeader *header = [MJRefreshGifHeader headerWithRefreshingTarget:self refreshingAction:@selector(animationRefresh)]; //-------以下是使用block方法【不包含animationRefresh方法】,動畫設置在上面的部分代碼--------- __weak typeof(self) weakSelf = self; MJRefreshGifHeader *header = [MJRefreshGifHeader headerWithRefreshingBlock:^{ [weakSelf getNetworkData:YES]; }]; //-------以上是使用block方法【不包含animationRefresh方法】,動畫設置在上面的部分代碼--------- //1.設置普通狀態的動畫圖片 [header setImages:idleImages forState:MJRefreshStateIdle]; //2.設置即將刷新狀態的動畫圖片(一松開就會刷新的狀態) [header setImages:pullingImages forState:MJRefreshStatePulling]; //3.設置正在刷新狀態的動畫圖片 [header setImages:refreshingImages forState:MJRefreshStateRefreshing]; self.tableView.mj_header = header; #pragma mark --- 下面兩個設置根據各自需求設置 // // 隱藏更新時間 // header.lastUpdatedTimeLabel.hidden = YES; // // // 隱藏刷新狀態 // header.stateLabel.hidden = YES; #pragma mark --- 自定義刷新狀態和刷新時間文字【當然了,對應的Label不能隱藏】 // 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]; } #pragma mark --- "動畫圖片"樣式的非block方法 -(void)animationRefresh { [self getNetworkData:YES]; }
④ MJRefresh完全自定義化的
下拉刷新
和上拉加載
④-1. 最終調用
- (void)viewDidLoad { [super viewDidLoad]; //MJRefresh自定義刷新控件 __weak typeof(self) weakSelf = self; self.tableView.mj_header = [MJDIYHeader headerWithRefreshingBlock:^{ [weakSelf getNetworkData:YES]; }]; }
④-2. 完全自定義的下拉刷新控件上拉暫還沒看
更多信息請參看MJDIYHeade.m 更多信息請參看MJDIYHeade.m 更多信息請參看MJDIYHeade.m (嘿嘿,我錯了,當然不能這樣忽悠過了,請往下繼續......)
④-3. 【附】:MJRefresh自定義刷新控件步驟(just 3 步)重要
說明:最好參考MJDIYHeader.m來學習,就不一一截圖說明
① 首先創建一個類(譬如MJDIYHeader),繼承自MJRefreshHeader;
② 重寫相關方法 【 在MJRefreshComponent.h
中有下面的提示】
#pragma mark - 交給子類們去實現 /** 初始化 */ #pragma mark 在這里做一些初始化配置(比如添加子控件) -(void)prepare NS_REQUIRES_SUPER; /** 擺放子控件frame */ #pragma mark 在這里設置子控件的位置和尺寸 -(void)placeSubviews NS_REQUIRES_SUPER; /** 當scrollView的contentOffset發生改變的時候調用 */ -(void)scrollViewContentOffsetDidChange:(NSDictionary *)change NS_REQUIRES_SUPER; /** 當scrollView的contentSize發生改變的時候調用 */ -(void)scrollViewContentSizeDidChange:(NSDictionary *)change NS_REQUIRES_SUPER; /** 當scrollView的拖拽狀態發生改變的時候調用 */ -(void)scrollViewPanStateDidChange:(NSDictionary *)change NS_REQUIRES_SUPER;
③ 調用!OK啦!嘿嘿!
四. 最后,上面的刷新和加載這么簡單,等等,還有一點注意呢
下拉刷新 --- 獲取最新數據;
上拉加載 --- 獲取更多數據;
四-1. PPDemos中的刷新類都是繼承自MJViewController
的,所以在刷新和加載的類MJDefaultViewController
,MJDefaultBlockViewController
,MJAnimationImageViewController
,MJCustomRefreshViewController
中,只需要在viewDidLoad
中調用即可;
四-2. MJViewController.h 父類的,子類都可以用
// // MJViewController.h // MJDemos // // Created by Abner on 16/6/13. // Copyright © 2016年 PPAbner. All rights reserved. // #import <UIKit/UIKit.h> @interface MJViewController : UIViewController { int page; BOOL isFirstCome; //第一次加載帖子時候不需要傳入此關鍵字,當需要加載下一頁時:需要傳入加載上一頁時返回值字段“maxtime”中的內容。 int totalPage;//總頁數 BOOL isJuhua;//是否正在下拉刷新或者上拉加載。default NO。 } @property(nonatomic,strong)NSMutableArray *pictures; @property(nonatomic,strong)UITableView *tableView; /** maxtime */ @property(nonatomic,copy)NSString *maxtime; /** * 獲取網絡數據 * @param isRefresh 是否是下拉刷新 */ -(void)getNetworkData:(BOOL)isRefresh; @end
四-3. MJViewController.m
// // MJViewController.m // MJDemos // // Created by Abner on 16/6/13. // Copyright © 2016年 PPAbner. All rights reserved. // #import "MJViewController.h" #import "MJPicture.h" @interface MJViewController ()<UITableViewDelegate,UITableViewDataSource> @end @implementation MJViewController -(void)viewWillDisappear:(BOOL)animated { isFirstCome = YES; } //一進來就讓自動刷新 -(void)viewWillAppear:(BOOL)animated { [self.tableView.mj_header beginRefreshing]; } - (void)viewDidLoad { [super viewDidLoad]; page = 0; isFirstCome = YES; isJuhua = NO; [self creatUI]; } /** * 停止刷新 */ -(void)endRefresh{ if (page == 0) { [self.tableView.mj_header endRefreshing]; } [self.tableView.mj_footer endRefreshing]; } -(void)creatUI { self.tableView = [[UITableView alloc]initWithFrame:CGRectMake(0, 0, ScreenWidth, ScreenHeight) style:UITableViewStylePlain]; self.tableView.delegate =self; self.tableView.dataSource =self; [self.view addSubview:self.tableView]; self.tableView.tableFooterView = [UIView new]; self.tableView.separatorStyle = UITableViewCellSeparatorStyleNone; } -(void)getNetworkData:(BOOL)isRefresh { if (isRefresh) { page = 0; isFirstCome = YES; }else{ page++; } NSString *url; if (isFirstCome) { url = [NSString stringWithFormat:MissBaisiImageUrl,@"",page]; }else{ url = [NSString stringWithFormat:MissBaisiImageUrl,self.maxtime,page]; } // [HYBNetworking cacheGetRequest:YES shoulCachePost:YES]; [HYBNetworking getWithUrl:url refreshCache:NO params:nil progress:^(int64_t bytesRead, int64_t totalBytesRead) { } success:^(id response) { PPLog(@"請求成功---%@",response); [self endRefresh]; isJuhua = NO; //數據獲取成功后,設置為NO NSDictionary *dict = (NSDictionary *)response; NSDictionary *infoDict = [dict objectForKey:@"info"]; totalPage = (int)[infoDict objectForKey:@"page"]; self.maxtime = [infoDict objectForKey:@"maxtime"]; if (page == 0) { [_pictures removeAllObjects]; } //判斷是否有菊花正在加載,如果有,判斷當前頁數是不是大於最大頁數,是的話就不讓加載,直接return;(因為下拉的當前頁永遠是最小的,所以直接return) if (isJuhua) { if (page >= totalPage) { [self endRefresh]; } return ; } //沒有菊花正在加載,所以設置yes isJuhua = YES; //顯然下面的方法適用於上拉加載更多 if (page >= totalPage) { [self endRefresh]; return; } //獲取模型數組 NSArray *pictureArr = [dict objectForKey:@"list"]; for (NSDictionary *dic in pictureArr) { MJPicture *picture = [[MJPicture alloc]init]; [picture setValuesForKeysWithDictionary:dic]; [self.pictures addObject:picture]; } [self.tableView reloadData]; //獲取成功一次就判斷 isFirstCome = NO; } fail:^(NSError *error) { PPLog(@"請求失敗---%@",error); }]; } -(NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section { return _pictures.count; } -(UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath { UITableViewCell * cell = [tableView dequeueReusableCellWithIdentifier:@"cell"]; if (!cell) { cell = [[UITableViewCell alloc]initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"cell"]; } MJPicture * picture = _pictures[indexPath.row]; cell.textLabel.text = picture.name; cell.detailTextLabel.text = picture.passtime; [cell.imageView sd_setImageWithURL:[NSURL URLWithString:picture.profile_image]]; return cell; } - (void)didReceiveMemoryWarning { [super didReceiveMemoryWarning]; // Dispose of any resources that can be recreated. } -(NSMutableArray *)pictures { if (_pictures == nil) { _pictures = [NSMutableArray array]; } return _pictures; } @end
結束語:最初自己在簡書上轉載別人的文章MJRefresh實現刷新(使用它的Block方法),看到有好多閱讀量,並且還有小伙伴問我,自己也一直說更新,但沒有更新,6月13號剛好有空,就去下了最新的MJRefresh准備自己寫篇使用指導,下午快下班的時候遇到MJRefresh國際化的bug,在Issues了MJ后,bug被當晚解決了,14號早上也是收到MJ的郵件,非常開心!!!為開源點贊,也要做貢獻!
最后附上一張圖,iOS開發我的偶像吧,算是!激勵自己而已!