craftyBlankState 1.0.1

craftyBlankState 1.0.1

×

由 CraftyCoders.io 维护。

craftyBlankState 1.0.1

  • by
  • craftycoders

craftyBlankState

CI Status Version License Platform

CraftyBlankState 允许您优雅地处理 iOS 应用的空白界面。即使是您昨天才完成 iOS 开发 101 的入门学习，您的 iOS 应用也会看起来非常专业。内置默认项，全面自定义以处理不同情况。完全自适应所有设备和屏幕尺寸。

示例

要运行示例项目，请克隆仓库，然后首先在示例目录中运行 pod install。

要求

  • iOS 12.0
  • Swift 5.0

安装

craftyBlankState 可通过 CocoaPods 获取。要安装它，只需将以下行添加到您的 Podfile 中

pod 'craftyBlankState'

实现

步骤1：将 craftyBlankState 导入到您的viewController或view中。

import craftyBlankState

步骤2：遵循 CraftyBlankStateable 协议。这将要求您定义它应用来显示空白状态的视图。

class ViewController: UIViewController, CraftyBlankStateable {
    var blankStateView: CraftyBlankStateView! = CraftyBlankStateView()

}

或

class View: UIView, CraftyBlankStateable {
    var blankStateView: CraftyBlankStateView! = CraftyBlankStateView()
}

步骤3：将您的视图标记为数据源并调用刷新。就这样！如果数据源没有定义，它将使用默认图片和消息

override func viewDidLoad() {
    super.viewDidLoad()
    self.view = blankStateView
    blankStateView.dataSource = self
    blankStateView.refresh()
}

extension ViewController: CraftyBlankStateDataSource {
    //dataSource methods will be automatically defined here
    //an enum and switch statement can be used if multiple blank state cases exist
    func image(in blankStateView: CraftyBlankStateView) -> UIImage? {
        return MyBlankStateImage
    }
    
    func message(in blankStateView: CraftyBlankStateView) -> String {
        return MyBlankStateMessage
    }
    
    func font(in blankStateView: CraftyBlankStateView) -> UIFont {
        return MyDesiredFont
    }
}

功能请求

我们一直重视始终向用户提供正确信息的重要性。我们设计了尽可能灵活的框架，同时不使您的代码看起来像您妈妈的意大利面。如果您想要在未来的版本中看到的功能，请提交一个issue，并在其中标注为功能请求。

贡献者

好吧，只需将它分支出来。提交一个PR，描述它做什么以及我们应该如何测试它。

许可证

craftyBlankState 在MIT许可证下可用。有关更多信息，请参阅LICENSE文件。