当前位置:   article > 正文

[最新版]MJRefresh解析与详细使用指导_reason: '-[nstaggedpointerstring bytes]

reason: '-[nstaggedpointerstring bytes]

转载:http://www.jianshu.com/p/4ea427bab0af(支持原创作者)


俗话说 “工欲善其事,必先利其器”,好的成熟的第三方,是我们开发路上的利器;俗话又说“君子生非异也,善假于物也”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

一. 新旧版本比较

旧版本使用说明

  1. #import "UIScrollView+MJRefresh.h"
  2. /**
  3. MJ友情提示:
  4. 1. 添加头部控件的方法
  5. [self.tableView addHeaderWithTarget:self action:@selector(headerRereshing)];
  6. 或者
  7. [self.tableView addHeaderWithCallback:^{ }];
  8. 2. 添加尾部控件的方法
  9. [self.tableView addFooterWithTarget:self action:@selector(footerRereshing)];
  10. 或者
  11. [self.tableView addFooterWithCallback:^{ }];
  12. 3. 可以在MJRefreshConst.h和MJRefreshConst.m文件中自定义显示的文字内容和文字颜色
  13. 4. 本框架兼容iOS6\\\\iOS7,iPhone\\\\iPad横竖屏
  14. 5.自动进入刷新状态
  15. 1> [self.tableView headerBeginRefreshing];
  16. 2> [self.tableView footerBeginRefreshing];
  17. 6.结束刷新
  18. 1> [self.tableView headerEndRefreshing];
  19. 2> [self.tableView footerEndRefreshing];
  20. */

新版本介绍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:


图mj-02 MJRefresh的框架图


2 . MJRefresh的框架图梳理

作用
MJRefreshComponent继承自UIView,最基本的刷新类
MJRefreshHeader最基本的下拉刷新类
MJRefreshStateHeader可以下拉刷新,但是只有文字
MJRefreshNormalHeader默认的刷新样式,有文字,有上下箭头,有菊花

抱歉说下:上面MJ的框架图说的已经很详细了,具体的上拉加载更多就不写了

3 . MJRefresh使用技巧或建议

3.1 无论是下拉刷新还是上拉加载,都最好使用图mj-02分支最后面的某一个,因为越后面分工越详细,刷新控件处理的越细致;
3.2 自定义刷新控件,后面有讲解

三 .MJRefresh详细使用指导所有说明都配合代码讲解

① MJRefresh默认下拉刷新上拉加载

  1. - (void)viewDidLoad {
  2. [super viewDidLoad];
  3. // Do any additional setup after loading the view.
  4. //默认【下拉刷新】
  5. self.tableView.mj_header = [MJRefreshNormalHeader headerWithRefreshingTarget:self refreshingAction:@selector(refresh)];
  6. //默认【上拉加载】
  7. self.tableView.mj_footer = [MJRefreshAutoNormalFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMore)];
  8. }
  9. -(void)refresh
  10. {
  11. [self getNetworkData:YES];
  12. }
  13. -(void)loadMore
  14. {
  15. [self getNetworkData:NO];
  16. }

② MJRefresh默认下拉刷新上拉加载【使用Block方法】

  1. - (void)viewDidLoad {
  2. [super viewDidLoad];
  3. // Do any additional setup after loading the view.
  4. __weak typeof(self) weakSelf = self;
  5. //默认block方法:设置下拉刷新
  6. self.tableView.mj_header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{
  7. [weakSelf getNetworkData:YES];
  8. }];
  9. //默认block方法:设置上拉加载更多
  10. self.tableView.mj_footer = [MJRefreshAutoNormalFooter footerWithRefreshingBlock:^{
  11. //Call this Block When enter the refresh status automatically
  12. [weakSelf getNetworkData:NO];
  13. }];
  14. }

③ MJRefresh更自定义化的下拉刷新上拉加载

  1. 动画图片样式;
  2. 隐藏刷新控件状态或者时间样式;
  3. 自定义刷新状态和刷新时间文字样式【当然了,对应的Label不能隐藏】
  1. - (void)viewDidLoad {
  2. [super viewDidLoad];
  3. //样式一:设置一张图片(无动画效果)
  4. // NSArray *idleImages = [NSArray arrayWithObject:[UIImage imageNamed:@"xiala_icon.png"]];
  5. //样式二:设置多张图片(有动画效果)
  6. NSArray *idleImages = [NSArray arrayWithObjects:
  7. [UIImage imageNamed:@"dropdown_loading_01.png"],
  8. [UIImage imageNamed:@"dropdown_loading_02.png"],
  9. [UIImage imageNamed:@"dropdown_loading_03.png"],nil];
  10. NSArray *pullingImages = [NSArray arrayWithObject:[UIImage imageNamed:@"shifang_icon.png"]];
  11. NSArray *refreshingImages = [NSArray arrayWithObjects:
  12. [UIImage imageNamed:@"load_view_01.png"],
  13. [UIImage imageNamed:@"load_view_02.png"],
  14. [UIImage imageNamed:@"load_view_03.png"],
  15. [UIImage imageNamed:@"load_view_04.png"],
  16. [UIImage imageNamed:@"load_view_05.png"],
  17. [UIImage imageNamed:@"load_view_06.png"],
  18. [UIImage imageNamed:@"load_view_07.png"],
  19. [UIImage imageNamed:@"load_view_08.png"],
  20. [UIImage imageNamed:@"load_view_09.png"],
  21. [UIImage imageNamed:@"load_view_010.png"], nil];
  22. // MJRefreshGifHeader *header = [MJRefreshGifHeader headerWithRefreshingTarget:self refreshingAction:@selector(animationRefresh)];
  23. //-------以下是使用block方法【不包含animationRefresh方法】,动画设置在上面的部分代码---------
  24. __weak typeof(self) weakSelf = self;
  25. MJRefreshGifHeader *header = [MJRefreshGifHeader headerWithRefreshingBlock:^{
  26. [weakSelf getNetworkData:YES];
  27. }];
  28. //-------以上是使用block方法【不包含animationRefresh方法】,动画设置在上面的部分代码---------
  29. //1.设置普通状态的动画图片
  30. [header setImages:idleImages forState:MJRefreshStateIdle];
  31. //2.设置即将刷新状态的动画图片(一松开就会刷新的状态)
  32. [header setImages:pullingImages forState:MJRefreshStatePulling];
  33. //3.设置正在刷新状态的动画图片
  34. [header setImages:refreshingImages forState:MJRefreshStateRefreshing];
  35. self.tableView.mj_header = header;
  36. #pragma mark --- 下面两个设置根据各自需求设置
  37. // // 隐藏更新时间
  38. // header.lastUpdatedTimeLabel.hidden = YES;
  39. //
  40. // // 隐藏刷新状态
  41. // header.stateLabel.hidden = YES;
  42. #pragma mark --- 自定义刷新状态和刷新时间文字【当然了,对应的Label不能隐藏】
  43. // Set title
  44. [header setTitle:@"Pull down to refresh" forState:MJRefreshStateIdle];
  45. [header setTitle:@"Release to refresh" forState:MJRefreshStatePulling];
  46. [header setTitle:@"Loading ..." forState:MJRefreshStateRefreshing];
  47. // Set font
  48. header.stateLabel.font = [UIFont systemFontOfSize:15];
  49. header.lastUpdatedTimeLabel.font = [UIFont systemFontOfSize:14];
  50. // Set textColor
  51. header.stateLabel.textColor = [UIColor redColor];
  52. header.lastUpdatedTimeLabel.textColor = [UIColor blueColor];
  53. }
  54. #pragma mark --- "动画图片"样式的非block方法
  55. -(void)animationRefresh
  56. {
  57. [self getNetworkData:YES];
  58. }

④ MJRefresh完全自定义化的下拉刷新上拉加载

④-1. 最终调用

  1. - (void)viewDidLoad {
  2. [super viewDidLoad];
  3. //MJRefresh自定义刷新控件
  4. __weak typeof(self) weakSelf = self;
  5. self.tableView.mj_header = [MJDIYHeader headerWithRefreshingBlock:^{
  6. [weakSelf getNetworkData:YES];
  7. }];
  8. }

④-2. 完全自定义的下拉刷新控件上拉暂还没看

  1. 更多信息请参看MJDIYHeade.m
  2. 更多信息请参看MJDIYHeade.m
  3. 更多信息请参看MJDIYHeade.m
  4. (嘿嘿,我错了,当然不能这样忽悠过了,请往下继续......)

④-3. 【附】:MJRefresh自定义刷新控件步骤(just 3 步)重要

