MJRefresh API深入了解(一)

在写这篇文章之前,我一直很纠结,到底要不要写呢?任何一个写iOS的程序员或者称为编程者,都应该对MJRefresh熟悉的不能再熟悉了。几乎每个人都用过,也知道如何使用,那么我又何必再在这里写下这篇文章呢?回答这个问题之前,我想问几个问题:
1:MJRefresh 与header和Footer相关的类有几个?
2:MJRefresh 中不同的Footer有什么区别?
3:MJRefresh 中不同的Header有什么区别?
4:如何自定义Footer和Header?

如果你都能回答上来,那么这篇文章可以不用往下看了。如果有些许疑问,那么希望这篇浅显的文章可以给您提供些许帮助。
(MJRefresh下载地址:https://github.com/CoderMJLee/MJRefresh.git

一、MJRefresh目录简介

首先让我们浏览下,MJRefresh都有哪些类文件。


image.png

这些文件大致分为四类:
辅助类(扩展类)
资源类(图片等)
自定义类(custom)
基础类 (base)

继续展开看:
Custom文件夹:


image.png

这里又包括两个文件夹,Header和Footer,我们经常使用的也是这个里面的一些类文件。
继续展开:


image.png

我们发现,这个文件夹中,Header有三种,Footer有六种。看到这里的时候,想必大家跟我一样有个疑问:

这么多种有什么区别呢?

先把疑问留在这里,我们继续往下看。

Base文件夹:


image.png

再次发现,base文件夹里还有很多个Header和Footer,这是怎么回事呢?

二、类之间的关系图

image.png

看完这个图之后,是不是基本理清楚了他们之间的关系呢?有没有又发现个小问题呢?

会回弹的刷新控件和会自动刷新的上拉刷新控件又是什么呢?

小练习:
看完上面的目录介绍以及结构图之后,如果觉得自己理解了或者有印象但不清晰的话,建议自己画一幅MJRefresh的主要刷新类之间关系图。下面是我自己画的:


image.png

如果你自己不参考任何东西就可以画出来的话,说明你真的对他们之间的关系弄清楚了。

三、详细介绍 Header和Footer

1、Header

  • MJRefreshHeader
    效果:
    MJRefreshHeader 没有文字和提示,不能弹回去,只能刷新一次。
    用法:
-(void)MJRefreshHeader_Default{
    __weak DownDefaultController * weakSelf = self;
    self.tableView.mj_header = [MJRefreshHeader headerWithRefreshingBlock:^{
        [weakSelf loadData];
        [weakSelf.tableView reloadData];
    }];
}

运行结果:

正常状态:


image.png

下拉状态:


image.png

下拉恢复之后状态:


image.png

发现刷新结束之后,tableView上面多了一部分空白,使用xcode查看结构之后发现:


image.png

上面多出了一个空白的View,就是MJRefreshHeader 。

  • MJRefreshNormalHeader
    效果:
    MJRefreshNormalHeader:最常用的那种刷新样式,有刷新状态、有时间、有上下指示的箭头。

用法:

-(void)MJRefreshNormalHeader_Normal{
    __weak DownDefaultController * weakSelf = self;
    self.tableView.mj_header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{
        [weakSelf loadData];
        [weakSelf.tableView reloadData];
        [weakSelf endRefresh];
    }];
}

运行效果:
正常状态:


image.png

下拉状态:


image.png

刷新状态


image.png

结束状态:


image.png

这种样式应该是最常用的一种了。

  • MJRefreshGifHeader
    效果:
    MJRefreshGifHeader: 左边带动图的刷新,有时间,有状态。
    用法:
