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
方法就可以實現資料空白頁了。但是,這樣直接寫死的方式很不好,有時候一些場景是需要我們做出定製的,那怎麼實現定製呢?協議又不能有自己的變數來存放我們的定製。
這裡先做出一個限定,我們要使用過載方法來完成該功能,實現即可高定製,又可使用預設定製。
回到剛剛的話題,使用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鼓勵下我吧