【IOS开发基础系列】下拉刷新专题

1 UIRefreshControl实现

1.1 使用范围

        如果你装了xcode_4.5_developer_preview,那么在UITableViewController.h文件中你会看到,UITableViewController里面有如下声明,说明UITableViewController已经内置了UIRefreshControl控件

@property  (nonatomic,retain) UIRefreshControl *refreshControl     NS_AVAILABLE_IOS(6_0);

    【注】:UIRefreshControl目前只能用于UITableViewController,如果用在其他ViewController中,运行时会得到如下错误提示:(即UIRefreshControl只能被UITableViewController管理)

        12012-06-15 14:34:34.908  DevDivUIRefreshControl[722:10103] *** Terminating app due to uncaught  exception 'NSInternalInconsistencyException', reason: 'UIRefreshControl may  only be managed by a UITableViewController'


1.2 如何使用

1.2.1 a)初始化

        如何在UITableViewController中使用UIRefreshControl呢,在上面给出的代码附件中,你可以很详细的知道,这里介绍一下关键的部分:

self.refreshControl= [[UIRefreshControl alloc] init];

//   self.refreshControl.tintColor = [UIColor blueColor];

self.refreshControl.attributedTitle = [[NSAttributedString alloc] initWithString: @"下拉刷新"];

[self.refreshControl addTarget: self action: @selector(RefreshViewControlEventValueChanged) forControlEvents: UIControlEventValueChanged];

        如上面看到的代码,虽然UITableViewController已经声明了UIRefreshControl,但是貌似还没有初始化,所以需要我们自己初始化。很神奇,初始化的时候并不需要给它指定frame,UITableViewController会为我们进行管理。遗憾的时目前只看到下拉刷新功能,上拉刷新还没有,估计在最终版里面苹果会考虑加入上拉刷新功能。

        我们还可以给UIRefreshControl设置tintColor和attributedTitle。


1.2.2 b)下拉刷新事件监听

        当用户进行下拉刷新操作时,UIRefreshControl会触发一个UIControlEventValueChanged事件,通过监听这个事件,我们就可以进行类似数据请求的操作了。如下代码:

[self.refreshControl addTarget: self action: @selector(RefreshViewControlEventValueChanged)


1.2.3 c)进行数据请求

        在示例中,为了演示数据请求,我简单的做了一个延时处理,2秒钟后,调用handleData.

[self performSelector: @selector(handleData) withObject: nil afterDelay: 2];


        在handleData里面,就表示已经请求到了数据,在此进行UI更新即可。也需要注意的是,我们调用UIRefreshControl的endRefreshing方法,表示刷新结束,让UIRefreshControl更新显示。

- (void) handleData

{

    NSLog(@"refreshed");

    [self.refreshControl endRefreshing];

    self.refreshControl.attributedTitle = [[NSAttributedString alloc] initWithString: @"下拉刷新"];

    self.count++;

    [self.tableView reloadData];

}


1.3 官方头文件

        下面是sdk中UIRefreshControl的声明,想必看了下面的代码,你已经知道如何使用了。

//  UIRefreshControl.h

//  UIKit

//  Copyright 2012 Apple Inc. All rights reserved.

//

#import <Foundation/Foundation.h>

#import <UIKit/UIControl.h>

#import <UIKit/UIKitDefines.h>

NS_CLASS_AVAILABLE_IOS(6_0)

@interface UIRefreshControl : UIControl

/* The designated initializer

    * This initializes a UIRefreshControl with a default height and width.

    * Once assigned to a UITableViewController, the frame of the control is managed automatically.

    * When a user has pulled-to-refresh, the UIRefreshControl fires itsUIControlEventValueChanged event.

*/

    @property(nonatomic, readonly, getter=isRefreshing) BOOL refreshing;

    @property(nonatomic, retain) UIColor *tintColor UI_APPEARANCE_SELECTOR;

    @property(nonatomic, retain) NSAttributedString *attributedTitle UI_APPEARANCE_SELECTOR;


    - (id) init;

    - (void) beginRefreshing     NS_AVAILABLE_IOS(6_0);

    // Must be explicitly called when the refreshing has completed

    - (void) endRefreshing     NS_AVAILABLE_IOS(6_0);

@end


2 EGOTableViewPullRefresh

        enormego的EGOTableViewPullRefresh完美的实现了下拉刷新的功能,网上许多上拉、下拉库都是基于EGOTableViewPullRefresh。

        EGOTableViewPullRefresh源码下载地址:

https://github.com/enormego/EGOTableViewPullRefresh/

        遗憾的是EGOTableViewPullRefresh只实现了下拉功能,而没有上拉的功能。

        这里介绍一种同时集成下拉及上拉功能的库:https://github.com/emreberge/EGOTableViewPullRefresh

        此类重写了TableView类,使用的时候我们自定义的TableView继承于PullTableView。


2.1 附带Demo效果

2.2 Whats different on this fork:

    • 容易集成,使用interface builder 添加tableView进行配置。

    • 配置简单, 箭头头像,背景颜色和文本颜色都能通过PullTableView类的属性很容易的更改。

    • 上拉加载更多数据功能在Table的底部。

    • 可以通过代码修改刷新和加载更多动画。


