最近开始学习使用markdown来写博客，所以拿了一个比较简单的github项目做例子。这个例子用于在页面加载过程中出现的Loading、Error、Empty等几种情况。
整个一个项目主要是提供了一个协议#StatusProvider,用以统一解决在页面加载过程出现的 加载中、内容为空、加载错误 这几种情况的页面提示。
这几种状态统一的使用一个枚举类型来表示
public enum StatusProviderType {
case Loading
case Error(error: NSError?, retry(()-> Void)?)
case Empty(action: (()-> Void?)
case None
}
其中Loading 表示加载中，Error 表示加载出现错误，Empty表示出现空内容。retry和action作为闭包是外部传入用以相应内容具体的点击事件。
具体的使用方法 需要加载该view的页面实现协议 StatusProvider，然后才能对应的使用该协议内部的显示方法show() 和隐藏方法hide()。
有两种：默认情况以及自定义方案。
1.默认情况
show(statusType: StatusProvideType.Loading) //显示LoadingView
show(statusType: StatusProvideType.Empty(action:{...})) //显示空内容的提示
show(statusType: StatusProvideType.Error(error:error,retry:{...})) //加载错误时的提示
2.自定义情况
这种情况，三种提示view都是自己根据需求进行定制的。
自己根据产品的具体需求构造对应的view就可以了。
源码分析
整个源代码主要分为4个文件，分别是StatusProvider.swift、 EmptyStatusView.swift 、ErrorStatusView.swift 、LoadingStatusView.swift四个文件。其中3个StatusView分别是源码提供的默认页面。
StatusProvider.swift提供了最主要的协议以及相应的方法。
首先该文件定义了一个枚举类型 StatusProviderType,分别定义了不同情况下对应的类型以及view的相应tag。
协议StatusOnViewProvider作为一个最基本的协议，针对不同的情况获取需要加载的superView。
extension StatusOnViewProvider where Self : UIViewController{
public var onView: UIView {
return view
}
}
extension StatusOnViewProvider where Self: UITableViewController {
public var onView: UIView {
return view
}
}
extension StatusOnViewProvider where Self: UIView {
public var onView: UIView {
return self
}
}
其中，where起一个类型约束的作用。确保定义的关于类型参数的需求和泛型函数或类型有关联。
另外有两个协议 ,用于限定empty 和error两种情况的view。这是必须要对应实现的。
public protocol EmptyStatusDisplaying: class{
var action: (()-> Void)? { set get }
}
public protocol ErrorStatusDisplaying: class{
var error: NSError? { set get }
var retry: (() -> Void)? { set get }
}
然后statusProvider 还有一个扩展，实现了协议内的一些默认设定，在没有选择自定义view的情况下，提供默认配置。
extension StatusProvider{
public var loadingView: UIView? {
get{
#if os(tvOS)
return LoadingStatusView(loadingStyle: .Activity))
#elseif os(iOS)
return LoadingStatusView(loadingStyle: .LabelWithActivity)
#else
return nil
#endif
}
}
public var errorView: ErrorStatusDisplaying? {
get { return ErrorStatusView() }
}
public var emptyView: EmptyStatusDisplaying? {
get { return nil } } //这里下面讲
public func hide(statusType type: StatusProviderType){
remove(viewTagL type.viewTag())
}
public func remove(viewTag tag:Int){
onView.viewWithTag(tag)?.removeFromSuperview()
}
public func show(statusType type: StatusProviderType){
StatusProviderType.allViewTags().forEach({remove(viewTag: $0)})
var statusView: UIView? = nil
switch type {
case let .Error(error,retry):
statusView = errorView as? UIView
(statusView as? ErrorStatusDisplaying)?.error = error
(statusView as? ErrorStatusDisplaying)?.retry = retry
case .Loading: statusView = loadingView
case let .Empty(action):
statusView = emptyView as? UIView
(statusView as? EmptyStatusDisplaying)?.action = action
case .None: break
}
statusView?.tag = type.viewTag()
addViewAndCenterConstraints(statusView) //具体view添加 详细请看项目内容 这里就不贴了
}
这里给出了3中情况下view的默认页面。其中只有emptyView返回的是个view，需要用户在具体的页面进行设定。以下给出例子:
//具体viewController 下重新定义的emptyView。
var emptyView: EmptyStatusDisplaying?{
return EmptyStatusView(title: "No Data", caption: "No data available.💣", image: UIImage(named: "placeholder_instagram"), actionTitle: "Create ⭐️")
}
这算是一种具体的实现形式。
hide()通过调用remove()方法将具体view 消除掉
show()方法首先将在显示的所有状态view清除，然后根据类型进行重新加载。
暂时先写到这里，后续会进行补充和完善。有问题可以邮件联系我showme11211@163.com
