给 UITableView 添加“下拉刷新（Pull-refresh）”属性

转自：http://www.diwublog.com/archives/109

如果你说你不知道什么是下拉刷新，好，我原谅你。不过你一定用过这些app吧？

然后你说，真好用，我也要给我的app里的所有table view都添加这个 pull & refresh 的功能。然后你就去 UIKit 里找啊找。

咦，怎么所有跟 table view 相关的 header file 里，都没有这个功能的 instance method 或者 property 描述？是不是因为我的 SDK 版本太旧了？于是你赶紧通宵下载了最新的 iOS 4.3 Beta 2。咦，怎么还是没有？

亲爱的，我还是有些不忍心，不过事情的经过是这样的：Cocoa Touch 的 官方 SDK 里，压根就没实现这个 pull & refresh 的功能。恩，这事真不是乔布斯手下干的。

然而也不是麻匪干的。是他干的，Enormego 团队，一个来自美国的天才、热心的开发团队。我知道你急着要看代码了， https://github.com/enormego/EGOTableViewPullRefresh 。

别急，打开你的工程文件。我们 5 分钟就能搞定。

一、找到你的 UITableView / UITableViewController 的 .h 文件，结合以下代码，添加相应的元素：

#import "EGORefreshTableHeaderView.h"

@interface RootViewController  : UITableViewController   {

EGORefreshTableHeaderView  *_refreshHeaderView;

//  Reloading var should really be your tableviews datasource
//  Putting it here for demo purposes
BOOL _reloading;
}

-  ( void )reloadTableViewDataSource;
-  ( void )doneLoadingTableViewData;
@end

二、切换到你的 UITableView / UITableViewController 的 .m 文件，结合以下代码，添加相应的元素：

-  ( void )viewDidLoad  {
[super viewDidLoad ];

if  (_refreshHeaderView  ==  nil )  {

EGORefreshTableHeaderView  *view  =  [ [EGORefreshTableHeaderView alloc ] initWithFrame :CGRectMake (0.0f, 0.0f  - self.tableView.bounds.size.height, self.view.frame.size.width, self.tableView.bounds.size.height ) ];
view.delegate  = self;
[self.tableView addSubview :view ];
_refreshHeaderView  = view;
[view release ];

}

//  update the last update date
[_refreshHeaderView refreshLastUpdatedDate ];
}

#pragma mark -
#pragma mark Data Source Loading / Reloading Methods

-  ( void )reloadTableViewDataSource {

//  should be calling your tableviews data source model to reload
//  put here just for demo
_reloading  =  YES;

}

-  ( void )doneLoadingTableViewData {

//  model should call this when its done loading
_reloading  =  NO;
[_refreshHeaderView egoRefreshScrollViewDataSourceDidFinishedLoading :self.tableView ];

}

#pragma mark -
#pragma mark UIScrollViewDelegate Methods

-  ( void )scrollViewDidScroll : (UIScrollView  * )scrollView {

[_refreshHeaderView egoRefreshScrollViewDidScroll :scrollView ];

}

-  ( void )scrollViewDidEndDragging : (UIScrollView  * )scrollView willDecelerate : ( BOOL )decelerate {

[_refreshHeaderView egoRefreshScrollViewDidEndDragging :scrollView ];

}

#pragma mark -
#pragma mark EGORefreshTableHeaderDelegate Methods

-  ( void )egoRefreshTableHeaderDidTriggerRefresh : (EGORefreshTableHeaderView * )view {

[self reloadTableViewDataSource ];
[self performSelector : @selector (doneLoadingTableViewData ) withObject : nil afterDelay : 3.0 ];

}

-  ( BOOL )egoRefreshTableHeaderDataSourceIsLoading : (EGORefreshTableHeaderView * )view {

return _reloading;  // should return if data source model is reloading

}

-  ( NSDate * )egoRefreshTableHeaderDataSourceLastUpdated : (EGORefreshTableHeaderView * )view {

return  [ NSDate date ];  // should return date data source was last changed

}

三、最后呢，为了彰显你良好的内存管理习惯，别忘了释放掉相应的 UI 元素：

-  ( void )viewDidUnload  {
_refreshHeaderView = nil;
}

-  ( void )dealloc  {

_refreshHeaderView  =  nil;
[super dealloc ];
}

四、编译之前，别忘了将EGORefreshTableHeaderView.h、EGORefreshTableHeaderView.m两个文件，以及Enormego提供的那一套图片包拖进你的工程里。

五、很抱歉没有第五步了，编译你的工程，打开 simulator ，看看效果吧。包你满意。 

其实还没完，这里补充一点花絮。关于这个 Pull & Refresh 功能的完整版来龙去脉。其实呢，最早出现这个 Pull & Refresh 功能的 app 是  Tweetie 2 ，也就是现在大家每天都在用的 Twitter for iPhone 的前身。因为这个小功能实在是很好用很贴心，所以就被 Enormego 团队发现了。但是 Tweetie 2 是闭源的，于是很牛逼很强大的 Enormego 就自己写了一个，并且很大方的放到 GitHub 上开源了。但是诸位如果仔细回忆一下，不难发现，真正让这个 Pull & Refresh 走红的，是 Facebook 旗下的 Three20 开源框架。

恩，没错， Facebook 自己可没重新实现 Pull & Refresh ，他们直接使用了 Enormego 的代码。而且令人发指的是，他们在最初的第一个版本里，没有提一句跟 Enormego 有关的话。一句都没有，更别说致谢了。于是（支线剧情）， Enormego 还曾经和 Three20 团队认认真真的吵过一次架（故事详情）。

算是 iOS 江湖上的一点不大不小的八卦。