MagiRefresh
内置多种动画、可自定义和灵活的iOS下拉刷新框架(Swift实现)
提交 bug · 提交需求
屏幕截图
| MagiRefreshStyle | 顶部屏幕截图 | 底部屏幕截图 |
| 原生 |  |
 |
| 复制者Woody |  |
 |
| 复制者Allen |  |
 |
| 复制者Circle |  |
 |
| 复制者Dot |  |
 |
| 复制者Arc |  |
 |
| 复制者Triangle |  |
 |
| 可动画的Ring |  |
 |
| 可动画的Arrow |  |
 |
特点
- 支持多样式选择与自定义
总共有9种动画样式
- 非刷新状态自动隐藏
即使手动调整过contentInset，依然能够在非刷新状态自动隐藏影。最常见的情况是：当数据量过少，UITableView停止刷新后，用户依旧能看到刷新控件的存在，从而影响视觉体验。
- 刷新结束时抗抖动
当UIScrollView处于刷新状态，且用户滑动UIScrollView，当刷新结束时，MagiRefresh不会调整UIScrollView的内容，从而导致页面跳动；
- 支持设置控件高度
stretchOffsetYAxisThreshold是根据刷新控件的高度进行的比例调整。如：当设置stretchOffsetYAxisThreshold为1.5时，触发刷新的偏移距离将调整为原来的1.5倍。(设置时请大于1)
- 支持全局配置
MagiRefreshDefaults类似一个配置表，通过该配置表配置全局的刷新样式，而无需在每一个页面初始化或者绑定刷新控件。
- 支持进度回调
实时回调拖拽的偏移比例，对于扩展接口，可根据进度调整动画。该接口的开放可用于扩展更多的刷新样式。
- 自适应contentInset系统调整与手动调整
自适应iOS7以后UINavigationController自动调整scrollview contentOffset，MagiRefresh也对iOS 11进行了适配；当您手动设置了contentInset的值，也无需担心MagiRefresh会影响到视觉效果。
- 解决刷新状态分组视图悬停问题
即使在列表滑动时，分组视图也将跟随ScrollView滑动（即使处于高速滑动状态下！）。
-
支持预加载
当用户滑动scrollview接近至底部时，将会自动触发刷新，无需用户再滑至底部后拉起scrollview。该功能默认不开启，因为多数人不查看文档便欣然使用该功能，不正确使用极易引发刷新无法停止。
使用预加载功能，请严格按以下要求使用
-
tableView.magiRefresh.footer?.isAutoRefreshOnFoot = true请手动将刷新该属性设为False； -
在刷新调用的block块中，严格按下列逻辑编写：
if (没有数据需要拼接了) { self?.tableView.magiRefresh.footer?.endRefreshingAndNoLongerRefreshingWithAlertText("no more") } else { self?.tableView.magiRefresh.footer?.endRefreshingWithAlertText( "Did load successfully", completion:nil) }
-
-
文档覆盖率100%、支持横竖屏切换自适应、iOS 7+。
使用
1.初始化控件
- 方式一
// MARK: - head
tableView.magiRefresh.bindStyleForHeaderRefresh(themeColor: UIColor.red,
refreshStyle: MagiRefreshStyle.animatableArrow,
completion: {
print("加载完成处理逻辑")
})
// MARK: - foot
tableView.magiRefresh.bindStyleForFooterRefresh(themeColor: UIColor.red,
refreshStyle: MagiRefreshStyle.animatableArrow,
completion: {
print("加载完成处理逻辑")
})
// MARK: - auto refresh
tableView.magiRefresh.footer?.isAutoRefreshOnFoot = true- 方式二
let header = MagiArrowHeader()
header.refreshClosure = { [weak self] in
}
tableView.magiRefresh.header = header- 方式三 全局配置
func application(_ application: UIApplication, didFinishLaunchingWithOptions
launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
MagiRefreshDefaults.shared.headerDefaultStyle = .replicatorAllen
return true
}
// MARK: - global
tableView.magiRefresh.bindStyleForHeaderRefresh {
}
3.手动触发刷新
tableView.magiRefresh.header?.beginRefreshing()
tableView.magiRefresh.footer?.beginRefreshing()4.结束刷新
/*
一般方式结束刷新
*/
func endRefreshing()
/*
结束刷新且需要提示文字
*/
func endRefreshingWithAlertText(_ text: String = "", completion: (()->())?)
/*
结束刷新且不再需要刷新功能
*/
func endRefreshingAndNoLongerRefreshingWithAlertText(_ text: String)5.重新恢复刷新
/**
当调用过 ‘endRefreshingAndNoLongerRefreshingWithAlertText’,
且重新需要恢复刷新功能室，调用下面方法
*/
func resumeRefreshAvailable()自定义
以MagiRefreshHeaderConontrol为例：
override func setupProperties() {
super.setupProperties()
//初始化属性
}
override func magiDidScrollWithProgress(progress: CGFloat, max: CGFloat) {
//进度回调
}
override func magiRefreshStateDidChange(_ status: MagiRefreshStatus) {
super.magiRefreshStateDidChange(status)
switch status {
case .none:
break
case .scrolling:
break
case .ready:
break
case .refreshing:
break
case .willEndRefresh:
break
}
}小记
这个框架是我国最近在写一个新的项目Swift，因为是新的所以有很多东西运用比较新的技术，但是我看到了MJRefresh这个OC框架不能忍，我看了很多Swift的下拉刷新框架都觉得不是很好，但是不久之前看到了一个OC的框架KafkaRefresh，我决定修改一下架构然后重写了一个Swift版的，当然架构还是有不同的但是样式是一样的