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 類結構圖如下:

5815f1612a76b.png

二、MJRefresh的使用

1,安裝配置

(1)首先將 MJRefresh 庫下載到本地,將其中的 MJRefresh 文件夾添加到項目中來。

(2)由于 MJRefresh 是使用 OC 寫的,所以我們還需要創建一個橋接頭文件 bridge.h,并在項目中配置。其內容如下:

   #import "MJRefresh.h"

2,使用樣例

下面給 tableView 添加一個下拉刷新功能,每次下拉會隨機生成10條數據,并刷新表格。(生成隨機數據的時候會等待2秒,模擬網絡請求)。具體效果圖如下:

5815fb4e8c590.png

(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,默認樣式

上面的樣例使用的就是默認樣式。會顯示刷新的狀態提示文字,刷新時間,左側還有箭頭或環形進度條表示刷新狀態。

5815fb4e8c590-1.png

2,隱藏時間

5815fb4e7530d.png
//隱藏時間
header.lastUpdatedTimeLabel.isHidden = true

3,隱藏所有的文字

下面把時間和狀態文字都給隱藏掉。

5815fb4eb7461.png
 //隱藏時間
header.lastUpdatedTimeLabel.isHidden = true
//隱藏狀態
header.stateLabel.isHidden = true

4,自定義文字和文字樣式

5815fb4ec5ae6.png
//修改文字
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。)

5815fb4ec2023.png
//下拉過程時的圖片集合(根據下拉距離自動改變)
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)
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,702評論 6 534
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,615評論 3 419
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,606評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,044評論 1 314
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,826評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,227評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,307評論 3 442
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,447評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,992評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,807評論 3 355
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,001評論 1 370
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,550評論 5 361
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,243評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,667評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,930評論 1 287
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,709評論 3 393
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,996評論 2 374

推薦閱讀更多精彩內容