Latest 0.3.3
License Apache License, Version 2.0
Platforms ios 6.0, requires ARC
Frameworks UIKit

Pod Version
Pod Platform
Pod License
Dependency Status


CNPPopupController is a simple and versatile class for presenting a custom popup in a variety of fashions. It includes a many options for controlling how your popup appears and behaves.

Please feel free to contribute to this project, open issues, make suggestions and submit pull-requests. If you use this project in your app, let me know. I’d love to see what you do with it.


Available in CocoaPods

pod 'CNPPopupController'


(See sample Xcode project in /CNPPopupControllerExample)

Creating a Popup

Create a popup with custom animations and behaviors. Customizations can also be accessed via properties on the CNPPopupTheme instance:

- (instancetype)initWithContents:(NSArray *)contents;

contents only accepts an array of UIView objects.


- (void)presentPopupControllerAnimated:(BOOL)flag;

- (void)dismissPopupControllerAnimated:(BOOL)flag;


A CNPPopupTheme instance can be created and assigned to the theme property of a CNPPopupController instance.

@property (nonatomic, strong) UIColor *backgroundColor;

@property (nonatomic, assign) CGFloat cornerRadius;

@property (nonatomic, assign) UIEdgeInsets popupContentInsets;

@property (nonatomic, assign) CNPPopupStyle popupStyle;

@property (nonatomic, assign) CNPPopupPresentationStyle presentationStyle;

@property (nonatomic, assign) CNPPopupMaskType maskType;

@property (nonatomic, assign) BOOL dismissesOppositeDirection;

@property (nonatomic, assign) BOOL shouldDismissOnBackgroundTouch;

@property (nonatomic, assign) BOOL movesAboveKeyboard;

@property (nonatomic, assign) CGFloat contentVerticalPadding;

@property (nonatomic, assign) CGFloat maxPopupWidth;

@property (nonatomic, assign) CGFloat animationDuration;



CNPPopupController works on iOS 6 – iOS 10


CNPPopupController was created by Carson Perrotti

Version History

September 15, 2016 v0.3.3

  • Content layout fixes
  • Better swift support

July 14, 2016 v0.3.2

  • Fixes an issue where content would not be perfectly centred.
  • Project compatibility fixes to prevent duplicate symbols errors.
  • Added property to adjust animation transition duration.

September 13, 2015 v0.3.1

  • Sets movesAboveKeyboard to YES in the default theme.

September 11, 2015 v0.3.0

  • Support for iOS 9 and a few bug fixes.

August 30, 2015 v0.2.3

  • Lower minimum required OS version to 6.0, since it works there anyway.

August 16, 2015 v0.2.2

  • Bug fix for centering the popup above the keyboard when presented. Thanks to Nicholas for the proactive help on this one.

June 14th, 2015 v0.2.0

  • Completely rewritten. Started from the bottom, now we’re here.
  • There are some minor API changes in v0.2.0. I tried to keep it as close to the last version as possible. See the example project if you need some help getting it set up.
  • Custom view support (You can add anything, as it’s contents as long as it is a UIView or subclass of UIView
  • Lots of bug fixes

Latest podspec

    "name": "CNPPopupController",
    "version": "0.3.3",
    "summary": "A versatile popup for iOS",
    "description": "CNPPopupController is a simple and versatile class for presenting a custom popup in a variety of fashions.nIt includes a many options for controlling how your popup appears and behaves.nn* Think: Why did you write this? What is the focus? What does it do?n* CocoaPods will be using this to generate tags, and improve search results.n* Try to keep it short, snappy and to the point.n* Finally, don't worry about the indent, CocoaPods strips it!",
    "homepage": "",
    "screenshots": "",
    "license": {
        "type": "Apache License, Version 2.0",
        "file": "LICENSE"
    "authors": "Carson Perrotti",
    "social_media_url": "",
    "platforms": {
        "ios": "6.0"
    "source": {
        "git": "",
        "tag": "0.3.3"
    "source_files": [
    "frameworks": "UIKit",
    "requires_arc": true

Pin It on Pinterest

Share This