MJRefresh解析與詳細使用指導

MJRefresh解析與詳細使用指導

本篇旨在更詳細指導怎麼使用對應的第三方,不會過多說明第三方怎麼實現!就像你買了部新手機,說明書只說明怎麼使用(及注意事項),並不說明手機由什麼構造以及怎麼製造!
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:


圖mj-02 MJRefresh的框架圖


2 . MJRefresh的框架圖梳理

作用
MJRefreshComponent 繼承自UIView,最基本的刷新類
MJRefreshHeader 最基本的下拉刷新類
MJRefreshStateHeader 可以下拉刷新,但是隻有文字
MJRefreshNormalHeader 默認的刷新樣式,有文字,有上下箭頭,有菊花

抱歉說下:上面MJ的框架圖說的已經很詳細了,具體的上拉加載更多就不寫了

3 . MJRefresh使用技巧或建議

3.1 無論是下拉刷新還是上拉加載,都最好使用圖mj-01分支最後面的某一個,因爲越後面分工越詳細,刷新控件處理的越細緻;
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更自定義化的下拉刷新上拉加載

  1. 動畫圖片樣式;
  2. 隱藏刷新控件狀態或者時間樣式;
  3. 自定義刷新狀態和刷新時間文字樣式【當然了,對應的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啦!嘿嘿!

四. 最後,上面的刷新和加載這麼簡單,等等,還有一點注意呢

下拉刷新 --- 獲取最新數據;
上拉加載 --- 獲取更多數據;

四-1PPDemos中的刷新類都是繼承自MJViewController的,所以在刷新和加載的類MJDefaultViewController,MJDefaultBlockViewController,MJAnimationImageViewController,MJCustomRefreshViewController中,只需要在viewDidLoad中調用即可;
四-2MJViewController.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

四-3MJViewController.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
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章