MJRefresh
- 使用下拉刷新的简单方法
内容
- 入门
- 注释 API
- 示例
- 参考
- 下拉刷新 01-默认
- 下拉刷新 02-动画图片
- 下拉刷新 03-隐藏时间
- 下拉刷新 04-隐藏状态和时间
- 下拉刷新 05-自定义标题
- 下拉刷新 06-自定义刷新控件
- 上拉刷新 01-默认
- 上拉刷新 02-动画图片
- 上拉刷新 03-隐藏刷新状态标题
- 上拉刷新 04-全部加载
- 上拉刷新 05-自定义标题
- 上拉刷新 06-加载后隐藏
- 上拉刷新 07-自动回弹 01
- 上拉刷新 08-自动回弹 02
- 上拉刷新 09-自定义刷新控件(自动刷新)
- 上拉刷新 10-自定义刷新控件(自动回弹)
- UICollectionView01-上拉和下拉刷新
- UICollectionView02-尾部刷新
- WKWebView01-下拉刷新
- 希望
新特性
动态i18n切换
现在，MJRefresh组件将自动使用MJRefreshConfig.default.language设置进行重新渲染。
示例
进入i18n文件夹，查看大量案例。模拟器示例位于右上角的i18n标签页后面。
设置语言
MJRefreshConfig.default.language = "zh-hans"设置i18n文件名
MJRefreshConfig.default.i18nFilename = "i18n File Name(not include type<.strings>)"设置i18n语言包
MJRefreshConfig.default.i18nBundle = <i18n Bundle>在你的DIY组件中采用此功能
- 只需覆盖
i18nDidChange函数并重置文本。
// must use this localization methods
Bundle.mj_localizedString(forKey: "")
// or
Bundle.mj_localizedString(forKey: "", value:"")
override func i18nDidChange() {
// Reset texts function
setupTexts()
// Make sure to call super after resetting texts. It will call placeSubViews for applying new layout.
super.i18nDidChange()
}- 收到
MJRefreshDidChangeLanguageNotification通知。
支持SPM
自 3.7.1 版本开始发布
支持 Swift Chaining 语法
// Example as MJRefreshNormalHeader
func addRefreshHeader() {
MJRefreshNormalHeader { [weak self] in
// load some data
}.autoChangeTransparency(true)
.link(to: tableView)
}支持刷新哪些控件
UIScrollView、UITableView、UICollectionView、WKWebView
如何使用 MJRefresh
- 使用 CocoaPods 安装：
pod 'MJRefresh' - 使用 Carthage 安装：
github "CoderMJLee/MJRefresh" - 手动导入：
- 将
MJRefresh文件夹内的所有文件拖入项目 - 导入主文件：
#import "MJRefresh.h"
- 将
Base Custom
MJRefresh.bundle MJRefresh.h
MJRefreshConst.h MJRefreshConst.m
UIScrollView+MJExtension.h UIScrollView+MJExtension.m
UIScrollView+MJRefresh.h UIScrollView+MJRefresh.m
UIView+MJExtension.h UIView+MJExtension.m数百款应用正在使用 MJRefresh
MJRefresh 类结构图
-
图表中的红色文本类：您可以直接使用它们- 下拉刷新控件类型
- 普通：
MJRefreshNormalHeader - Gif：
MJRefreshGifHeader
- 普通：
- 下拉刷新控件类型
- 自动刷新
- 普通：
MJRefreshAutoNormalFooter - Gif：
MJRefreshAutoGifFooter
- 普通：
- 自动回叫
- 普通：
MJRefreshBackNormalFooter - Gif：
MJRefreshBackGifFooter
- 普通：
- 自动刷新
- 下拉刷新控件类型
-
图表中非红色文本类：用于继承，以自定义刷新控件 -
关于如何自定义刷新控件，您可以参考以下图表中的类
MJRefreshComponent.h
/** The Base Class of refresh control */
@interface MJRefreshComponent : UIView
#pragma mark - Control the state of Refresh
/** BeginRefreshing */
- (void)beginRefreshing;
/** EndRefreshing */
- (void)endRefreshing;
/** IsRefreshing */
- (BOOL)isRefreshing;
#pragma mark - Other
/** According to the drag ratio to change alpha automatically */
@property (assign, nonatomic, getter=isAutomaticallyChangeAlpha) BOOL automaticallyChangeAlpha;
@endMJRefreshHeader.h
@interface MJRefreshHeader : MJRefreshComponent
/** Creat header */
+ (instancetype)headerWithRefreshingBlock:(MJRefreshComponentRefreshingBlock)refreshingBlock;
/** Creat header */
+ (instancetype)headerWithRefreshingTarget:(id)target refreshingAction:(SEL)action;
/** This key is used to storage the time that the last time of drown-down successfully */
@property (copy, nonatomic) NSString *lastUpdatedTimeKey;
/** The last time of drown-down successfully */
@property (strong, nonatomic, readonly) NSDate *lastUpdatedTime;
/** Ignored scrollView contentInset top */
@property (assign, nonatomic) CGFloat ignoredScrollViewContentInsetTop;
@endMJRefreshFooter.h
@interface MJRefreshFooter : MJRefreshComponent
/** Creat footer */
+ (instancetype)footerWithRefreshingBlock:(MJRefreshComponentRefreshingBlock)refreshingBlock;
/** Creat footer */
+ (instancetype)footerWithRefreshingTarget:(id)target refreshingAction:(SEL)action;
/** NoticeNoMoreData */
- (void)noticeNoMoreData;
/** ResetNoMoreData（Clear the status of NoMoreData ） */
- (void)resetNoMoreData;
/** Ignored scrollView contentInset bottom */
@property (assign, nonatomic) CGFloat ignoredScrollViewContentInsetBottom;
@endMJRefreshAutoFooter.h
@interface MJRefreshAutoFooter : MJRefreshFooter
/** Is Automatically Refresh(Default is Yes) */
@property (assign, nonatomic, getter=isAutomaticallyRefresh) BOOL automaticallyRefresh;
/** When there is much at the bottom of the control is automatically refresh(Default is 1.0，Is at the bottom of the control appears in full, will refresh automatically) */
@property (assign, nonatomic) CGFloat triggerAutomaticallyRefreshPercent;
@endMJRefreshTrailer.h
@interface MJRefreshTrailer : MJRefreshComponent
/** 创建trailer */
+ (instancetype)trailerWithRefreshingBlock:(MJRefreshComponentAction)refreshingBlock;
/** 创建trailer */
+ (instancetype)trailerWithRefreshingTarget:(id)target refreshingAction:(SEL)action;
/** 忽略多少scrollView的contentInset的right */
@property (assign, nonatomic) CGFloat ignoredScrollViewContentInsetRight;
@end参考
* Due to there are more functions of this framework，Don't write specific text describe its usage
* You can directly reference examples MJTableViewController、MJCollectionViewController、MJWebViewController，More intuitive and fast.
下拉刷新 01-默认
self.tableView.mj_header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{
//Call this Block When enter the refresh status automatically
}];
或
// Set the callback（Once you enter the refresh status，then call the action of target，that is call [self loadNewData]）
self.tableView.mj_header = [MJRefreshNormalHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)];
// Enter the refresh status immediately
[self.tableView.mj_header beginRefreshing];
下拉刷新 02-动画图片
// Set the callback（一Once you enter the refresh status，then call the action of target，that is call [self loadNewData]）
MJRefreshGifHeader *header = [MJRefreshGifHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)];
// Set the ordinary state of animated images
[header setImages:idleImages forState:MJRefreshStateIdle];
// Set the pulling state of animated images（Enter the status of refreshing as soon as loosen）
[header setImages:pullingImages forState:MJRefreshStatePulling];
// Set the refreshing state of animated images
[header setImages:refreshingImages forState:MJRefreshStateRefreshing];
// Set header
self.tableView.mj_header = header;
下拉刷新 03-隐藏时间
// Hide the time
header.lastUpdatedTimeLabel.hidden = YES;
下拉刷新 04-隐藏状态和时间
// Hide the time
header.lastUpdatedTimeLabel.hidden = YES;
// Hide the status
header.stateLabel.hidden = YES;
下拉刷新 05-自定义标题
// 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];
下拉刷新 06-DIY 刷新控制
self.tableView.mj_header = [MJDIYHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)];
// Implementation reference to MJDIYHeader.h和MJDIYHeader.m
下拉刷新 01-默认
self.tableView.mj_footer = [MJRefreshAutoNormalFooter footerWithRefreshingBlock:^{
//Call this Block When enter the refresh status automatically
}];
或
// Set the callback（Once you enter the refresh status，then call the action of target，that is call [self loadMoreData]）
self.tableView.mj_footer = [MJRefreshAutoNormalFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];
下拉刷新 02-动画图片
// Set the callback（Once you enter the refresh status，then call the action of target，that is call [self loadMoreData]）
MJRefreshAutoGifFooter *footer = [MJRefreshAutoGifFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];
// Set the refresh image
[footer setImages:refreshingImages forState:MJRefreshStateRefreshing];
// Set footer
self.tableView.mj_footer = footer;
下拉刷新 03-隐藏刷新状态标题
// Hide the title of refresh status
footer.refreshingTitleHidden = YES;
// If does have not above method，then use footer.stateLabel.hidden = YES;
下拉刷新 04-全部加载完毕
//Become the status of NoMoreData
[footer noticeNoMoreData];
下拉刷新 05-DIY 标题
// Set title
[footer setTitle:@"Click or drag up to refresh" forState:MJRefreshStateIdle];
[footer setTitle:@"Loading more ..." forState:MJRefreshStateRefreshing];
[footer setTitle:@"No more data" forState:MJRefreshStateNoMoreData];
// Set font
footer.stateLabel.font = [UIFont systemFontOfSize:17];
// Set textColor
footer.stateLabel.textColor = [UIColor blueColor];
下拉刷新 06-加载后隐藏
//Hidden current control of the pull to refresh
self.tableView.mj_footer.hidden = YES;
下拉刷新 07-自动回弹01
self.tableView.mj_footer = [MJRefreshBackNormalFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];
下拉刷新 08-自动回弹02
MJRefreshBackGifFooter *footer = [MJRefreshBackGifFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];
// Set the normal state of the animated image
[footer setImages:idleImages forState:MJRefreshStateIdle];
// Set the pulling state of animated images（Enter the status of refreshing as soon as loosen）
[footer setImages:pullingImages forState:MJRefreshStatePulling];
// Set the refreshing state of animated images
[footer setImages:refreshingImages forState:MJRefreshStateRefreshing];
// Set footer
self.tableView.mj_footer = footer;
下拉刷新 09-自定义刷新控制及自动刷新
self.tableView.mj_footer = [MJDIYAutoFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];
// Implementation reference to MJDIYAutoFooter.h和MJDIYAutoFooter.m
下拉刷新 10-自定义刷新控制及自动回弹
self.tableView.mj_footer = [MJDIYBackFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];
// Implementation reference to MJDIYBackFooter.h和MJDIYBackFooter.m
UICollectionView01-下拉和上滑刷新
// The drop-down refresh
self.collectionView.mj_header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{
//Call this Block When enter the refresh status automatically
}];
// The pull to refresh
self.collectionView.mj_footer = [MJRefreshAutoNormalFooter footerWithRefreshingBlock:^{
//Call this Block When enter the refresh status automatically
}];
UICollectionView02-拖动刷新
// The trailer refresh
self.collectionView.mj_trailer = [MJRefreshNormalTrailer trailerWithRefreshingBlock:^{
//Call this Block When enter the refresh status automatically
}];
WKWebView01-下拉刷新
//Add the control of The drop-down refresh
self.webView.scrollView.mj_header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{
//Call this Block When enter the refresh status automatically
}];
提醒
- ARC
- iOS >= 9.0
- iPhone \ iPad屏幕无论如何
寻找志同道合的小伙伴
- 由于本人工作繁忙，没有太多时间去维护MJRefresh，在此向广大框架使用者说声：非常抱歉！
😞 - 现寻求志同道合的小伙伴一起维护此框架，有兴趣的小伙伴可以发邮件给我，非常感谢
😊 - 如果一切顺利，我将开放框架维护权限（github、pod等）
- 目前已经找到3位小伙伴(＾－＾)V