使用pull-to-refresh的简单方法。
📜✍🏻Release Notes: more details
Refer to issue #1616.
- Use
additionalFlipsViewsto append views that need to flip when collectionViewLayout flipsHorizontallyInOppositeLayoutDirection istrue.- Use
flipsHorizontallyInOppositeLayoutDirectionViewsto modify views as the same way above. ⚠️ BUT parent class may be affected. UseadditionalFlipsViewsinstead.
Now MJRefresh components will be rerendered automatically with MJRefreshConfig.default.language setting.
Go i18n folder and see lots of cases. Simulator example is behind i18n tab in right-top corner.
MJRefreshConfig.default.language = "zh-hans"
MJRefreshConfig.default.i18nFilename = "i18n File Name(not include type<.strings>)"
MJRefreshConfig.default.i18nBundle = <i18n Bundle>
i18nDidChange function and reset texts.
// must use this localization methodsBundle.mj_localizedString(forKey: "")// orBundle.mj_localizedString(forKey: "", value:"")override func i18nDidChange() {// Reset texts functionsetupTexts()// Make sure to call super after resetting texts. It will call placeSubViews for applying new layout.super.i18nDidChange()}
MJRefreshDidChangeLanguageNotification notification.Released from 3.7.1
// Example as MJRefreshNormalHeaderfunc addRefreshHeader() {MJRefreshNormalHeader { [weak self] in// load some data}.autoChangeTransparency(true).link(to: tableView)}
UIScrollView、UITableView、UICollectionView、WKWebViewpod 'MJRefresh'github "CoderMJLee/MJRefresh"MJRefresh folder to project#import "MJRefresh.h"
Base CustomMJRefresh.bundle MJRefresh.hMJRefreshConst.h MJRefreshConst.mUIScrollView+MJExtension.h UIScrollView+MJExtension.mUIScrollView+MJRefresh.h UIScrollView+MJRefresh.mUIView+MJExtension.h UIView+MJExtension.m
The class of red text in the chart：You can use them directly
MJRefreshNormalHeaderMJRefreshGifHeaderMJRefreshAutoNormalFooterMJRefreshAutoGifFooterMJRefreshBackNormalFooterMJRefreshBackGifFooterThe class of non-red text in the chart：For inheritance，to use DIY the control of refresh
About how to DIY the control of refresh，You can refer the Class in below Chart
/** 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;@end
@interface MJRefreshHeader : MJRefreshComponent/** create header */+ (instancetype)headerWithRefreshingBlock:(MJRefreshComponentRefreshingBlock)refreshingBlock;/** create 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;@end
@interface MJRefreshFooter : MJRefreshComponent/** create footer */+ (instancetype)footerWithRefreshingBlock:(MJRefreshComponentRefreshingBlock)refreshingBlock;/** create 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;@end
@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;@end
@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.
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];
// 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 headerself.tableView.mj_header = header;
// Hide the timeheader.lastUpdatedTimeLabel.hidden = YES;
// Hide the timeheader.lastUpdatedTimeLabel.hidden = YES;// Hide the statusheader.stateLabel.hidden = YES;
// Set title[header setTitle:@"Pull down to refresh" forState:MJRefreshStateIdle];[header setTitle:@"Release to refresh" forState:MJRefreshStatePulling];[header setTitle:@"Loading ..." forState:MJRefreshStateRefreshing];// Set fontheader.stateLabel.font = [UIFont systemFontOfSize:15];header.lastUpdatedTimeLabel.font = [UIFont systemFontOfSize:14];// Set textColorheader.stateLabel.textColor = [UIColor redColor];header.lastUpdatedTimeLabel.textColor = [UIColor blueColor];
self.tableView.mj_header = [MJDIYHeader headerWithRefreshingTarget:self refreshingAction:@selector(loadNewData)];// Implementation reference to MJDIYHeader.h和MJDIYHeader.m
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)];
// 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 footerself.tableView.mj_footer = footer;
// Hide the title of refresh statusfooter.refreshingTitleHidden = YES;// If does have not above method，then use footer.stateLabel.hidden = YES;
//Become the status of NoMoreData[footer noticeNoMoreData];
// 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 fontfooter.stateLabel.font = [UIFont systemFontOfSize:17];// Set textColorfooter.stateLabel.textColor = [UIColor blueColor];
//Hidden current control of the pull to refreshself.tableView.mj_footer.hidden = YES;
self.tableView.mj_footer = [MJRefreshBackNormalFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];
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 footerself.tableView.mj_footer = footer;
self.tableView.mj_footer = [MJDIYAutoFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];// Implementation reference to MJDIYAutoFooter.h和MJDIYAutoFooter.m
self.tableView.mj_footer = [MJDIYBackFooter footerWithRefreshingTarget:self refreshingAction:@selector(loadMoreData)];// Implementation reference to MJDIYBackFooter.h和MJDIYBackFooter.m
// The drop-down refreshself.collectionView.mj_header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{//Call this Block When enter the refresh status automatically}];// The pull to refreshself.collectionView.mj_footer = [MJRefreshAutoNormalFooter footerWithRefreshingBlock:^{//Call this Block When enter the refresh status automatically}];
// The trailer refreshself.collectionView.mj_trailer = [MJRefreshNormalTrailer trailerWithRefreshingBlock:^{//Call this Block When enter the refresh status automatically}];
//Add the control of The drop-down refreshself.webView.scrollView.mj_header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{//Call this Block When enter the refresh status automatically}];
