除了使用 UIRefreshControl,網上也有許多第三方刷新庫可供選擇。MJRefresh 是其中比較優秀的一個。
一、MJRefresh介紹
(1)MJRefresh 是一個使用 Objective-C 寫的刷新庫,使用簡單。
(2)MJRefresh 既可以實現下拉刷新,也能實現上拉加載。
(3)支持如下控件的刷新:UIScrollView、UITableView、UICollectionView、UIWebView。
(4)GitHub 主頁地址:https://github.com/CoderMJLee/MJRefresh
(5)MJRefresh 類結構圖如下:
二、MJRefresh的使用
1,安裝配置
(1)首先將 MJRefresh 庫下載到本地,將其中的 MJRefresh 文件夾添加到項目中來。
(2)由于 MJRefresh 是使用 OC 寫的,所以我們還需要創建一個橋接頭文件 bridge.h,并在項目中配置。其內容如下:
#import "MJRefresh.h"
2,使用樣例
下面給 tableView 添加一個下拉刷新功能,每次下拉會隨機生成10條數據,并刷新表格。(生成隨機數據的時候會等待2秒,模擬網絡請求)。具體效果圖如下:
(1)對于下拉的響應事件,我們可以通過設置其 target action 來關聯。樣例完整代碼如下:
import UIKit
class ViewController: UIViewController, UITableViewDelegate, UITableViewDataSource {
var items:[String]!
var tableView:UITableView?
// 頂部刷新
let header = MJRefreshNormalHeader()
override func loadView() {
super.loadView()
}
override func viewDidLoad() {
super.viewDidLoad()
//隨機生成一些初始化數據
refreshItemData()
//創建表視圖
self.tableView = UITableView(frame: self.view.frame, style:.plain)
self.tableView!.delegate = self
self.tableView!.dataSource = self
//創建一個重用的單元格
self.tableView!.register(UITableViewCell.self,
forCellReuseIdentifier: "SwiftCell")
self.view.addSubview(self.tableView!)
//下拉刷新相關設置
header.setRefreshingTarget(self, refreshingAction: #selector(ViewController.headerRefresh))
self.tableView!.mj_header = header
}
//初始化數據
func refreshItemData() {
items = []
for _ in 0...9 {
items.append("條目\(Int(arc4random()%100))")
}
}
//頂部下拉刷新
func headerRefresh(){
print("下拉刷新.")
sleep(2)
//重現生成數據
refreshItemData()
//重現加載表格數據
self.tableView!.reloadData()
//結束刷新
self.tableView!.mj_header.endRefreshing()
}
//在本例中,只有一個分區
func numberOfSections(in tableView: UITableView) -> Int {
return 1
}
//返回表格行數(也就是返回控件數)
func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
return self.items.count
}
//創建各單元顯示內容(創建參數indexPath指定的單元)
func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath)
-> UITableViewCell {
//為了提供表格顯示性能,已創建完成的單元需重復使用
let identify:String = "SwiftCell"
//同一形式的單元格重復使用,在聲明時已注冊
let cell = tableView.dequeueReusableCell(withIdentifier: identify,
for: indexPath)
cell.accessoryType = .disclosureIndicator
cell.textLabel?.text = self.items[indexPath.row]
return cell
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
}
(2)下拉響應方法也可以直接寫在閉包(Block)中。具體區別見下方代碼:
import UIKit
class ViewController: UIViewController, UITableViewDelegate, UITableViewDataSource {
var items:[String]!
var tableView:UITableView?
override func loadView() {
super.loadView()
}
override func viewDidLoad() {
super.viewDidLoad()
//隨機生成一些初始化數據
refreshItemData()
//創建表視圖
self.tableView = UITableView(frame: self.view.frame, style:.plain)
self.tableView!.delegate = self
self.tableView!.dataSource = self
//創建一個重用的單元格
self.tableView!.register(UITableViewCell.self,
forCellReuseIdentifier: "SwiftCell")
self.view.addSubview(self.tableView!)
//下拉刷新相關設置,使用閉包Block
self.tableView!.mj_header = MJRefreshNormalHeader(refreshingBlock: {
print("下拉刷新.")
sleep(2)
//重現生成數據
self.refreshItemData()
//重現加載表格數據
self.tableView!.reloadData()
//結束刷新
self.tableView!.mj_header.endRefreshing()
})
}
//初始化數據
func refreshItemData() {
items = []
for _ in 0...9 {
items.append("條目\(Int(arc4random()%100))")
}
}
//在本例中,只有一個分區
func numberOfSections(in tableView: UITableView) -> Int {
return 1
}
//返回表格行數(也就是返回控件數)
func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
return self.items.count
}
//創建各單元顯示內容(創建參數indexPath指定的單元)
func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath)
-> UITableViewCell {
//為了提供表格顯示性能,已創建完成的單元需重復使用
let identify:String = "SwiftCell"
//同一形式的單元格重復使用,在聲明時已注冊
let cell = tableView.dequeueReusableCell(withIdentifier: identify,
for: indexPath)
cell.accessoryType = .disclosureIndicator
cell.textLabel?.text = self.items[indexPath.row]
return cell
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
}
三、MJRefresh下拉樣式的修改
1,默認樣式
上面的樣例使用的就是默認樣式。會顯示刷新的狀態提示文字,刷新時間,左側還有箭頭或環形進度條表示刷新狀態。
2,隱藏時間
//隱藏時間
header.lastUpdatedTimeLabel.isHidden = true
3,隱藏所有的文字
下面把時間和狀態文字都給隱藏掉。
//隱藏時間
header.lastUpdatedTimeLabel.isHidden = true
//隱藏狀態
header.stateLabel.isHidden = true
4,自定義文字和文字樣式
//修改文字
header.setTitle("下拉下拉下拉", for: .idle)
header.setTitle("松開松開松開", for: .pulling)
header.setTitle("刷新刷新刷新", for: .refreshing)
//修改字體
header.stateLabel.font = UIFont.systemFont(ofSize: 15)
header.lastUpdatedTimeLabel.font = UIFont.systemFont(ofSize: 13)
//修改文字顏色
header.stateLabel.textColor = UIColor.red
header.lastUpdatedTimeLabel.textColor = UIColor.blue
5,自定義圖標
下拉刷新的圖標是可以修改的。不同的狀態,我們都可以設置一個圖片數組,MJRefresh 就會自動播放這幾張圖片,形成動畫。
其中下拉過程中的圖片是根據下拉的距離自動改變。而提示松開刷新,以及正在刷新這兩個狀態下的圖片是定時切換播放的。
(注意:如果要設置圖標,header 就要使用 MJRefreshGifHeader,而不是 MJRefreshNormalHeader。)
//下拉過程時的圖片集合(根據下拉距離自動改變)
var idleImages = [UIImage]()
for i in 1...10 {
idleImages.append(UIImage(named:"idle\(i)")!)
}
header.setImages(idleImages, for: .idle) //idle1,idle2,idle3...idle10
//下拉到一定距離后,提示松開刷新的圖片集合(定時自動改變)
var pullingImages = [UIImage]()
for i in 1...3 {
pullingImages.append(UIImage(named:"pulling\(i)")!)
}
header.setImages(pullingImages, for: .pulling)
//刷新狀態下的圖片集合(定時自動改變)
var refreshingImages = [UIImage]()
for i in 1...3 {
refreshingImages.append(UIImage(named:"refreshing\(i)")!)
}
header.setImages(refreshingImages, for: .refreshing)
動畫圖片切換的時間也是可以修改的:
//下面表示刷新圖片在1秒鐘的時間內播放一輪
header.setImages(refreshingImages, duration: 1, for: .refreshing)