-(void)MJRefreshGifHeader_gif{
    __weak DownDefaultController * weakSelf = self;
    MJRefreshGifHeader * header =  [MJRefreshGifHeader headerWithRefreshingBlock:^{
        [weakSelf loadData];
        [weakSelf.tableView reloadData];
        [weakSelf endRefresh];
    }];
    
    NSMutableArray * imagesNormal = [NSMutableArray array];
    for (int i=1; i<51; i++) {
        //dropdown_anim__00060
        UIImage * image = [UIImage imageNamed:[NSString stringWithFormat:@"dropdown_anim__000%d",i]];
        [imagesNormal addObject:image];
    }
    
    NSMutableArray * imagesPulling = [NSMutableArray array];
    for (int i=51; i<61; i++) {
        //dropdown_anim__00060
        UIImage * image = [UIImage imageNamed:[NSString stringWithFormat:@"dropdown_anim__000%d",i]];
        [imagesPulling addObject:image];
    }
    
    NSMutableArray * imagesRefreshing = [NSMutableArray array];
    for (int i=1; i<4; i++) {
        //dropdown_loading_01
        UIImage * image = [UIImage imageNamed:[NSString stringWithFormat:@"dropdown_loading_0%d",i]];
        [imagesRefreshing addObject:image];
    }
    
    [header setImages:imagesNormal forState:MJRefreshStateIdle];
    [header setImages:imagesPulling forState:MJRefreshStatePulling];
    [header setImages:imagesRefreshing forState:MJRefreshStateRefreshing];
    self.tableView.mj_header = header;
}

运行效果:


QQ20171122-210207.gif
  • MJRefreshStateHeader
    效果:
    MJRefreshStateHeader: 隐藏上下箭头图片,只有状态和时间。
    用法:
-(void)MJRefreshStateHeader_state{
    __weak DownDefaultController * weakSelf = self;
    self.tableView.mj_header = [MJRefreshStateHeader headerWithRefreshingBlock:^{
        [weakSelf loadData];
        [weakSelf.tableView reloadData];
        [weakSelf endRefresh];
    }];
}

运行效果:


QQ20171122-210533.gif

可以看到,这里没有左边的箭头,其他功能都是与MJRefreshNormalHeader相同的。

到此为止,我们已经把Header的基本类都使用了一遍,也知道了他们的用法和运行效果。接下来呢,我们再使用上面的几个类,实现一些其他效果。

    • 把时间隐藏掉(MJRefreshNormalHeader)

用法:

//把时间隐藏掉
-(void)MJRefreshHeader_HideTime{
    __weak DownDefaultController * weakSelf = self;
    MJRefreshNormalHeader * header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{
        [weakSelf loadData];
        [weakSelf.tableView reloadData];
        [weakSelf endRefresh];
    }];
    //隐藏时间
    header.lastUpdatedTimeLabel.hidden = YES;
    self.tableView.mj_header = header;
}

我们到MJRefreshNormalHeader的.h中看下,我们都可以取到哪些东西呢?


image.png

这里并没有时间和状态信息,只有一个旋转菊花的样式。不在这里,就在他的父类中。继续点击到MJRefreshStateHeader中去看看。


image.png

太好了,我们发现,在这个声明文件中,我们能够拿到


image.png

刷新时间和状态。那么我们就可以自由的操作它了。虽然是readonly的属性,但是我们仍然可以更改stateLabel的文字颜色等。

注意:readonly属性的含义
readonly是修饰的当前的这个属性,也就是stateLabel这个对象。针对stateLabel,你不可以给它重新赋值,也就是不能把另一个Label对象赋值给它。但是,stateLabel自己的属性,比如


image.png

等属性都是可以更改的。可不要搞错咯。

    • 自定义文字、颜色等
      用法:
-(void)MJRefreshHeader_CustomText{
    __weak DownDefaultController * weakSelf = self;
    MJRefreshNormalHeader * header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{
        [weakSelf loadData];
        [weakSelf.tableView reloadData];
        [weakSelf endRefresh];
    }];
    //设置刷新状态的文字
    [header setTitle:@"正常状态" forState:MJRefreshStateIdle];
    [header setTitle:@"刷新状态" forState:MJRefreshStateRefreshing];
    [header setTitle:@"正在下拉状态" forState:MJRefreshStatePulling];
    
    //设置字体
    header.stateLabel.font = [UIFont systemFontOfSize:10];
    header.lastUpdatedTimeLabel.font = [UIFont systemFontOfSize:7];
    
    //设置文字颜色
    header.stateLabel.textColor = [UIColor redColor];
    header.lastUpdatedTimeLabel.textColor = [UIColor blueColor];
    
    self.tableView.mj_header = header;
}

运行效果:


QQ20171122-212505.gif

这里,我们就是更改了它的文字颜色和大小。


image.png

最后,我们介绍下自定义header.
大家直接看源码吧。
新建一个类CustomHeader继承自MJRefreshHeader。

.h文件:

#import "MJRefreshHeader.h"

@interface CustomHeader : MJRefreshHeader

@end

.m文件:

