iOS 面向协议方式封装空白页功能
为了良好的交互体验,相信大家在对待
scrollView
无数据时的提示页都会使用一些第三方来定制,最典型的就是使用DZNEmptyDataSet。但是每个界面都写一堆与DZNEmptyDataSetDelegate
,DZNEmptyDataSetSource
相关的代码就不太好,那一般情况下自然的就会采用继承的方式来避免。而Swift除了可以面向对象编程,它还可以面向协议编程。那可不可以也用协议来解决情况呢?嘿嘿,这个可以有,那我们接下来就来试试怎么通过协议的方式来避免上述情况,并且实现一行代码添加空白页功能
前言
如果对面向协议有疑问的同学可以看下我之前的两篇文章
之前的文章中提到了,协议除了起规范作用,还有别一个用处,就是赋予能力。我们现在的目的就是让目标控制器或者目标视图在遵守我们的协议后,就可以有实现空白页的功能。
一、基本实现
1、创建协议
// MARK:- 空视图占位协议
public protocol LXFEmptyDataSetable {
}
2、确定面向类
确定我们面向的类,一般tableView
或者collectionView
都是写在控制器里,那我们面向的类就规定为UIViewController
,或许也有人写在UIView
里,不过这里先按UIViewController
来写吧
// MARK:- UIViewController - 空视图占位协议
public extension LXFEmptyDataSetable where Self : UIViewController {
// 3、的实现的方法写在这里
}
3、定义功能方法
将scrollView
传递进来,让我们定义的方法来暗地里做些操作
func lxf_EmptyDataSet(_ scrollView: UIScrollView) {
scrollView.emptyDataSetDelegate = self
scrollView.emptyDataSetSource = self
}
4、设置数据源和代理
在3、定义功能方法
中将delegate
和source
设置为了self
,而协议是无法遵守再次遵守其它协议的,那让什么来遵守对应的协议呢?要明白这里的self
指的是UIViewController
,考虑到UIView
的可能,这里我就让万物对象之父NSObject
来遵守,并实现对应的数据源方法和代理方法
extension NSObject : DZNEmptyDataSetDelegate, DZNEmptyDataSetSource {
public func image(forEmptyDataSet scrollView: UIScrollView!) -> UIImage! {
// 返回提示图片
}
public func title(forEmptyDataSet scrollView: UIScrollView!) -> NSAttributedString! {
// 设置富文本标题
}
public func verticalOffset(forEmptyDataSet scrollView: UIScrollView!) -> CGFloat {
// 设置纵向偏移
}
}
二、定制空白页
通过上述步骤后,只要让UIViewController
遵守我们的协议,再调用一下lxf_EmptyDataSet
方法就可以实现数据空白页了。但是,这样直接写死的方式很不好,有时候一些场景是需要我们做出定制的,那怎么实现定制呢?协议又不能有自己的变量来存放我们的定制。
<font color='red'>这里先做出一个限定,我们要使用重载方法来完成该功能,实现即可高定制,又可使用默认定制。</font>
回到刚刚的话题,使用UserDefaults来实现可以吗?可以,但是比较麻烦,因为UserDefaults是单例,整个进程共用这一份资源,如果你当前controller
遵守了我们的协议LXFEmptyDataSetable
并做出了定制,那么当下一个controller
在遵守协议后使用了默认定制
时,那你要怎么办?还要区分scrollView
,那就得保存当前scrollView
,在退出当前controller
后还要把对应的东西置空。好咯好咯,那你说到底要怎么搞才最合适?
解决方案:拓展
UIScrollView
!!!有没有发现?,非常地恰巧,我们定义的方法lxf_EmptyDataSet
需要外界将UIScrollView
传递进来,在DZNEmptyDataSet
的数据源方法和代理方法也有scrollView
。那让UIScrollView
来携带我们的定制就好啦。
1、定义定制相关的枚举
这里我定义了常用的定制相关的枚举
public enum LXFEmptyDataSetAttributeKeyType {
/// 纵向偏移(-50) CGFloat
case verticalOffset
/// 提示语(暂无数据) String
case tipStr
/// 提示语的font(system15) UIFont
case tipFont
/// 提示语颜色(D2D2D2) UIColor
case tipColor
/// 提示图(LXFEmptyDataPic) UIImage
case tipImage
/// 允许滚动(true) Bool
case allowScroll
}
2、拓展UIScrollView
为UIScrollView
定义一个定制相关的属性字典
extension UIScrollView {
private struct AssociatedKeys {
static var lxf_emptyAttributeDict:[LXFEmptyDataSetAttributeKeyType : Any]?
}
/// 属性字典
var lxf_emptyAttributeDict: [LXFEmptyDataSetAttributeKeyType : Any]? {
get {
return objc_getAssociatedObject(self, &AssociatedKeys.lxf_emptyAttributeDict) as? [LXFEmptyDataSetAttributeKeyType : Any]
}
set {
objc_setAssociatedObject(self, &AssociatedKeys.lxf_emptyAttributeDict, newValue as [LXFEmptyDataSetAttributeKeyType : Any]?, objc_AssociationPolicy.OBJC_ASSOCIATION_RETAIN_NONATOMIC)
}
}
}
3、完善lxf_EmptyDataSet方法
这里我们让外界通过闭包的方式来定制自己的空白页
// MARK:- UIViewController - 空视图占位协议
public extension LXFEmptyDataSetable where Self : UIViewController {
func lxf_EmptyDataSet(_ scrollView: UIScrollView, attributeBlock: (()->([LXFEmptyDataSetAttributeKeyType : Any]))? = nil) {
scrollView.lxf_emptyAttributeDict = attributeBlock != nil ? attributeBlock!() : nil
scrollView.emptyDataSetDelegate = self
scrollView.emptyDataSetSource = self
}
}
4、使用定制属性字典
这里以返回提示图片的方法为例吧
public func image(forEmptyDataSet scrollView: UIScrollView!) -> UIImage! {
guard let tipImg = scrollView.lxf_emptyAttributeDict?[.tipImage] as? UIImage else {
return UIImage(named: "LXFEmptyDataPic")
}
return tipImg
}
5、外界的使用姿势
class LXFEmptyDemoController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
initUI()
}
}
extension LXFEmptyDemoController: LXFEmptyDataSetable {
fileprivate func initUI() {
let tableView = UITableView()
// ...
// 高定制
self.lxf_EmptyDataSet(tableView) { () -> ([LXFEmptyDataSetAttributeKeyType : Any]) in
return [
.tipStr:"哟哟哟",
.verticalOffset:-150,
.allowScroll: false
]
}
// 默认定制
// self.lxf_EmptyDataSet(tableView)
}
}
大功告成
三、开源库
我对这个过程进行一次整理,并做成一个名为 LXFProtocolTool 的库并上传至gitHub。可以使用Cocoapods
的方式来安装使用
pod 'LXFProtocolTool'
我也将 iOS - Swift 面向协议编程(二) 中提及的通过协议便捷加载xib的功能也集成了进来。大家可以根据自己的需要在Podfile写明要安装的功能
- Xib加载
pod 'LXFProtocolTool/LXFNibloadable'
- 空白视图
pod 'LXFProtocolTool/LXFEmptyDataSetable'
创建这个库的目的是为了通过协议的方式来方便快捷地实现一些的实用功能,目前功能不多,不过往后会逐渐增加,或许你有什么想实现的功能也可以提出来,喜欢的就给个Star鼓励下我吧 ? ? ?
- mysql执行计划看是否最优
- 通过IP定位区域的SQL优化思路(r10笔记第10天)
- Java基础-day06-知识点回顾与练习
- 【Go 语言社区】Golang语言的多核并行化例子
- 一条SQL语句的执行计划变化探究(r10笔记第9天)
- 【Go 语言社区】Web 通信 之 长连接、长轮询(long polling)--转
- Dubbo入门-协议;注册中心
- Oracle 12c PDB浅析(二)(r8笔记第29天)
- 【Go 语言社区】在 Go 语言中,如何正确的使用并发
- Data Guard高级玩法:通过闪回恢复failover备库 (r10笔记第7天)
- ajax跨域问题-web开发必会
- 在线重定义的补充测试(r10笔记第26天)
- 聊聊Data Guard中的DG Broker(r10笔记第24天)
- stuts2返回json数据简单实现
- java教程
- Java快速入门
- Java 开发环境配置
- Java基本语法
- Java 对象和类
- Java 基本数据类型
- Java 变量类型
- Java 修饰符
- Java 运算符
- Java 循环结构
- Java 分支结构
- Java Number类
- Java Character类
- Java String类
- Java StringBuffer和StringBuilder类
- Java 数组
- Java 日期时间
- Java 正则表达式
- Java 方法
- Java 流(Stream)、文件(File)和IO
- Java 异常处理
- Java 继承
- Java 重写(Override)与重载(Overload)
- Java 多态
- Java 抽象类
- Java 封装
- Java 接口
- Java 包(package)
- Java 数据结构
- Java 集合框架
- Java 泛型
- Java 序列化
- Java 网络编程
- Java 发送邮件
- Java 多线程编程
- Java Applet基础
- Java 文档注释
- Fence Repair (PKU 3253)
- JAVA 初学者的编码规范一:命名风格与代码格式
- Leetcode No.11 盛最多水的容器
- OpenCV图像拼接函数vconcat()&hconcat()
- JAVA自定义注解
- [ 物联网篇 ] 28 - Linux ES7210 Driver 调试
- [ 利器篇 ] - Microsoft Surface Pro 系列安装 Ubuntu 16.04 系统
- 如何优雅的打造 All-in One 仓库
- matplotlib绘图教程:设置标签与图例
- 企业是如何从头开发一个商业项目的?
- 基于Haproxy的高可用实战
- 组复制常规操作-分布式恢复 | 全方位认识 MySQL 8.0 Group Replication
- 赞!7000 字学习笔记,MySQL 从入到放弃
- 面试官问我Volatile的原理?从操作系统层面的设计怼回去!
- 设计原则之单一职责