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)

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏iOS 开发杂谈

浅析 NSTimer 和 CADisplayLink 内存泄漏

谈论 NSTimer & CADisplayLink 内存泄漏,要理解 NSTimer & CADisplayLink 的基础概念,下面通过一个倒计时的实现的 ...

2181
来自专栏TechBox

UITableViewCell系列之(一)让你的cell支持二次编辑

1863
来自专栏技术总结

MJRefresh源码剖析与学习

建议查看原文:https://www.jianshu.com/p/23c876f8ae39(不定时更新)

2294
来自专栏学海无涯

iOS开发之UIRefreshControl使用踩坑

问题描述 接上一个话题,实现了TabBar的点击刷新以后,开始继续写完成功能,刷新UITableView,于是考虑到iOS 10以后,UIScrollView已...

34710
来自专栏陈满iOS

iOS-JavaScript交互方案:网页监听APP返回键(goback)+APP监听网页返回键(JS调用OC对象方法)

新建CMWebViewController,让其继承UIViewController,即:

5253
来自专栏谈补锅

自定义UITableViewCell实现左滑动多菜单功能LeftSwipe

1、使用自定义UITableViewCell + UISwipeGestureRecognizer + 代理 实现;

1603
来自专栏DannyHoo的专栏

MJRefreshFooter明杰刷新控件结束加载显示“没有更多内容”

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/u010105969/article/details/...

2541
来自专栏老司机的简书

TableView优化之快速滑动下的忽略加载

这两天一直在搞一个TableView的工具类,因为觉得这个东西写完可以一劳永逸,所以就去搞了一下,主要是有助于TableView的快捷开发。没什么好废话的了,直...

1012
来自专栏full stack development

iOS的异步绘制--YYAsyncLayer源码分析

最近看了YYAsyncLayer在这里总结一下。YYAsyncLayer是整个YYKit异步渲染的基础。整个项目的Github地址在这里。你可以先下载了一睹为快...

6130
来自专栏陈满iOS

iOS开发验证:取消UITableView的Footer自带的悬停效果

对于继承UITableViewController,如果想更改tableview样式,请重写初始化方法:

6642

扫码关注云+社区

领取腾讯云代金券