RomainBoulay / UICollectionViewEmptyState

Set-and-forget overlays for empty UICollectionViews.

#UICollectionViewEmptyState

Want to display an arbitrary UIView on your UICollectionView when in an empty state, and in a loosely-coupled fashion? Look no further.

##What's new

• 1.0.8

  • Updated depedencies for changes in libextobjc.

• 1.0.7

  • Fixed missing QuartzCore import.

• 1.0.6

  • Checks the animation keys for the emptyState_view explicitly so should protect against multiple nested add/remove operations and generally smoother operation.

• 1.0.5

  • Added emptyState_showDelay and emptyState_hideDelay properties to add a delay to show/hide of the overlay.
  • Possibly fixed a retain cycle-related crash issue.
  • Test target currently broken and no time to fix... :(

• 1.0.3

  • Dependency updates.

• 1.0.2

  • Fixed dependency error.

• 1.0.1

  • Tidying of methods.
  • Existing empty views are always removed when a new view is set. Allows for more dynamic changing of empty state views.

• 1.0.0

  • Added UICollectionViewEmptyStateDelegate protocol.
  • Added setEmptyStateImageViewWithImage:.

• 0.0.1 - Initial release

##Usage

#import "UICollectionViewEmptyState.h" and simply set the property emptyState_view on your UICollectionView instance. We do the rest. Note that your view will be resized to overlay the UICollectionView so be sure to properly configure beforehand.

##Category properties

• *@property (nonatomic, strong) UIView emptyState_view; set your overlay view.
• @property (nonatomic, assign) BOOL emptyState_shouldRespectSectionHeader; when used with UICollectionViewFlowLayout, setting this property to YES causes the overlay to be laid-out beneath the first section's header view. This would be useful if your first section's header contains controls that affect the collection's content in some way. We don't want to block those.
• @property (nonatomic, assign) NSTimeInterval emptyState_showAnimationDuration;, @property (nonatomic, assign) NSTimeInterval emptyState_hideAnimationDuration; the overlay can be faded in and out using these properties. Set either to 0 for no animation.
• UICollectionViewEmptyStateDelegate protocol can be used for further customisation of the view as it's added and removed.
• A convenience method setEmptyStateImageViewWithImage: creates a UIImageView with the provided image, sets it as emptyState_view, and returns it for any further customisation required.

##Notes

UICollectionView is a complex beast, and there are quite likely to be edge cases I haven't considered here. If you find a gremlin, please let me know!

Have fun!

[e-mail]