swift - 空白页快速集成(tableView/CollectionView)

近期在整理过去一年代码,顺便安利分享一些小轮子.

EmptyPage - Github

一个UITableView / UICollectionView扩展，用于在视图没有内容显示的时候显示空白页.

示例

empty1.gif

默认提供了三套样式(纯文字/纯图片/标准)

三套样式.png

安装

• 使用cocoapods安装

# 如果采用自定义样式,只需要引入 Core
pod 'EmptyPage/Core'
# 如果预设样式能够满足需求, 可以使用一下形式引入
pod 'EmptyPage'
pod 'EmptyPage/Standard'
# 后期加入的通用样式将以扩展的形式加入到以下仓库中
pod 'EmptyPage/Spec'

使用

• 由于swift 4.0 取消了 'initialize' 函数,所以需要在合适的时机执行以下函数才可以正常工作:

EmptyPage.begin()

• 只引入 'EmptyPage/Core':

  适合构建有丰富特性的自定义样式.

// 需要自定义空白页样式
let emptyView = EmptyView()
// 直接给emptyView属性赋值,会在reloadData的时候判断是否需要显示
collectionView.emptyView = emptyView
// 调用reloadData/delete/insert才会判断是否需要显示
collectionView.reloadData()

• 引入 pod 'EmptyPage/Standard':

默认提供了3套默认样式,纯文本样式/纯图片样式/标准样式(图片+标题+描述+按钮形式)

• 并提供了丰富的设置函数.

• 并且大部分属性都是能直接访问修改.方便个人定制.
• 使用EmptyPageView接口实现:

// 图片(支持单张与多张) + 标题 + 描述 + 一个按钮 的样式
let emptyView: EmptyPageView = .standard(images: [UIImage(named: "empty")!],
                  title: "标题",
                  text: "描述文本",
                  btnTitle: "按钮标题") {
                  print("按钮事件")
  }
  
// 设置
tableView.setEmpty(view: emptyView) // 等价于 tableView.emptyView = emptyView

• 自定义默认样式

// 获取标准样式
let view = EmptyPageView.ContentView.standard
// 自定义配置标准样式
view.configImageView(images: [UIImage(named: "empty-1002")!])
view.titleLabel.text = "Connection failure"
view.button.setTitle("TRY AGAIN", for: .normal)
// 将标准样式条添加至背景View上(提供了约束设置的功能)
let emptyView: EmptyPageView = .mix(view: view)
// 设置
tableView.setEmpty(view: emptyView) // 等价于 tableView.emptyView = emptyView

• 引入pod 'EmptyPage'或者 pod 'EmptyPage/Spec':

  目前是空的,会在后期加入一些更加通用的样式,提高开发效率.