Question 1

How do I use StatefulViewController with a UICollectionViewController?

Accepted Answer

Adopt the StatefulViewController protocol in your UICollectionViewController subclass, configure placeholder views in viewDidLoad, and call setupInitialViewState() in viewWillAppear. The protocol automatically handles state transitions for collection views, similar to table views.

Question 2

StatefulViewController vs manual state management: which is better?

Accepted Answer

StatefulViewController is better for standardizing complex state logic across multiple view controllers, reducing boilerplate. Manual management might be preferable for very simple apps or when you need fine-grained control over every state transition without protocol overhead.

Question 3

How to customize the insets for placeholder views?

Accepted Answer

Make your placeholder view conform to the StatefulPlaceholderView protocol and implement the placeholderViewInsets() method to return custom UIEdgeInsets. This allows for non-fullscreen layouts, as described in the README's custom placeholder section.

Question 4

Does StatefulViewController work with SwiftUI?

Accepted Answer

No, StatefulViewController is designed for UIKit and does not integrate directly with SwiftUI. For SwiftUI projects, consider using native @State properties or third-party libraries built for declarative UI frameworks.

Question 5

How to handle network errors when content is already loaded?

Accepted Answer

Implement the handleErrorWhenContentAvailable method in your view controller to present custom alerts or messages. StatefulViewController calls this method instead of showing the error view when content is available, as explained in the error handling flexibility section.

Question 6

Can I use StatefulViewController with custom state flows?

Accepted Answer

Yes, the underlying ViewStateMachine is exposed for custom state flows. You can define additional states and transitions beyond the default loading, content, empty, and error states, though this requires extra implementation effort.

StatefulViewController

What is StatefulViewController?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions