https://github.com/1691665955/mzrefresh
Swift下拉刷新、上拉加载组件，简单易用
https://github.com/1691665955/mzrefresh
ios load loadmore pulldown refresh swift
Last synced: 7 months ago
JSON representation
Swift下拉刷新、上拉加载组件，简单易用
- Host: GitHub
- URL: https://github.com/1691665955/mzrefresh
- Owner: 1691665955
- License: mit
- Created: 2022-01-13T09:07:20.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-12-07T03:34:29.000Z (almost 2 years ago)
- Last Synced: 2025-03-13T08:39:19.636Z (7 months ago)
- Topics: ios, load, loadmore, pulldown, refresh, swift
- Language: Swift
- Homepage:
- Size: 9.86 MB
- Stars: 32
- Watchers: 2
- Forks: 8
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# MZRefresh
Swift下拉刷新、上拉加载组件，简单易用，适用于UIScrollView、UITableView、UICollectionView等继承于UIScrollView的组件。
下拉刷新
上拉加载
#### Cocoapods 引入
```
pod 'MZRefresh', '~> 0.0.9'
```
#### 使用
这里使用UIScrollView为例
- 添加刷新组件
```
// 添加下拉刷新组件
scrollView.setRefreshHeader(MZRefreshNormalHeader(beginRefresh: {
// 请求数据，请求到数据后记得停止刷新动画
self?.loadNew()
}))
// 添加上拉加载组件
scrollView.setRefreshFooter(MZRefreshNormalFooter(beginRefresh: {
// 请求数据，请求到数据后记得停止刷新动画
self?.loadMore()
}))
func loadNew() {
// 请求数据，刷新页面
// 停止下拉刷新动画
scrollView.stopHeaderRefreshing()
}
func loadMore(_ count: Int) {
// 请求数据，刷新页面
// 停止上拉加载动画
scrollView.stopFooterRefreshing()
}
```
- 移除刷新组件
```
// 移除下拉刷新组件
scrollView.removeRefreshHeader()
// 移除上拉加载组件
scrollView.removeRefreshFooter()
```
- 手动刷新或加载更多
```
// 手动触发下拉刷新
// animated代表是否执行动画
self.scrollView.startHeaderRefreshing(animated: true)
// 手动触发上拉加载
// animated代表是否执行动画
self.scrollView.startFooterRefreshing(animated: true)
```
- 停止刷新动画
```
// 停止下拉刷新动画
scrollView.stopHeaderRefreshing()
// 停止上拉加载动画
scrollView.stopFooterRefreshing()
```
#### 配置管理
- 通过MZRefreshConfig类管理部分组件属性
```
MZRefreshConfig.shareInstance.setRefreshStatusColor(.brown)
MZRefreshConfig.shareInstance.setRefreshStatusFont(.systemFont(ofSize: 18))
MZRefreshConfig.shareInstance.setRefreshTimeColor(.cyan)
MZRefreshConfig.shareInstance.setRefreshTimeFont(.systemFont(ofSize: 12))
```
#### MZRefreshNormalHeader & MZRefreshNormalFooter
- 刷新组件初始化
```
// 下拉刷新组件
// type 刷新动画类型
// color 刷新动画颜色
// showTime 是否显示上次刷新时间
// beginRefresh 刷新回调
MZRefreshNormalHeader(type: .lineSpinFadeLoader, color: .brown, showTime: true, beginRefresh: {
})
// 上拉加载组件
// type 刷新动画类型
// color 刷新动画颜色
// beginRefresh 刷新回调
MZRefreshNormalFooter(type: .lineSpinFadeLoader, color: .brown, beginRefresh: {
})
```
- 动画类型
1
2
3
#### MZRefreshGifHeader & MZRefreshGifFooter
- 刷新组件初始化
```
// 下拉刷新组件
// images gif分解图片数组
// size gif图片显示大小
// animationDuration 是否显示上次下拉刷新时间
// showTime gif动画时间
// beginRefresh 刷新回调
MZRefreshGifHeader(images: animationImages, size: 60, animationDuration: 1.0, showTime: true, beginRefresh: {
})
// 上拉加载组件
// images gif分解图片数组
// size gif图片显示大小
// animationDuration 是否显示上次下拉刷新时间
// beginRefresh 刷新回调
MZRefreshGifFooter(images: animationImages, size: 60, animationDuration: 1.0, beginRefresh: {
})
// 下拉刷新组件
// images gif图片Data
// size gif图片显示大小
// animationDuration 是否显示上次下拉刷新时间
// showTime gif动画时间
// beginRefresh 刷新回调
MZRefreshGifHeader(gifImage: data, size: 40, animationDuration: 1.0, showTime: true, beginRefresh: {
})
// 上拉加载组件
// gifImage gif图片Data
// size gif图片显示大小
// animationDuration 是否显示上次下拉刷新时间
// beginRefresh 刷新回调
MZRefreshGifFooter(gifImage: data, size: 40, animationDuration: 0.0, beginRefresh: {
})
// gif图片Data获取方式如下
let path = Bundle.main.path(forResource: "1", ofType: "gif")!
let data = try! Data(contentsOf: URL(fileURLWithPath: path))
```
下拉刷新
上拉加载
#### MZRefreshOnlyGifHeader
- 刷新组件初始化
```
// 下拉刷新组件
// images gif分解图片数组
// size gif图片显示大小
// refreshOffSet 开始刷新所需的偏移量
// animationDuration gif动画时间
// readyImage 释放刷新图片
// beginRefresh 刷新回调
MZRefreshOnlyGifHeader(images: animationImages, size: 80, refreshOffSet: 80, animationDuration: 1.0, readyImage: nil, beginRefresh: {
})
// 下拉刷新组件
// gifImage gif图片Data
// size gif图片显示大小
// refreshOffSet 开始刷新所需的偏移量
// animationDuration gif动画时间
// readyImage 释放刷新图片
// beginRefresh 刷新回调
MZRefreshOnlyGifHeader(gifImage: data, size: 80, refreshOffSet: 80, animationDuration: 1.0, readyImage: nil, beginRefresh: {
})
```
#### stopRefreshingWithNoMoreData
- 设置“NoMoreData”组件
默认样式不需要设置
```
let footer = UILabel(frame: CGRect(x: 0, y: 0, width: SCREEN_WIDTH, height: 40))
footer.font = .systemFont(ofSize: 14)
footer.textAlignment = .center
footer.textColor = .black
footer.text = "—— 生活的强者，往往都能坚持到底 ——"
footer.textColor = .brown
tableView.setRefreshNoMoreDataView(footer)
```
- 没有更多数据加载，取消上拉加载功能
```
// 停止下拉刷新动画，并显示没有更多数据
tableView.stopHeaderRefreshingWithNoMoreData()
// 停止上拉加载动画，并显示没有更多数据
tableView.stopFooterRefreshingWithNoMoreData()
```
默认样式
自定义样式
#### 自定义
- 下拉刷新
通过MZRefreshHeaderComponent协议实现下拉刷新组件自定义，可参考MZRefreshNormalHeader、MZRefreshOnlyGifHeader等组件实现
- 上拉加载
通过MZRefreshFooterComponent协议实现下拉刷新组件自定义，可参考MZRefreshNormalFooter、MZRefreshGifFooter等组件实现