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阅读 158,560评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,104评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,297评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,869评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,275评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,563评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,833评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,543评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,245评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,512评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,011评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,359评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,006评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,062评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,825评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,590评论 2 273
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,501评论 2 268

推荐阅读更多精彩内容