Swift Package Index


An empty state control to give visually appealing context when building iOS applications.


  • The latest stable release is 4.0.3. Released 8 days ago.
  • The last commit to master was 8 days ago.

Swift Version Compatibility

  • 4.0.3 and master
    5.3
    5.2
    5.1
    5.0
    4.2
Full build results

Platform Compatibility

  • 4.0.3 and master
    iOS
    macOS(Intel)
    macOS(ARM)
    Linux
    tvOS
    watchOS
Full build results

title

演示:

UICollectionView UITableView 多状态切换

预置模板视图:

静态图 动图 纯文本 富文本 复合型视图

特点:

  • 提供默认管理器来支持 UICollectionView & UITableView.
  • 可以自定义管理器来支持任何视图.
  • 空白页可以是任何形式的视图
  • 可以设置自定义的管理器来替代默认管理器
  • 可以设置自定义的管理器来全局替代默认管理器
  • 我们预置了几套模板来便捷的构建空页面.
  • 我们预置了一套带状态的管理器来应对无网络或更多情况

使用

  1. 下面是一个简单的示例, 用来将一个空白页绑定在UICollectionView上:
    let customEmptyView = CustomEmptyView()
    collectionView.ep.set(emptyView: customEmptyView)
    

    空白页将在 UICollectionView 执行 reloadData()之后, 并判断数据源为空的情况下, 正确的出现在 UICollectionView 上.

  2. 使用预置模板快速创建空白页视图:

安装

CocoaPods

  1. 全量安装

    pod 'EmptyPage'
    
  2. 按需安装

    pod 'EmptyPage/core'      # 核心库
    pod 'EmptyPage/managers'  # 拓展的管理器, 带状态的管理器就在其中
    pod 'EmptyPage/templates' # 预置的空白页模板
    

Swift Package Manager

Swift Package Manager 是一个管理 Swift 代码分发的工具。它与 Swift 构建系统集成在一起,使下载、编译和链接依赖关系的过程自动化。

使用 Xcode 11.0 + 进入你的项目文件并输入这个存储库的项目 URL:

https://github.com/linhay/EmptyPage

更多

我们准备了一个 wiki 页面,可以在那里找到很多有用的示例与用法。

  • 安装指南 - 按照它将 EmptyPage 集成到你的项目中。

  • 用法指南 - 想知道 EmptyPage 能做什么,以及在项目中使用时会是什么样子?请参阅本页获取有用的代码片段。如果您已经熟悉,您还可以学习新的技巧来改进使用 EmptyPage 的方式!

  • API 文档 - 最后,当你需要更详细的参考时,请记得阅读全文。

限制

  • iOS 9.0+
  • Swift 4.0+
  • XCode 11.0+

联系

关注我并在Twitter或者微博上联系我。如果你发现一个问题,只要创建 issues, 我们也期望你使用pull-requests来参与项目中来。

许可证

EmptyPage 是在 Apache License 2.0 许可下发布的。详细信息请参阅 LICENSE