说明:最好参考MJDIYHeader.m来学习,就不一一截图说明
① 首先创建一个类(譬如MJDIYHeader),继承自MJRefreshHeader;
② 重写相关方法 【 在MJRefreshComponent.h中有下面的提示】

  1. #pragma mark - 交给子类们去实现
  2. /** 初始化 */
  3. #pragma mark 在这里做一些初始化配置(比如添加子控件)
  4. -(void)prepare NS_REQUIRES_SUPER;
  5. /** 摆放子控件frame */
  6. #pragma mark 在这里设置子控件的位置和尺寸
  7. -(void)placeSubviews NS_REQUIRES_SUPER;
  8. /** 当scrollView的contentOffset发生改变的时候调用 */
  9. -(void)scrollViewContentOffsetDidChange:(NSDictionary *)change NS_REQUIRES_SUPER;
  10. /** 当scrollView的contentSize发生改变的时候调用 */
  11. -(void)scrollViewContentSizeDidChange:(NSDictionary *)change NS_REQUIRES_SUPER;
  12. /** 当scrollView的拖拽状态发生改变的时候调用 */
  13. -(void)scrollViewPanStateDidChange:(NSDictionary *)change NS_REQUIRES_SUPER;

③ 调用!OK啦!嘿嘿!

四. 最后,上面的刷新和加载这么简单,等等,还有一点注意呢

下拉刷新 --- 获取最新数据;
上拉加载 --- 获取更多数据;

四-1. PPDemos中的刷新类都是继承自MJViewController的,所以在刷新和加载的类MJDefaultViewController,MJDefaultBlockViewController,MJAnimationImageViewController,MJCustomRefreshViewController中,只需要在viewDidLoad中调用即可;
四-2. MJViewController.h 父类的,子类都可以用

  1. //
  2. // MJViewController.h
  3. // MJDemos
  4. //
  5. // Created by Abner on 16/6/13.
  6. // Copyright © 2016年 PPAbner. All rights reserved.
  7. //
  8. #import <UIKit/UIKit.h>
  9. @interface MJViewController : UIViewController
  10. {
  11. int page;
  12. BOOL isFirstCome; //第一次加载帖子时候不需要传入此关键字,当需要加载下一页时:需要传入加载上一页时返回值字段“maxtime”中的内容。
  13. int totalPage;//总页数
  14. BOOL isJuhua;//是否正在下拉刷新或者上拉加载。default NO。
  15. }
  16. @property(nonatomic,strong)NSMutableArray *pictures;
  17. @property(nonatomic,strong)UITableView *tableView;
  18. /** maxtime */
  19. @property(nonatomic,copy)NSString *maxtime;
  20. /**
  21. * 获取网络数据
  22. * @param isRefresh 是否是下拉刷新
  23. */
  24. -(void)getNetworkData:(BOOL)isRefresh;
  25. @end

四-3. MJViewController.m

  1. //
  2. // MJViewController.m
  3. // MJDemos
  4. //
  5. // Created by Abner on 16/6/13.
  6. // Copyright © 2016年 PPAbner. All rights reserved.
  7. //
  8. #import "MJViewController.h"
  9. #import "MJPicture.h"
  10. @interface MJViewController ()<UITableViewDelegate,UITableViewDataSource>
  11. @end
  12. @implementation MJViewController
  13. -(void)viewWillDisappear:(BOOL)animated
  14. {
  15. isFirstCome = YES;
  16. }
  17. //一进来就让自动刷新
  18. -(void)viewWillAppear:(BOOL)animated
  19. {
  20. [self.tableView.mj_header beginRefreshing];
  21. }
  22. - (void)viewDidLoad {
  23. [super viewDidLoad];
  24. page = 0;
  25. isFirstCome = YES;
  26. isJuhua = NO;
  27. [self creatUI];
  28. }
  29. /**
  30. * 停止刷新
  31. */
  32. -(void)endRefresh{
  33. if (page == 0) {
  34. [self.tableView.mj_header endRefreshing];
  35. }
  36. [self.tableView.mj_footer endRefreshing];
  37. }
  38. -(void)creatUI
  39. {
  40. self.tableView = [[UITableView alloc]initWithFrame:CGRectMake(0, 0, ScreenWidth, ScreenHeight) style:UITableViewStylePlain];
  41. self.tableView.delegate =self;
  42. self.tableView.dataSource =self;
  43. [self.view addSubview:self.tableView];
  44. self.tableView.tableFooterView = [UIView new];
  45. self.tableView.separatorStyle = UITableViewCellSeparatorStyleNone;
  46. }
  47. -(void)getNetworkData:(BOOL)isRefresh
  48. {
  49. if (isRefresh) {
  50. page = 0;
  51. isFirstCome = YES;
  52. }else{
  53. page++;
  54. }
  55. NSString *url;
  56. if (isFirstCome) {
  57. url = [NSString stringWithFormat:MissBaisiImageUrl,@"",page];
  58. }else{
  59. url = [NSString stringWithFormat:MissBaisiImageUrl,self.maxtime,page];
  60. }
  61. // [HYBNetworking cacheGetRequest:YES shoulCachePost:YES];
  62. [HYBNetworking getWithUrl:url refreshCache:NO params:nil progress:^(int64_t bytesRead, int64_t totalBytesRead) {
  63. } success:^(id response) {
  64. PPLog(@"请求成功---%@",response);
  65. [self endRefresh];
  66. isJuhua = NO; //数据获取成功后,设置为NO
  67. NSDictionary *dict = (NSDictionary *)response;
  68. NSDictionary *infoDict = [dict objectForKey:@"info"];
  69. totalPage = (int)[infoDict objectForKey:@"page"];
  70. self.maxtime = [infoDict objectForKey:@"maxtime"];
  71. if (page == 0) {
  72. [_pictures removeAllObjects];
  73. }
  74. //判断是否有菊花正在加载,如果有,判断当前页数是不是大于最大页数,是的话就不让加载,直接return;(因为下拉的当前页永远是最小的,所以直接return)
  75. if (isJuhua) {
  76. if (page >= totalPage) {
  77. [self endRefresh];
  78. }
  79. return ;
  80. }
  81. //没有菊花正在加载,所以设置yes
  82. isJuhua = YES;
  83. //显然下面的方法适用于上拉加载更多
  84. if (page >= totalPage) {
  85. [self endRefresh];
  86. return;
  87. }
  88. //获取模型数组
  89. NSArray *pictureArr = [dict objectForKey:@"list"];
  90. for (NSDictionary *dic in pictureArr) {
  91. MJPicture *picture = [[MJPicture alloc]init];
  92. [picture setValuesForKeysWithDictionary:dic];
  93. [self.pictures addObject:picture];
  94. }
  95. [self.tableView reloadData];
  96. //获取成功一次就判断
  97. isFirstCome = NO;
  98. } fail:^(NSError *error) {
  99. PPLog(@"请求失败---%@",error);
  100. }];
  101. }
  102. -(NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section
  103. {
  104. return _pictures.count;
  105. }
  106. -(UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
  107. {
  108. UITableViewCell * cell = [tableView dequeueReusableCellWithIdentifier:@"cell"];
  109. if (!cell) {
  110. cell = [[UITableViewCell alloc]initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"cell"];
  111. }
  112. MJPicture * picture = _pictures[indexPath.row];
  113. cell.textLabel.text = picture.name;
  114. cell.detailTextLabel.text = picture.passtime;
  115. [cell.imageView sd_setImageWithURL:[NSURL URLWithString:picture.profile_image]];
  116. return cell;
  117. }
  118. - (void)didReceiveMemoryWarning {
  119. [super didReceiveMemoryWarning];
  120. // Dispose of any resources that can be recreated.
  121. }
  122. -(NSMutableArray *)pictures
  123. {
  124. if (_pictures == nil) {
  125. _pictures = [NSMutableArray array];
  126. }
  127. return _pictures;
  128. }
  129. @end

结束语:最初自己在简书上转载别人的文章MJRefresh实现刷新(使用它的Block方法),看到有好多阅读量,并且还有小伙伴问我,自己也一直说更新,但没有更新,6月13号刚好有空,就去下了最新的MJRefresh准备自己写篇使用指导,下午快下班的时候遇到MJRefresh国际化的bug,在Issues了MJ后,bug被当晚解决了,14号早上也是收到MJ的邮件,非常开心!!!为开源点赞,也要做贡献!
最后附上一张图,iOS开发我的偶像吧,算是!激励自己而已!


MJ邮件我和另一哥们

2016--06--17 00:37:10,晚安!



文/PP_Abner(简书作者)
原文链接:http://www.jianshu.com/p/4ea427bab0af
著作权归作者所有,转载请联系作者获得授权,并标注“简书作者”。
声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/AllinToyou/article/detail/74774
推荐阅读
相关标签
  

闽ICP备14008679号