2.3 The fast setup

    • 添加 QuartzCore.framework 到你的工程中。

    • 将 EGOTableViewPullRefresh 拖到你的工程目录下。

    • 查看 PullTableView.h 文件可用的属性。

    • 添加一个PullTableView 到你代码中,实现PullTableViewDelegate委托方法。

    • 欣赏吧。


2.4 The detailed setup (Walk through for creating the demo project)

    • 创建一个新的xcode工程

    • 选择 View Based Application 模板(xcode 4.2以后版本是 Single View Application模板)

    • 工程名字EGOTableViewPullRefreshDemo

    • 在工程文件下创建EGOTableViewPullRefreshDemoViewController控制器类(Single View

Application模板不需这步)

    • 添加 QuartzCore.framework 到工程中

2.4.1 添加PullTableView到工程里

    • 拖拽 EGOTableViewPullRefresh 目录下文件到工程支持的文件组下,确保(EGOTableViewPullRefresh) 下文件都拷贝到目标文件组下。

2.4.2 添加PullTable视图到EGOTableViewPullRefreshDemoViewController.xib上

    • 拖一个UITableView控件到View视图上;

    • 打开 Identity inspector 将Table 的继承类由  UITableView 改成PullTableView;

    • 连接 dataSources数据源和 pullDelegate协议到PullTableView的 File's owner上;

2.4.3 配置视图控制器的头文件EGOTableViewPullRefreshDemoViewController.h

    • 添加#import "PullTableView.h"

    • 声明 PullTableViewDelegate 和 UITableViewDataSource协议

    • 创建一个属性名为pullTableView的输出口连接到interface Builder上的tableView上

2.4.4 配置视图控制器和页脚EGOTableViewPullRefreshDemoViewController.m

    • 在.m文件中添加下面代码

#pragma mark - Refresh and load more methods

- (void) refreshTable

{

    /*

         Code to actually refresh goes here.  刷新代码放在这

     */

    self.pullTableView.pullLastRefreshDate = [NSDate date];

    self.pullTableView.pullTableIsRefreshing = NO;

}

- (void) loadMoreDataToTable

{

    /*

     Code to actually load more data goes here.  加载更多实现代码放在在这

     */

    self.pullTableView.pullTableIsLoadingMore = NO;

}

#pragma mark - UITableViewDataSource

- (NSInteger) numberOfSectionsInTableView: (UITableView *)tableView

{

    return 5;

}

- (NSInteger) tableView: (UITableView *)tableView numberOfRowsInSection: (NSInteger)section

{

    return 10;

}

- (UITableViewCell *) tableView: (UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath

{

    static NSString *cellIdentifier = @"Cell";

    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier: cellIdentifier];

    if (!cell) {

        cell = [[UITableViewCell alloc] initWithStyle: UITableViewCellStyleDefault reuseIdentifier: cellIdentifier];

    }

    cell.textLabel.text = [NSString stringWithFormat: @"Row %i", indexPath.row];

    return cell;

}

- (NSString *) tableView: (UITableView *)tableView titleForHeaderInSection: (NSInteger)section

{

    return [NSString stringWithFormat: @"Section %i begins here!", section];

}

- (NSString *) tableView: (UITableView *)tableView titleForFooterInSection: (NSInteger)section

{

    return [NSString stringWithFormat: @"Section %i ends here!", section];

}

#pragma mark - PullTableViewDelegate

- (void) pullTableViewDidTriggerRefresh: (PullTableView *)pullTableView

{

    [self performSelector: @selector(refreshTable) withObject: nil afterDelay: 3.0f];

}

- (void) pullTableViewDidTriggerLoadMore: (PullTableView *)pullTableView

{

    [self performSelector: @selector(loadMoreDataToTable) withObject: nil afterDelay: 3.0f];

}

    •  对于UI的配置,在ViewDidLoad()方法里面添加下面代码(比如 修改刷新和上拉的背景色箭头头像等)

self.pullTableView.pullArrowImage = [UIImage imageNamed: @"blackArrow"];

self.pullTableView.pullBackgroundColor = [UIColor yellowColor];

self.pullTableView.pullTextColor = [UIColor blackColor];


    • 对于手动设置动画可使用 pullTableIsRefreshing 和pullTableIsLoadingMore 属性. 比如在 viewWillAppear:方法里面添加下面的代码

if (!self.pullTableView.pullTableIsRefreshing) {

    self.pullTableView.pullTableIsRefreshing = YES;

    [self performSelector: @selector(refreshTable) withObject: nil afterDelay: 3];

}  


3 MJRefresh

https://github.com/CoderMJLee/MJRefresh


3.1 MJRefresh类结构图

3.2 常见问题

3.2.1 下拉视图默认显示刷新一栏

原因:

    headerView的添加方法使用错误:

    self.postTableView.tableHeaderView = _refreshHeaderView;

    self.postTableView.tableFooterView = _refreshFooterView;


正确:

    self.postTableView.header = _refreshHeaderView;

    self.postTableView.footer = _refreshFooterView;

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

推荐阅读更多精彩内容