Latest 1.2.9.2
Homepage https://github.com/linhay/EmptyPage
License MIT
Platforms ios 8.0, requires ARC
Authors

title

Swift 4.0 Platform: iOS iOS 8

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

Features

  • [x] 支持UICollectionView & UITableView

  • [ ] 支持WKWebview & UIWebview

  • [ ] 支持UIScrollView

  • [ ] 支持更多实用与设计感的样式

demo demo

默认样式(纯文字/纯图片/标准)

demo1demo2demo3

Requirements

  • Swift 4
  • iOS 8+

安装

  • 使用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':

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

Author

linhey: [email protected]

License

EmptyPage is available under the Apache License. See the LICENSE file for more info.

Latest podspec

{
    "name": "EmptyPage",
    "version": "1.2.9.2",
    "summary": "iOS - u8f7bu91cfu7ea7u7a7au767du9875u5360u4f4du56feu6846u67b6...",
    "homepage": "https://github.com/linhay/EmptyPage",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "linhey": "[email protected]"
    },
    "source": {
        "git": "https://github.com/linhay/EmptyPage.git",
        "tag": "1.2.9.2"
    },
    "platforms": {
        "ios": "8.0"
    },
    "requires_arc": true,
    "pod_target_xcconfig": {
        "SWIFT_VERSION": "4.0"
    },
    "subspecs": [
        {
            "name": "Core",
            "source_files": "Sources/*.{swift,h}"
        },
        {
            "name": "Standard",
            "source_files": "Standard/*.{swift,xib}",
            "dependencies": {
                "EmptyPage/Core": []
            }
        }
    ]
}

Pin It on Pinterest

Share This