Swift - MJRefresh庫的使用詳解1(配置,及庫自帶的下拉刷新組件)

除了使用 UIRefreshControl,網(wǎng)上也有許多第三方刷新庫可供選擇。MJRefresh 是其中比較優(yōu)秀的一個。

一、MJRefresh介紹

(1)MJRefresh 是一個使用 Objective-C 寫的刷新庫,使用簡單。

(2)MJRefresh 既可以實(shí)現(xiàn)下拉刷新,也能實(shí)現(xiàn)上拉加載。

(3)支持如下控件的刷新:UIScrollView、UITableView、UICollectionView、UIWebView。

(4)GitHub 主頁地址:https://github.com/CoderMJLee/MJRefresh

(5)MJRefresh 類結(jié)構(gòu)圖如下:

5815f1612a76b.png
二、MJRefresh的使用

1,安裝配置

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

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

import "MJRefresh.h"

2,使用樣例

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

5815fb4e8c590.png
(1)對于下拉的響應(yīng)事件,我們可以通過設(shè)置其 target action 來關(guān)聯(lián)。樣例完整代碼如下:

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()

//隨機(jī)生成一些初始化數(shù)據(jù)
refreshItemData()

//創(chuàng)建表視圖
self.tableView = UITableView(frame: self.view.frame, style:.plain)
self.tableView!.delegate = self
self.tableView!.dataSource = self
//創(chuàng)建一個重用的單元格
self.tableView!.register(UITableViewCell.self,
                         forCellReuseIdentifier: "SwiftCell")
self.view.addSubview(self.tableView!)

//下拉刷新相關(guān)設(shè)置
header.setRefreshingTarget(self, refreshingAction: #selector(ViewController.headerRefresh))
self.tableView!.mj_header = header

}

//初始化數(shù)據(jù)
func refreshItemData() {
items = []
for _ in 0...9 {
items.append("條目(Int(arc4random()%100))")
}
}

//頂部下拉刷新
func headerRefresh(){
print("下拉刷新.")
sleep(2)
//重現(xiàn)生成數(shù)據(jù)
refreshItemData()
//重現(xiàn)加載表格數(shù)據(jù)
self.tableView!.reloadData()
//結(jié)束刷新
self.tableView!.mj_header.endRefreshing()
}

//在本例中,只有一個分區(qū)
func numberOfSections(in tableView: UITableView) -> Int {
return 1
}

//返回表格行數(shù)(也就是返回控件數(shù))
func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
return self.items.count
}

//創(chuàng)建各單元顯示內(nèi)容(創(chuàng)建參數(shù)indexPath指定的單元)
func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath)
-> UITableViewCell {
//為了提供表格顯示性能,已創(chuàng)建完成的單元需重復(fù)使用
let identify:String = "SwiftCell"
//同一形式的單元格重復(fù)使用,在聲明時已注冊
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)下拉響應(yīng)方法也可以直接寫在閉包(Block)中。具體區(qū)別見下方代碼:

import UIKit
class ViewController: UIViewController, UITableViewDelegate, UITableViewDataSource {

var items:[String]!
var tableView:UITableView?

override func loadView() {
super.loadView()
}

override func viewDidLoad() {
super.viewDidLoad()

//隨機(jī)生成一些初始化數(shù)據(jù)
refreshItemData()

//創(chuàng)建表視圖
self.tableView = UITableView(frame: self.view.frame, style:.plain)
self.tableView!.delegate = self
self.tableView!.dataSource = self
//創(chuàng)建一個重用的單元格
self.tableView!.register(UITableViewCell.self,
                         forCellReuseIdentifier: "SwiftCell")
self.view.addSubview(self.tableView!)


//下拉刷新相關(guān)設(shè)置,使用閉包Block
self.tableView!.mj_header = MJRefreshNormalHeader(refreshingBlock: {
    print("下拉刷新.")
    sleep(2)
    //重現(xiàn)生成數(shù)據(jù)
    self.refreshItemData()
    //重現(xiàn)加載表格數(shù)據(jù)
    self.tableView!.reloadData()
    //結(jié)束刷新
    self.tableView!.mj_header.endRefreshing()
})

}

//初始化數(shù)據(jù)
func refreshItemData() {
items = []
for _ in 0...9 {
items.append("條目(Int(arc4random()%100))")
}
}

//在本例中,只有一個分區(qū)
func numberOfSections(in tableView: UITableView) -> Int {
return 1
}

//返回表格行數(shù)(也就是返回控件數(shù))
func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
return self.items.count
}

//創(chuàng)建各單元顯示內(nèi)容(創(chuàng)建參數(shù)indexPath指定的單元)
func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath)
-> UITableViewCell {
//為了提供表格顯示性能,已創(chuàng)建完成的單元需重復(fù)使用
let identify:String = "SwiftCell"
//同一形式的單元格重復(fù)使用,在聲明時已注冊
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,默認(rèn)樣式

上面的樣例使用的就是默認(rèn)樣式。會顯示刷新的狀態(tài)提示文字,刷新時間,左側(cè)還有箭頭或環(huán)形進(jìn)度條表示刷新狀態(tài)。

5815fb4e8c590-1.png
2,隱藏時間

5815fb4e7530d.png
//隱藏時間
header.lastUpdatedTimeLabel.isHidden = true
3,隱藏所有的文字

下面把時間和狀態(tài)文字都給隱藏掉。

5815fb4eb7461.png
//隱藏時間
header.lastUpdatedTimeLabel.isHidden = true
//隱藏狀態(tài)
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,自定義圖標(biāo)

下拉刷新的圖標(biāo)是可以修改的。不同的狀態(tài),我們都可以設(shè)置一個圖片數(shù)組,MJRefresh 就會自動播放這幾張圖片,形成動畫。

其中下拉過程中的圖片是根據(jù)下拉的距離自動改變。而提示松開刷新,以及正在刷新這兩個狀態(tài)下的圖片是定時切換播放的。

(注意:如果要設(shè)置圖標(biāo),header 就要使用 MJRefreshGifHeader,而不是 MJRefreshNormalHeader。)

5815fb4ec2023.png
//下拉過程時的圖片集合(根據(jù)下拉距離自動改變)
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)

//刷新狀態(tài)下的圖片集合(定時自動改變)
var refreshingImages = UIImage
for i in 1...3 {
refreshingImages.append(UIImage(named:"refreshing(i)")!)
}
header.setImages(refreshingImages, for: .refreshing)
動畫圖片切換的時間也是可以修改的:

//下面表示刷新圖片在1秒鐘的時間內(nèi)播放一輪
header.setImages(refreshingImages, duration: 1, for: .refreshing)

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

推薦閱讀更多精彩內(nèi)容