//
//  CustomHeader.m
//  TestMJ
//
//  Created by weiman on 2017/11/17.
//  Copyright © 2017年 weiman. All rights reserved.
//

#import "CustomHeader.h"

@interface CustomHeader()

@property(nonatomic,weak)UILabel * stateLabel;
@property(nonatomic,weak)UIImageView * imageV;
@property(nonatomic,weak)UIActivityIndicatorView *loading;

@end

@implementation CustomHeader
#pragma mark - 重写方法
#pragma mark 在这里做一些初始化配置(比如添加子控件)
-(void)prepare{
    [super prepare];
    //设置控件的高度
    self.mj_h = 50;
    
    //添加label
    UILabel * label = [[UILabel alloc] init];
    label.textColor = [UIColor redColor];
    label.font = [UIFont systemFontOfSize:15];
    label.textAlignment = NSTextAlignmentCenter;
    [self addSubview:label];
    self.stateLabel = label;
    
    //图片
    UIImageView * imageV = [[UIImageView alloc] initWithFrame:CGRectMake(0, 0, 30, 30)];
    imageV.image = [UIImage imageNamed:@"refresh"];
    imageV.contentMode = UIViewContentModeScaleAspectFit;
    [self addSubview:imageV];
    self.imageV = imageV;
    
    //loading
    UIActivityIndicatorView * loading = [[UIActivityIndicatorView alloc] initWithActivityIndicatorStyle:UIActivityIndicatorViewStyleGray];
    [self addSubview:loading];
    self.loading = loading;
    
}

#pragma mark 在这里设置子控件的位置和尺寸
-(void)placeSubviews{
    [super placeSubviews];
    self.stateLabel.frame = self.bounds;
    self.imageV.frame = CGRectMake(50, self.mj_h*0.25, 30, 30);
    //self.imageV.center = CGPointMake(self.mj_w * 0.5, - self.imageV.mj_h + 20);
    self.loading.center = CGPointMake(self.mj_w-30, self.mj_h*0.5);
}

#pragma mark 监听scrollView的contentOffset改变
-(void)scrollViewContentOffsetDidChange:(NSDictionary *)change{
    [super scrollViewContentOffsetDidChange:change];
}

#pragma mark - 监听scrollView的contentSize改变
-(void)scrollViewContentSizeDidChange:(NSDictionary *)change{
    [super scrollViewContentSizeDidChange:change];
}

#pragma mark 监听scrollView的拖拽状态改变
-(void)scrollViewPanStateDidChange:(NSDictionary *)change{
    [super scrollViewPanStateDidChange:change];
}

#pragma mark - 监听控件的刷新状态
-(void)setState:(MJRefreshState)state{
    MJRefreshCheckState;
    switch (state) {
        case MJRefreshStateIdle:
        {
            [self.loading stopAnimating];
            self.stateLabel.text = @"下拉哟,哟乎乎";
        }
            break;
        case MJRefreshStatePulling:
        {
            [self.loading stopAnimating];
            self.stateLabel.text = @"赶紧放开我吧";
        }
            break;
        case MJRefreshStateRefreshing:
        {
            self.stateLabel.text = @"数据加载中";
            [self.loading startAnimating];
        }
            break;
  
        default:
            break;
    }
}

#pragma mark - 监听拖拽比例(控件被拖出来的比例)
-(void)setPullingPercent:(CGFloat)pullingPercent{
    [super setPullingPercent:pullingPercent];
    
    CGFloat red = 1.0 - pullingPercent * 0.5;
    CGFloat green = 0.5 - 0.5 * pullingPercent;
    CGFloat blue = 0.5 * pullingPercent;
    self.stateLabel.textColor = [UIColor colorWithRed:red green:green blue:blue alpha:1.0];
}

@end

运行效果:


QQ20171122-213032.gif

到这里,我们了解了MJRefresh的Header的不同类之间的关系以及他们的使用方法和差别。如果您有时间,建议您自己花点时间自己敲一下,很简单的,加深记忆,也加深理解。如果您不想自己敲,也可以看我的源码,demo下载地址:
https://github.com/weiman152/TestMJ.git

欢迎大家评论,讨论,指出问题。

最后,祝大家开心。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,839评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,543评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,116评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,371评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,384评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,111评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,416评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,053评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,558评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,007评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,117评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,756评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,324评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,315评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,539评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,578评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,877评论 2 345

推荐阅读更多精彩内容