Swift - MJRefresh庫的使用詳解1（配置，及庫自帶的下拉重新整理元件）

除了使用 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)