最近开始学习使用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