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

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

一切蟋、MJRefresh介紹

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

(2)MJRefresh 既可以實現(xiàn)下拉刷新,也能實現(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 文件夾添加到項目中來森爽。

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

import "MJRefresh.h"

2,使用樣例

下面給 tableView 添加一個下拉刷新功能菊匿,每次下拉會隨機生成10條數(shù)據(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()

//隨機生成一些初始化數(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()

//隨機生成一些初始化數(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)形進度條表示刷新狀態(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)系作者
  • 序言:七十年代末病梢,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子栅屏,更是在濱河造成了極大的恐慌飘千,老刑警劉巖,帶你破解...
    沈念sama閱讀 218,755評論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件栈雳,死亡現(xiàn)場離奇詭異护奈,居然都是意外死亡,警方通過查閱死者的電腦和手機哥纫,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,305評論 3 395
  • 文/潘曉璐 我一進店門霉旗,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人蛀骇,你說我怎么就攤上這事厌秒。” “怎么了擅憔?”我有些...
    開封第一講書人閱讀 165,138評論 0 355
  • 文/不壞的土叔 我叫張陵鸵闪,是天一觀的道長。 經(jīng)常有香客問我暑诸,道長蚌讼,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,791評論 1 295
  • 正文 為了忘掉前任个榕,我火速辦了婚禮篡石,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘西采。我一直安慰自己凰萨,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 67,794評論 6 392
  • 文/花漫 我一把揭開白布械馆。 她就那樣靜靜地躺著胖眷,像睡著了一般。 火紅的嫁衣襯著肌膚如雪霹崎。 梳的紋絲不亂的頭發(fā)上瘦材,一...
    開封第一講書人閱讀 51,631評論 1 305
  • 那天,我揣著相機與錄音仿畸,去河邊找鬼。 笑死,一個胖子當(dāng)著我的面吹牛错沽,可吹牛的內(nèi)容都是我干的簿晓。 我是一名探鬼主播,決...
    沈念sama閱讀 40,362評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼千埃,長吁一口氣:“原來是場噩夢啊……” “哼憔儿!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起放可,我...
    開封第一講書人閱讀 39,264評論 0 276
  • 序言:老撾萬榮一對情侶失蹤谒臼,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后耀里,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體蜈缤,經(jīng)...
    沈念sama閱讀 45,724評論 1 315
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,900評論 3 336
  • 正文 我和宋清朗相戀三年冯挎,在試婚紗的時候發(fā)現(xiàn)自己被綠了底哥。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 40,040評論 1 350
  • 序言:一個原本活蹦亂跳的男人離奇死亡房官,死狀恐怖趾徽,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情翰守,我是刑警寧澤孵奶,帶...
    沈念sama閱讀 35,742評論 5 346
  • 正文 年R本政府宣布,位于F島的核電站蜡峰,受9級特大地震影響了袁,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜事示,卻給世界環(huán)境...
    茶點故事閱讀 41,364評論 3 330
  • 文/蒙蒙 一早像、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧肖爵,春花似錦卢鹦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,944評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至秒啦,卻和暖如春熬粗,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背余境。 一陣腳步聲響...
    開封第一講書人閱讀 33,060評論 1 270
  • 我被黑心中介騙來泰國打工驻呐, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留灌诅,地道東北人。 一個月前我還...
    沈念sama閱讀 48,247評論 3 371
  • 正文 我出身青樓含末,卻偏偏與公主長得像猜拾,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子佣盒,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 44,979評論 2 355

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