liam-i / blankslate

A drop-in UIView extension for showing empty datasets whenever the view has no content to display.

BlankSlate

BlankSlate is a drop-in UIView extension for showing empty datasets whenever the view has no content to display.

ScreenShots

Requirements

• iOS 12.0+
• tvOS 12.0+
• Xcode 14.1+
• Swift 5.7.1+

Installation

Swift Package Manager

...using swift build

If you are using the Swift Package Manager, add a dependency to your Package.swift file and import the BlankSlate library into the desired targets:

dependencies: [
    .package(url: "https://github.com/liam-i/BlankSlate.git", from: "0.7.1")
],
targets: [
    .target(
        name: "MyTarget", dependencies: [
            .product(name: "BlankSlate", package: "BlankSlate")
        ])
]

...using Xcode

If you are using Xcode, then you should:

• File > Swift Packages > Add Package Dependency
• Add https://github.com/liam-i/BlankSlate.git
• Select "Up to Next Minor" with "0.7.1"

Tip

For detailed tutorials, see: Apple Docs

CocoaPods

If you're using CocoaPods, add this to your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
# Or use CND source
# source 'https://cdn.cocoapods.org/'
platform :ios, '12.0'
use_frameworks!

target 'MyApp' do
  pod 'BlankSlate', '~> 0.7.1'
end

And run pod install.

Important

CocoaPods 1.13.0 or newer is required.

Carthage

If you're using Carthage, add this to your Cartfile:

github "liam-i/BlankSlate" ~> 0.7.1

And run carthage update --platform iOS --use-xcframeworks.

Example

To run the example project, first clone the repo, then cd to the root directory and run pod install. Then open BlankSlate.xcworkspace in Xcode.

Credits and thanks

• Thanks a lot to Ignacio Romero Zurbuchen for building DZNEmptyDataSet - all ideas in here and many implementation details were provided by his library.

License

BlankSlate is available under the MIT license. See the LICENSE file for more info.