Skip to content
Allows displaying UIViews inside the Xcode preview canvas
Swift
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Example
.gitignore
LICENSE
README.md
UIViewPreviewProvider.swift

README.md

UIViewPreviewProvider

This is a helper class for displaying UIViews inside the Xcode preview canvas meant to display SwiftUI.
It allows you to quickly iterate on your UIViews without having to rebuild your entire app.
This is especially useful if your project needs to supports iOS < 13 and you can't start using SwiftUI just yet.

Adding UIViewPreviewProvider to your project.

Just copy UIViewPreviewProvider.swift into your project. I don't think this is large enough to warrant adding a whole library to your project.

Rendering UIView previews in your project

In the file where your view is defined:

// This if check is important if you're working with a project that supports iOS < 13
// If you're working with an iOS 13+ project then you can omit the canImport(SwiftUI) check
#if canImport(SwiftUI) && DEBUG

import SwiftUI

@available(iOS 13.0, *)
struct MyView_Preview: PreviewProvider, UIViewPreviewProvider {
    
    // Provide previews of your UIView
    static let uiPreviews: [Preview] = {

        // Create your views and populate them with some dummy data
        
        let view1 = MyView()
        view1.someProperty = "foo"
        let view1Preview = Preview(view1, displayName: "View 1")

        let view2 = MyView()
        view2.someProperty = "bar"
        let view2Preview = Preview(view2, displayName: "View 2")

        return [view1Preview, view2Preview]
    }()
}

#endif

Open up the preview Xcode canvas by pressing (⌥ + ⌘ + return) and your previews should show up.

You may need to hit the Resume button for them to show up

It should look something like this: screenshot

Examples

See Example.swift for more info.

If you're using MVVM see MVVM Example.swift to see how you can generate previews directly from your ViewModels.

You can’t perform that action at this time.