MJRefresh 源码学习笔记：架构与功能详解

2023-12-04 10:33:31

在移动应用开发中，下拉刷新和上拉加载更多功能已成为用户体验的重要组成部分。MJRefresh 是 iOS 开发社区中备受推崇的此类第三方控件，以其易用性、灵活性以及高效性能而著称。为了深入了解其内部机制并掌握其定制技巧，本文将带你踏上 MJRefresh 源码学习之旅。

架构概览

MJRefresh 的架构设计遵循单例模式，通过全局访问点来管理刷新和加载更多操作。它的核心组件包括：

MJRefreshHeader ：下拉刷新头部视图。
MJRefreshFooter ：上拉加载更多尾部视图。
MJRefreshNormalHeader ：MJRefreshHeader 的标准实现，提供基本的下拉刷新功能。
MJRefreshAutoNormalFooter ：MJRefreshFooter 的标准实现，提供自动上拉加载更多功能。
MJRefreshBackStateFooter ：MJRefreshFooter 的子类，在到达底部时自动恢复到初始状态。

功能模块

MJRefresh 提供了一系列功能模块，涵盖刷新和加载更多操作的各个方面：

下拉刷新 ：通过下拉手势触发下拉刷新操作，并提供各种自定义选项，例如刷新提示文字、刷新动画和刷新触发位置。
上拉加载更多 ：通过上拉手势触发上拉加载更多操作，并允许配置自动加载、加载更多提示和加载更多动画。
状态管理 ：提供一系列状态管理方法，包括刷新开始、刷新结束、加载更多开始和加载更多结束。
事件处理 ：支持添加刷新和加载更多事件监听器，以便在特定事件发生时执行自定义操作。
扩展性 ：允许通过子类化定制刷新和加载更多行为，实现更复杂或特定的功能。

源码探索

MJRefresh 源码位于 GitHub 上，访问地址为 https://github.com/CoderMJLee/MJRefresh。我们首先从 MJRefresh.h 头文件入手，其中声明了 MJRefresh 的主要类和方法。

#import <UIKit/UIKit.h>

@interface MJRefresh : NSObject

+ (MJRefreshHeader *)headerWithRefreshingBlock:(MJRefreshComponentRefreshingBlock)refreshingBlock;
+ (MJRefreshFooter *)footerWithRefreshingBlock:(MJRefreshComponentRefreshingBlock)refreshingBlock;
@end

这两个工厂方法用于创建 MJRefreshHeader 和 MJRefreshFooter 实例，并提供一个刷新操作的块作为参数。接下来，我们深入研究 MJRefreshHeader.h 头文件，这是所有下拉刷新头部视图的基类。

#import "MJRefreshComponent.h"
#import "UIScrollView+MJRefresh.h"

NS_ASSUME_NONNULL_BEGIN

@interface MJRefreshHeader : MJRefreshComponent

@property (nonatomic, copy) void (^refreshingBlock)(MJRefreshHeader *header);
@end

NS_ASSUME_NONNULL_END

MJRefreshHeader 继承自 MJRefreshComponent，它定义了刷新操作的块 refreshingBlock。然后，我们继续探究 MJRefreshNormalHeader.h 头文件，它是 MJRefreshHeader 的标准实现。

#import "MJRefreshHeader.h"

@interface MJRefreshNormalHeader : MJRefreshHeader

@property (nonatomic, copy) NSString *refreshingTitle;
@property (nonatomic, copy) NSString *idleTitle;
@property (nonatomic, copy) NSString *pullingTitle;

@end

MJRefreshNormalHeader 引入了用于配置刷新标题的属性，例如 refreshingTitle、idleTitle 和 pullingTitle。最后，我们查看 MJRefreshAutoNormalFooter.h 头文件，它是 MJRefreshFooter 的标准实现。

#import "MJRefreshFooter.h"

@interface MJRefreshAutoNormalFooter : MJRefreshFooter

@property (nonatomic, copy) NSString *refreshingTitle;
@property (nonatomic, copy) NSString *idleTitle;
@property (nonatomic, copy) NSString *noMoreDataTitle;

@end